<- radius_cvt_int   abs ->

proc_open

(PHP 4 >= 4.3.0, PHP 5)

proc_open --  Exécute une commande et ouvre les pointeurs de fichiers pour les entrées / sorties

Description

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.

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.

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

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é.

Historique

VersionDescription
5.0.0. Ajout des paramètres cwd, env et other_options. Ajout du support pour Unix98 ptys.

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

Exemple 2. 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
}
?>

Notes

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.

Voir aussi

popen()
exec()
system()
passthru()
stream_select()
The les guillemets obliques



Rechercher une fonction PHP

<- radius_cvt_int   abs ->

Réseaux sociaux

|Plus d'options...

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher les interactions avec les réseaux sociaux sur ces pages.

 

Nuage de mots clés

5 mots clés dont 0 définis manuellement (plus d'information...).

Avertissement

Cette page ne possède pas encore de mots clés manuels, ceci est donc un exemple automatique (les niveaux de pertinence sont fictifs, mais les liens sont valables). Pour tester le nuage avec une page qui contient des mots définis manuellement, vous pouvez cliquer ici.
function Gaudry proc-open Signaler une erreur Stéphane Gaudry

Vous pouvez modifier vos préférences dans votre profil pour ne plus afficher le nuage de mots clés.

 

Références

  1. Consulter le document html Langue du document: fr Manuel PHP : http://be2.php.net, proc_open

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.

 

Structure du document

Astuce pour imprimer les couleurs des cellules de tableaux : http://www.gaudry.be/ast-rf-450.html
Aucun commentaire pour cette page

© Ce document issu de l′infobrol est enregistré sous le certificat Cyber PrInterDeposit Digital Numbertection. Enregistrement IDDN n° 5329-7174
Document créé le 08/11/06 03:44, dernière modification le Vendredi 17 Juin 2011, 12:12
Source du document imprimé : http://www.gaudry.be/php-rf-function.proc-open.html Document affiché 1 fois ce mois de Juin.
St.Gaudry©07.01.02
Outils (masquer)
||
Recherche (afficher)
Recherche :

Utilisateur (masquer)
Navigation (masquer)
Apparence (afficher)
Stats (afficher)
15832 documents
452 astuces.
549 niouzes.
3099 definitions.
447 membres.
8115 messages.

Document genere en :
0,32 seconde

Mises à jour :
Mises à jour du site
Citation (masquer)
Le génie commence les beaux ouvrages, mais le travail seul les achève.

Joseph Joubert
 
l'infobrol
Nous sommes le Dimanche 03 Juin 2012, 01:35, toutes les heures sont au format GMT+1.00 Heure, heure d'été (+1)