proc_open
(PHP 4 >= 4.3.0, PHP 5, PHP 7)
proc_open — Exécute une commande et ouvre les pointeurs de fichiers pour les entrées / sorties
Description
$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.
Liste de paramètres
-
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
NULLsi 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
NULLpour 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
-
suppress_errors (windows uniquement): suppression des
erreurs générées par cette fonction lorsque définit à
Valeurs de retour
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é.
Exemples
Exemple #1 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";
}
?>
L'exemple ci-dessus va afficher quelque chose de similaire à :
Array
(
[some_option] => aeiou
[PWD] => /tmp
[SHLVL] => 1
[_] => /usr/local/bin/php
)
La commande a retourné 0
Notes
Note:
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.
Note:
Si vous n'avez besoin que d'un processus unidirectionnel, popen() sera plus pratique, car plus simple à utiliser.
Voir aussi
- popen() - Crée un processus de pointeur de fichier
- exec() - Exécute un programme externe
- system() - Exécute un programme externe et affiche le résultat
- passthru() - Exécute un programme externe et affiche le résultat brut
- stream_select() - Surveille la modification d'un ou plusieurs flux
- Les guillemets obliques
Document créé le 30/01/2003, dernière modification le 26/10/2018
Source du document imprimé : https://www.gaudry.be/php-rf-function.proc-open.html
L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.
Références
Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.
