* This file is part of the Symfony package.
* (c) Fabien Potencier <fabien@symfony.com>
* For the full copyright and license information, please view the LICENSE
* file that was distributed with this source code.
namespace Symfony\Component\Process;
use Symfony\Component\Process\Exception\RuntimeException;
* Provides a way to continuously write to the input of a Process until the InputStream is closed.
* @author Nicolas Grekas <p@tchwork.com>
class InputStream implements \IteratorAggregate
/** @var callable|null */
* Sets a callback that is called when the write buffer becomes empty.
public function onEmpty(callable $onEmpty = null)
$this->onEmpty = $onEmpty;
* Appends an input to the write buffer.
* @param resource|string|int|float|bool|\Traversable|null $input The input to append as scalar,
* stream resource or \Traversable
public function write($input)
throw new RuntimeException(sprintf('"%s" is closed.', static::class));
$this->input[] = ProcessUtils::validateInput(__METHOD__, $input);
* Closes the write buffer.
* Tells whether the write buffer is closed or not.
public function isClosed()
public function getIterator()
while ($this->open || $this->input) {
$current = array_shift($this->input);
if ($current instanceof \Iterator) {
foreach ($current as $cur) {
if (!$this->input && $this->open && null !== $onEmpty = $this->onEmpty) {
$this->write($onEmpty($this));