(PHP 4 >= 4.3.0, PHP 5)
proc_open -- Exécute une commande et ouvre les pointeurs de fichiers pour les entrées / sortiesproc_open() est similaire à popen() mais fournit un plus grand degré de contrôle sur l'exécution du programme.
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 et pipe.
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 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 |
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é.
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.
Précédent | Sommaire | Suivant |
proc_nice | Niveau supérieur | proc_terminate |