pcntl_exec
PHP Manual
PHP Manual»Функції PCNTL»pcntl_exec

pcntl_exec

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

pcntl_exec — Executes specified program in current process space

Опис

function 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.

Журнал змін

Версія Опис
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.

Прогляньте також

  • pcntl_fork() - Forks the currently running process
  • pcntl_waitpid() - Waits on or returns the status of a forked child
  • exec() - Execute an external program
  • proc_open() - Execute a command and open file pointers for input/output
To Top