pcntl_exec
PHP Manual
PHP Manual»PCNTL Funzioni»pcntl_exec

pcntl_exec

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

pcntl_exec — Executes specified program in current process space

Descrizione

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

Executes the program with the given arguments.

Elenco dei parametri

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.

Valori restituiti

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

Errori/Eccezioni

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.

Log delle modifiche

Versione Descrizione
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.

Vedere anche:

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