array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.pcntl-exec.php', 1 => 'pcntl_exec', 2 => 'Exécute le programme indiqué dans l\'espace courant de processus', ), 'up' => array ( 0 => 'ref.pcntl.php', 1 => 'Fonctions PCNTL', ), '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' => 'fr', '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 — Exécute le programme indiqué dans l'espace courant de processus

Description

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

Exécute le programme indiqué dans l'espace courant de processus.

Liste de paramètres

path

path doit être le chemin vers un binaire exécutable ou un script avec un chemin valide pointant vers un exécutable à la première ligne (par exemple, #!/usr/local/bin/perl). Voir les pages d'aide du système concernant execve(2) pour plus d'informations.

args

args est un tableau d'arguments sous la forme de chaînes de caractères passées au programme.

env_vars

env_vars est un tableau de chaînes de caractères qui sont passées au programme comme variables d'environnement. Le tableau est de la forme nom => valeur, la clé est le nom de la variable d'environnement et la valeur est la valeur de cette variable.

Valeurs de retour

Retourne false en cas d'échec. En cas de succès, la fonction ne retourne pas, car l'image du processus courant est remplacée par le programme exécuté.

Erreurs / Exceptions

À partir de PHP 8.5.0, une ValueError est levée si une entrée de args contient un octet nul, ou si une entrée ou une clé de env_vars contient un octet nul.

Historique

Version Description
8.5.0 Une ValueError est désormais levée si une entrée de args contient un octet nul, ou si une entrée ou une clé de env_vars contient un octet nul.

Voir aussi