array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'en', ), 'this' => array ( 0 => 'function.pcntl-exec.php', 1 => 'pcntl_exec', 2 => 'Executes specified program in current process space', ), 'up' => array ( 0 => 'ref.pcntl.php', 1 => 'PCNTL Functions', ), 'prev' => array ( 0 => 'function.pcntl-errno.php', 1 => 'pcntl_errno', ), 'next' => array ( 0 => 'function.pcntl-fork.php', 1 => 'pcntl_fork', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'en', 'path' => 'reference/pcntl/functions/pcntl-exec.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

pcntl_exec

(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

pcntl_exec — Executes specified program in current process space

Description

function pcntl_exec(string $path, array $args = [], array $env_vars = []): false

Executes the program with the given arguments.

Parameters

path

path must be the path to a binary executable or a script with a valid path pointing to an executable in the shebang ( #!/usr/local/bin/perl for example) as the first line. See your system's man execve(2) page for additional information.

args

args is an array of argument strings passed to the program.

env_vars

env_vars is an array of strings which are passed as environment to the program. The array is in the format of name => value, the key being the name of the environmental variable and the value being the value of that variable.

Return Values

Returns false on failure. On success the function does not return, because the current process image is replaced by the executed program.

Errors/Exceptions

As of PHP 8.5.0, a ValueError is thrown if any entry of args contains a null byte, or if any entry or key of env_vars contains a null byte.

Changelog

Version Description
8.5.0 A ValueError is now thrown if any entry of args contains a null byte, or if any entry or key of env_vars contains a null byte.

See Also