proc_open
Exécute une commande et ouvre les pointeurs de fichiers pour les entrées / sorties
&reftitle.description;
resourceproc_openstringcmdarraydescriptorspecarraypipesstringcwdarrayenvarrayother_optionsproc_open est similaire à popen
mais fournit un plus grand degré de contrôle sur l'exécution du programme.
&reftitle.parameters;
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.
Chaque élément peut être :
Un tableau décrivant le pipe à passer au processus. Le premier élément
est le type du descripteur et le second est une option pour le type donné.
Les types valides sont pipe (le second élément est soit
r pour passer la fin de lecture du pipe au processus, ou
w pour passer la fin d'écriture) et
file (le second élément est le nom de fichier).
Une ressource de flux représentant un descripteur de fichier (e.g. un fichier
ouvert, un socket, ou bien STDIN).
Les numéros de pointeurs 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 supplémentaires. Les options
actuellement supportées sont :
suppress_errors (windows uniquement): suppression des
erreurs générées par cette fonction lorsque définit à &true;
bypass_shell (windows uniquement): bypass du shell
cmd.exe lorsque définit à &true;
context: contexte du flux utilisé lors de l'ouverture
des fichiers (créé avec la fonction stream_context_create)
binary_pipes: ouverture des pipes en mode binaire, au lieu
d'utiliser l'encodage habituel stream_encoding
&reftitle.returnvalues;
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é.
&reftitle.changelog;
&Version;&Description;6.0.0
Ajout des options context et
binary_pipes au paramètre
other_options.
5.2.1
Ajout de l'option bypass_shell au paramètre
other_options.
5.0.0.
Ajout des paramètres cwd, env et
other_options.
&reftitle.examples;
Exemple avec <function>proc_open</function>
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], '');
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";
}
?>
]]>
&example.outputs.similar;
aeiou
[PWD] => /tmp
[SHLVL] => 1
[_] => /usr/local/bin/php
)
La commande a retourné 0
]]>
&reftitle.notes;
Compatibilité Windows : les descripteurs au-delà de 2 (stderr) sont
accessibles au processus fils, sous la forme de pointeurs hérités, 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. D'un autre coté, stdin, stdout et stderr fonctionnent
comme d'habitude.
Si vous n'avez besoin que d'un processus unidirectionnel,
popen sera plus pratique, car plus simple à
utiliser.
&reftitle.seealso;
popenexecsystempassthrustream_selectLes guillemets obliques