passthru

FunctionReturn type changed in PHP 8.2

Execute an external program and display raw output.

PHP 5
PHP 7
PHP 8.0
Improved
PHP 8.1
PHP 8.2
Improved
PHP 8.3
PHP 8.4
PHP 8.5
PHP 8.6

passthru Function synopsis

passthru(string $command, &$result_code = null): ?false

Parameters

$command

Typestring

The command that will be executed.

$result_code

Passed by reference, OptionalDefault valuenull

If the $result_code argument is present, the return status of the Unix command will be placed here.

Note that the parameter $result_code is passed by reference, and contains additional/updated context data that may be useful.

Return value

Type?false

Returns null on success or false on failure

Changes to the passthru Function

PHP 8.2

  • Return type changed: ?bool to ?false
- passthru(string $command, &$result_code = null): ?bool
+ passthru(string $command, &$result_code = null): ?false

PHP 8.0

  • Return type added: ?bool
  • Parameter type added for parameter #1 ($command): string
  • Parameter name of parameter #2 changed: $return_value to $result_code
  • Parameter default value added for position #2 ($result_code): null
- passthru($command, &$return_value)
+ passthru(string $command, &$result_code = null): ?bool

passthru Function Availability

PHP VersionAvailability
PHP 8.6Upcoming Release Yes
PHP 8.5Supported (Latest) Yes
PHP 8.4Supported Yes
PHP 8.3Security-Fixes Only Yes
PHP 8.2Security-Fixes Only Yes
PHP 8.1Unsupported Yes
PHP 8.0Unsupported Yes
PHP 7.4Unsupported Yes
PHP 7.3Unsupported Yes
PHP 7.2Unsupported Yes
PHP 7.1Unsupported Yes
PHP 7.0Unsupported Yes
PHP 5.6Unsupported Yes
PHP 5.5Unsupported Yes
PHP 5.4Unsupported Yes
PHP 5.3Unsupported Yes