Home/ Manual/ pcntl / functions/ pcntl_exec

pcntl_exec

PHP function Edit on GitHub ✎

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

Executes specified program in current process space

Description

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

Executes the program with the given arguments.

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.

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

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.

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.