6.32 Exécution de programmes externes
6 Référence des fonctions
Manuel PHP
. Introduction
. Pré-requis
. Installation
. Configuration à l'exécution
. Types de ressources
. Constantes pré-définies
. Voir aussi
. escapeshellarg
. escapeshellcmd
. exec
. passthru
. proc_close
. proc_get_status
. proc_nice
->proc_open
. proc_terminate
. shell_exec
. system
|
6.32.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, PHP 5
resource
proc_open (
string
cmd
,
array
descriptorspec
,
array
pipes
,
string
cwd
,
array
env
,
array
other_options
)
proc_open
est similaire à
popen
mais fournit un plus grand degré de contrôle sur l'exécution du programme.
PHP 5 introduit le support pty pour les systèmes avec Unix98 ptys.
Cela permet à votre script d'interagir avec des applications qui
s'attendent à dialoguer avec un terminal. Un pty fonctionne comme un pipe,
mais est bi-directionnel : il n'y a pas besoin de spécifier de mode lecture
ou écriture. L'exemple ci-dessous montre comment utiliser un pty. Notez
que tous les pointeurs de fichier ne doivent pas nécessairement dialoguer
avec le pty. Notez aussi que seul un pty est créé, même si pty est
spécifié 3 fois. Dans les futures versions de PHP il sera possible de faire
plus que simplement lire et écrire dans un pty.
-
cmd
-
La commande à exécuter
-
descriptorspec
-
Un tableau indexé, dont les clés représentent le numéro de descripteur
et la valeur la méthode avec laquelle PHP va passer ce descripteur au
processus fils. 0 est stdin, 1 est stdout, et 2 est stderr.
Les types de descripteurs actuellement supportés sont
file
,
pipe
et
pty
.
Les numéros de descripteurs de fichiers ne sont pas limités à 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.
-
pipes
-
Doit être défini en un tableau indexé de pointeurs de fichiers qui
correspondent à la fin de n'importe quel descripteur PHP qui sont
crés.
-
cwd
-
Le dossier initial de travail de la commande. Cela doit être
un chemin
absolu
vers le dossier ou
NULL
si vous voulez utiliser la valeur
par défaut (le dossier de travail du processus courant PHP)
-
env
-
Un tableau contenant les variables d'environnement pour la commande
qui doit être exécutée, ou
NULL
pour utiliser le même environnement
que le processus PHP courant
-
other_options
-
Vous permet de spécifier des options aditionnelles. Actuellement,
uniquement
suppress_errors
est supporté,
qui supprime les erreurs générées par cette fonction lorsqu'il est
défini à
TRUE
Retourne une ressource représentant le processus, qui pourra être utilisé par
la fonction
proc_close
lorsque vous n'en aurez plus besoin.
En cas d'échec,
FALSE
sera retourné.
| Version |
Description |
| 5.0.0. |
Ajout des paramètres
cwd
,
env
et
other_options
. Ajout du support pour
Unix98 ptys.
|
| 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
);
$cwd = '/tmp';
$env = array('quelques_options' => 'aeiou');
$process = proc_open('php', $descriptorspec, $pipes, $cwd, $env);
if (is_resource($process)) {
// $pipes ressemble à :
// 0 => fichier accessible en écriture, connecté à l'entrée standard du processus fils
// 1 => fichier accessible en lecture, connecté à la sortie standard du processus fils
// Toute erreur sera ajoutée au fichier /tmp/error-output.txt
fwrite($pipes[0], '<?php print_r($_ENV); ?>');
fclose($pipes[0]);
echo stream_get_contents($pipes[1]);
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é $return_value\n";
}
?>
|
| Utilisation de ptys |
<?php
// Crée un pseudo terminal pour le processus fils
$descriptorspec = array(
0 => array("pty"),
1 => array("pty"),
2 => array("pty")
);
$process = proc_open("cvs -d:pserver:cvsread@cvs.php.net:/repository login", $descriptorspec, $pipes);
if (is_resource($process)) {
// Travaille sur la documentation PHP ici
}
?>
|
| Note | |
Compatibilité Windows : les descripteurs au-delà 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 | |
Si vous n'avez besoin que d'un processus uni-directionnel,
popen
sera plus pratique, car plus simple à
utiliser.
|
|