7.84 Exécution de programmes externes
7 Index des fonctions
Manuel PHP
. Introduction . Pré-requis . Installation . Configuration à l'exécution . Types de ressources . Constantes prédefinies . Voir aussi . escapeshellarg . escapeshellcmd . exec . passthru . proc_close . proc_get_status . proc_nice ->proc_open . proc_terminate . shell_exec . system
|
7.84.15 proc_open()
Exécute une commande et ouvre les pointeurs de fichiers pour les entrées sorties
[ Exemples avec proc_open ] PHP 4 >= 4.3.0
resource
proc_open (
string
cmd
,
array
descriptorspec
,
array
pipes
)
proc_open
est similaire à
popen
mais fournie un plus grand degré de contrôle sur l'exécution du programme.
cmd
est la commande qui doit être exécutée par le shell.
descriptorspec
est un tableau indexé, dont les clés
représentent le numéro de descripteur, et la valeur représente la méthode
avec laquelle
PHP
va passer ce descripteur au processus fils.
pipes
recevra un tableau indexé de pointeurs de
fichiers, qui correspondent aux sorties dans
PHP
de tous les pipes
qui sont créés. La valeur retournée est une ressource, qui représente le
processus. Il faudra la détuire avec la fonction
proc_close
lorsque vous aurez fini.
Exemple avec proc_open |
<?php $descriptorspec = array( 0 => array("pipe", "r"), // stdin est un pipe où le processus va lire 1 => array("pipe", "w"), // stdout est un pipe où le processus va écrire 2 => array("file", "/tmp/error-output.txt", "a"), // stderr est un fichier ); $process = proc_open("php", $descriptorspec, $pipes); if (is_resource($process)) { // $pipes ressemble à : // 0 => fichier accessible en écriture, connecté à l'entrée standard du prcessus fils // 1 => fichier accessible en lecture, connecté à la sortie standard du prcessus fils // Toute erreur sera ajoutée au fichier /tmp/error-output.txt
fwrite($pipes[0], "<?php echo \"Bonjour le monde!\"; ?>"); fclose($pipes[0]);
while(!feof($pipes[1])) { echo fgets($pipes[1], 1024); } fclose($pipes[1]); // Il est important que vous fermiez les pipes avant d'appeler // proc_close() afin d'éviter un verrouillage. $return_value = proc_close($process);
echo "La commande a retournée $return_value
|
Les numéros de descripteurs de fichiers de
descriptorspec
ne sont pas limitées à 0, 1 et 2 : vous pouvez spécifier n'importe quel
numéro de descripteur valide, et il sera passé au processus fils. Cela
permettra à votre script d'inter opérer avec d'autres scripts, et d'être
exécuté comme "co-processus". En particulier, c'est très pratique pour
passer des mots de passes à des programmes comme PGP, GPG et openssl,
avec une méthode très protégée. C'est aussi pratique pour lire des
informations de statut fournies par ces programmes, sur des descripteurs
auxiliaires.
Note |
Compatibilité Windows : les descripteurs au-dela de 2 (stderr) sont
accessibles au processus fils, sous la forme de pointeurs héritables, mais
comme l'architecture Windows n'associe pas de nombre aux descripteurs
de bas niveau, le processus fils n'a (actuellement) aucun moyen
d'y accéder. Stdin, stdout et stderr fonctionnent comme d'habitude.
|
Note |
Cette fonction a été introduite en PHP 4.3.0.
|
Note |
Si vous n'avez besoin que d'un processus uni-directionnel,
popen
sera plus pratique, car plus simple à
utiliser.
|
Voir aussi
stream_select
,
exec
,
system
,
passthru
,
popen
et
escapeshellcmd
.
|