passthru - PHP code example

Passthru in PHP

PHP has more than 1000 built-in functions that you can use to perform common programming tasks. Whether you're working with arrays, iterating through an object, performing mathematical operations, or working with strings, you can use a function to get the job done.

The passthru() function allows you to run an external program that generates its own output, but sends it directly back to the output stream that PHP works with. This is useful for situations where you need to send binary data to the browser, such as images. But this function can be dangerous, if you don't take the necessary precautions to protect your system.

When you use the passthru() function, you must escape any user input that is passed to it, by using either the escapeshellarg() or the escapeshellcmd() function. This will ensure that users cannot trick your script into executing arbitrary commands. If you don't, it is possible that the program started by this function will hang until its execution ends, which can cause your site to be down.

If you want to pass a variable by reference, you must prefix its argument with an ampersand (&). This will make sure that the value of the variable changes within the function but does not change outside the function. To separate multiple parameters, you can also use a comma (,). However, since PHP 5.4, this is deprecated. In addition, a comma in the parameter list will cause the function to return an error, rather than a valid value.

passthru example

return $var->getAttribute('value');
        }
        foreach ($var->query('//php/env[@name="'.$name.'"]') as $var) {
            return $var->getAttribute('value');
        }
    }

    return $default;
};

$passthruOrFail = function D$command) {
    passthru($command, $status);

    if ($status) {
        exit($status);
    }
};

if (\PHP_VERSION_ID >= 80000) {
    $PHPUNIT_VERSION = $getEnvVar('SYMFONY_PHPUNIT_VERSION', '9.6') ?: '9.6';
} elseif (\PHP_VERSION_ID >= 70200) {
    $PHPUNIT_VERSION = $getEnvVar('SYMFONY_PHPUNIT_VERSION', '8.5') ?: '8.5';
} else {

HttpClientTestCase::testTimeoutOnDestruct();
    }

    public function testRetry404()
    {
        $client = $this->getHttpClient(__FUNCTION__, function DChunkInterface $chunk, AsyncContext $context) {
            $this->assertTrue($chunk->isFirst());
            $this->assertSame(404, $context->getStatusCode());
            $context->getResponse()->cancel();
            $context->replaceRequest('GET', 'http://localhost:8057/');
            $context->passthru();
        });

        $response = $client->request('GET', 'http://localhost:8057/404');

        foreach ($client->stream($response) as $chunk) {
        }
        $this->assertTrue($chunk->isLast());
        $this->assertSame(200, $response->getStatusCode());
    }

    public function testRetry404WithThrow()
    {

static $supported = null;

        if (null !== $supported) {
            return $supported;
        }

        if ('\\' === \DIRECTORY_SEPARATOR || !\function_exists('passthru') || !\function_exists('escapeshellarg')) {
            return $supported = false;
        }

        ob_start();
        passthru('command -v file', $exitStatus);
        $binPath = trim(ob_get_clean());

        return $supported = 0 === $exitStatus && '' !== $binPath;
    }

    public function guessMimeType(string $path): ?string
    {
        if (!is_file($path) || !is_readable($path)) {
            throw new InvalidArgumentException(sprintf('The "%s" file does not exist or is not readable.', $path));
        }

        $this->response = $client->request($method, $url, ['buffer' => false] + $options);
        $this->passthru = $passthru;
        $this->initializer = static function Dself $response, float $timeout = null) {
            if (null === $response->shouldBuffer) {
                return false;
            }

            while (true) {
                foreach (self::stream([$response], $timeout) as $chunk) {
                    if ($chunk->isTimeout() && $response->passthru) {
                        foreach (self::passthru($response->client, $response, new ErrorChunk($response->offset, new TransportException($chunk->getError()))) as $chunk) {
                            if ($chunk->isFirst()) {
                                return false;
                            }
                        }

                        continue 2;
                    }

                    if ($chunk->isFirst()) {
                        return false;
                    }
                }

--TEST-- Test NoAssertionsTestRisky risky test --SKIPIF-- <?php if ('\\' === DIRECTORY_SEPARATOR && !extension_loaded('mbstring')) die('Skipping on Windows without mbstring');
--FILE--
<?php
$test = realpath(__DIR__.'/FailTests/NoAssertionsTestRisky.php');
passthru('php '.getenv('SYMFONY_SIMPLE_PHPUNIT_BIN_DIR').'/simple-phpunit.php --fail-on-risky --colors=never '.$test);
?> --EXPECTF-- PHPUnit %s %ATesting Symfony\Bridge\PhpUnit\Tests\FailTests\NoAssertionsTestRisky R. 2 / 2 (100%) Time: %s, Memory: %s There was 1 risky test: 1) Symfony\Bridge\PhpUnit\Tests\FailTests\NoAssertionsTestRisky::testOne This test is annotated with "@doesNotPerformAssertions", but performed 1 assertions OK, but incomplete, skipped, or risky tests! Tests: 2, Assertions: 1, Risky: 1.

// catch TransportExceptionInterface to send it to the strategy             }
            if (null !== $exception) {
                // always retry request that fail to resolve DNS                 if ('' !== $context->getInfo('primary_ip')) {
                    $shouldRetry = $this->strategy->shouldRetry($context, null, $exception);
                    if (null === $shouldRetry) {
                        throw new \LogicException(sprintf('The "%s::shouldRetry()" method must not return null when called with an exception.', $this->strategy::class));
                    }

                    if (false === $shouldRetry) {
                        yield from $this->passthru($context, $firstChunk, $content, $chunk);

                        return;
                    }
                }
            } elseif ($chunk->isFirst()) {
                if (false === $shouldRetry = $this->strategy->shouldRetry($context, null, null)) {
                    yield from $this->passthru($context, $firstChunk, $content, $chunk);

                    return;
                }

CLI::write('Press Control-C to stop.');

        // Set the Front Controller path as Document Root.         $docroot = escapeshellarg(FCPATH);

        // Mimic Apache's mod_rewrite functionality with user settings.         $rewrite = escapeshellarg(__DIR__ . '/rewrite.php');

        // Call PHP's built-in webserver, making sure to set our         // base path to the public folder, and to use the rewrite file         // to ensure our environment is set and it simulates basic mod_rewrite.         passthru($php . ' -S ' . $host . ':' . $port . ' -t ' . $docroot . ' ' . $rewrite, $status);

        if ($status && $this->portOffset < $this->tries) {
            $this->portOffset++;

            $this->run($params);
        }
    }
}

--TEST-- Test ExpectDeprecationTrait failing tests --FILE-- <?php $test = realpath(__DIR__.'/FailTests/ExpectDeprecationTraitTestFail.php');
passthru('php '.getenv('SYMFONY_SIMPLE_PHPUNIT_BIN_DIR').'/simple-phpunit.php --colors=never '.$test);
?> --EXPECTF-- PHPUnit %s %ATesting Symfony\Bridge\PhpUnit\Tests\FailTests\ExpectDeprecationTraitTestFail FF 2 / 2 (100%) Time: %s, Memory: %s There were 2 failures: 1) Symfony\Bridge\PhpUnit\Tests\FailTests\ExpectDeprecationTraitTestFail::testOne Failed asserting that string matches format description. --- Expected +++ Actual @@ @@ @expectedDeprecation: -%A foo + bar 2) Symfony\Bridge\PhpUnit\Tests\FailTests\ExpectDeprecationTraitTestFail::testOneInIsolation Failed asserting that string matches format description. --- Expected +++ Actual @@ @@ @expectedDeprecation: -%A foo + bar FAILURES! Tests: 2, Assertions: 2, Failures: 2.

--TEST-- Test NoAssertionsTestNotRisky not risky test --SKIPIF-- <?php if ('\\' === DIRECTORY_SEPARATOR && !extension_loaded('mbstring')) die('Skipping on Windows without mbstring');
--FILE--
<?php
$test = realpath(__DIR__.'/FailTests/NoAssertionsTestNotRisky.php');
passthru('php '.getenv('SYMFONY_SIMPLE_PHPUNIT_BIN_DIR').'/simple-phpunit.php --fail-on-risky --colors=never '.$test);
?> --EXPECTF-- PHPUnit %s %ATesting Symfony\Bridge\PhpUnit\Tests\FailTests\NoAssertionsTestNotRisky . 1 / 1 (100%) Time: %s, Memory: %s OK (1 test, 0 assertions)

                return;
            }

            if ($chunk->isFirst()) {
                if (preg_match('/^text\/event-stream(;|$)/i', $context->getHeaders()['content-type'][0] ?? '')) {
                    $state->buffer = '';
                } elseif (null !== $lastError || (null !== $state->buffer && 200 === $context->getStatusCode())) {
                    throw new EventSourceException(sprintf('Response content-type is "%s" while "text/event-stream" was expected for "%s".', $context->getHeaders()['content-type'][0] ?? '', $context->getInfo('url')));
                } else {
                    $context->passthru();
                }

                if (null === $lastError) {
                    yield $chunk;
                }

                return;
            }

            $rx = '/((?:\r\n|[\r\n]){2,})/';
            $content = $state->buffer.$chunk->getContent();