Gecko [ v3.cesa.co.za ]

Name	Size	Permission	Date
Exception	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Messenger	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
Pipes	[ DIR ]	drwxrwxr-x	2026-08-17 03:12
.htaccess	237 B	-r-xr-xr-x	2026-08-17 03:12
CHANGELOG.md	4.13 KB	-rwxrwxr-x	2026-01-23 16:02
ExecutableFinder.php	3.44 KB	-rwxrwxr-x	2026-01-23 16:02
InputStream.php	2.41 KB	-rwxrwxr-x	2026-01-23 16:02
LICENSE	1.04 KB	-rwxrwxr-x	2026-01-23 16:02
PhpExecutableFinder.php	2.26 KB	-rwxrwxr-x	2026-01-23 16:02
PhpProcess.php	2.39 KB	-rwxrwxr-x	2026-01-23 16:02
PhpSubprocess.php	5.92 KB	-rwxrwxr-x	2026-01-23 16:02
Process.php	51.35 KB	-rwxrwxr-x	2026-01-23 16:02
ProcessUtils.php	1.71 KB	-rwxrwxr-x	2026-01-23 16:02
README.md	472 B	-rwxrwxr-x	2026-01-23 16:02
composer.json	671 B	-rwxrwxr-x	2026-01-23 16:02

Rename

<?php

/*
 * 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>
 *
 * @implements \IteratorAggregate<int, string>
 */
class InputStream implements \IteratorAggregate
{
    private ?\Closure $onEmpty = null;
    private array $input = [];
    private bool $open = true;

/**
     * Sets a callback that is called when the write buffer becomes empty.
     *
     * @return void
     */
    public function onEmpty(?callable $onEmpty = null)
    {
        $this->onEmpty = null !== $onEmpty ? $onEmpty(...) : null;
    }

/**
     * 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
     *
     * @return void
     */
    public function write(mixed $input)
    {
        if (null === $input) {
            return;
        }
        if ($this->isClosed()) {
            throw new RuntimeException(\sprintf('"%s" is closed.', static::class));
        }
        $this->input[] = ProcessUtils::validateInput(__METHOD__, $input);
    }

/**
     * Closes the write buffer.
     *
     * @return void
     */
    public function close()
    {
        $this->open = false;
    }

/**
     * Tells whether the write buffer is closed or not.
     *
     * @return bool
     */
    public function isClosed()
    {
        return !$this->open;
    }

public function getIterator(): \Traversable
    {
        $this->open = true;

while ($this->open || $this->input) {
            if (!$this->input) {
                yield '';
                continue;
            }
            $current = array_shift($this->input);

if ($current instanceof \Iterator) {
                yield from $current;
            } else {
                yield $current;
            }
            if (!$this->input && $this->open && null !== $onEmpty = $this->onEmpty) {
                $this->write($onEmpty($this));
            }
        }
    }
}