Index: phpdoc/fr/functions/exec.xml
diff -u phpdoc/fr/functions/exec.xml:1.5 phpdoc/fr/functions/exec.xml:1.6
--- phpdoc/fr/functions/exec.xml:1.5 Sat Jul 7 18:22:07 2001
+++ phpdoc/fr/functions/exec.xml Fri Jul 13 03:43:21 2001
@@ -1,258 +1,270 @@
-
- Exécution de programmes externes
- Exécution de programmes
-
-
- escapeshellarg
-
- Echappe une chaîne de caractères pour qu'elle soit
- utilisée en ligne de commande.
-
-
-
- Description
+
+ Exécution de programmes externes
+ Exécution de programmes
+
+
+ Ces fonctions fournissent la possibilité de passer directement des commandes
+ au système, mais aussi de protéger le système des commandes passées.
+ Ces fonctions sont complétées par l'opérateur
+ guillemets obliques.
+
+
+
+
+ escapeshellarg
+
+ Echappe une chaîne de caractères pour qu'elle soit
+ utilisée en ligne de commande.
+
+
+
+ Description
-
- string escapeshellarg
- string arg
-
-
-
- escapeshellarg ajoute des guillemets simples
- autour des chaînes de caractères, et ajoute des
- guillemets puis échappe les guillemets simples de la
- chaîne. Cela permet de faire passer directement une
- chaîne comme argument shell, tout en assurant un
- maximum de sécurité. escapeshellarg
- doit être utilisée pour traiter individuellement chacun des arguments
- à passer au shell. Les fonctions shell sont
- exec, system et
- les opérateurs de
- guillemets obliques.
- Une utilisation typique est :
-
-
-
-
+
+ string escapeshellarg
+ string arg
+
+
+
+ escapeshellarg ajoute des guillemets simples
+ autour des chaînes de caractères, et ajoute des
+ guillemets puis échappe les guillemets simples de la
+ chaîne. Cela permet de faire passer directement une
+ chaîne comme argument shell, tout en assurant un
+ maximum de sécurité. escapeshellarg
+ doit être utilisée pour traiter individuellement chacun des arguments
+ à passer au shell. Les fonctions shell sont
+ exec, system et
+ les opérateurs
+ guillemets obliques.
+ Une utilisation typique est :
+
+
+
+
<?php
-system("ls ".escapeshellarg($dir));
-?gt;
-
-
-
-
- Voir aussi
- exec,
- popen,
- system et
- les opérateurs guillemets obliques.
-
-
-
-
-
- escapeshellcmd
- Echappe les méta-caractères Shell.
-
-
- Description
-
-
- string escapeshellcmd
- string command
-
-
-
- escapeshellcmd échappe tous les
- caractères de la chaîne command
- qui pourraient avoir une signification spéciale dans une
- commande shell. Cette fonction permet de s'assurer que la commande sera
- correctement passée à l'exécuteur de commande shell
- exec et system, ou encore
- à
- guillemets obliques.
- Généralement, cette fonction est utilisée comme ceci :
-
-
-
-
+ system("ls ".escapeshellarg($dir));
+?>
+
+
+
+
+ Voir aussi
+ exec,
+ popen,
+ system et
+ les opérateurs
+ guillemets obliques.
+
+
+
+
+
+ escapeshellcmd
+ Echappe les méta-caractères Shell.
+
+
+ Description
+
+
+ string escapeshellcmd
+ string command
+
+
+
+ escapeshellcmd échappe tous les
+ caractères de la chaîne command
+ qui pourraient avoir une signification spéciale dans une
+ commande shell. Cette fonction permet de s'assurer que la commande sera
+ correctement passée à l'exécuteur de commande shell
+ exec et system, ou encore
+ à
+ guillemets obliques.
+ Généralement, cette fonction est utilisée comme ceci :
+
+
+
+
<?php
-system(escapeshellcmd($cmd));
-?gt;
-
-
-
-
- Voir aussi
- exec,
- popen,
- system, et
- les opérateurs guillemets obliques.
-
-
-
-
-
- exec
- Exécute un programme externe.
-
-
- Description
-
-
- string exec
- string command
- string
- array
-
-
- int
- return_var
-
-
-
-
- exec éxecute la commande
- command, mais ne renvoie rien comme retour,
- hormis la dernière ligne du résultat de la
- commande. Pour exécuter une commande et obtenir le
- résultat sans aucun traitement, il faut utiliser la
- fonction passthru.
-
-
- Si l'argument array est présent,
- alors ce tableau sera rempli par les lignes retournées par
- la commande. Il faut noter que si ce tableau contient des
- éléments, exec ajoutera
- les nouvelles lignes à la fin du tableau. Si vous ne
- voulez pars que les nouveaux éléments soient
- concaténés, utilisez la fonction
- unset avec ce tableau avant
- de le passer à exec.
-
-
- Si l'argument return_var est présent
- en plus du tableau array, alors de statut
- de retour d'exécution sera inscrit dans cette variable.
-
-
- Notez que si vous allez fournir des commandes qui proviennent
- d'un utilisateur, il est avisé d'utiliser la fonction
- escapeshellcmd pour s'assurer que
- l'utilisateur n'essaie pas de profiter des caractères
- spéciaux pour tromper le système.
-
-
- Voir aussi system,
- passthru, popen,
- escapeshellcmd, et les opérateur de backtick.
-
-
-
-
-
- passthru
-
- Exécute un programme externe et affiche le résultat brut.
-
-
-
- Description
-
-
- void passthru
- string command
- int
- return_var
-
-
-
-
- La fonction passthru est similaire
- à la fonction exec car les
- deux exécutent la commande command.
- Si l'argument return_var est présent,
- le code de statut de réponse UNIX y sera placé.
- Cette fonction doit être utilisée de préférence
- aux commandes exec ou system
- lorsque le résultat attendu est de type binaire, et
- doit être passé tel quel à un navigateur.
- Une utilisation classique de cette fonction est l'exécution
- de l'utilitaire pbmplus qui peut retourner une image. En fixant
- le résultat du contenu (content-type) à
- "image/gif" puis en appelant pbmplus pour obtenir
- une image gif, vous pouvez créer des scripts PHP qui
- retourne des images.
-
-
- Voir aussi
- exec,
- system,
- popen,
- escapeshellcmd,
- et les opérateurs guillemets obliques.
-
-
-
-
-
- system
-
- Exécute un programme externe et affiche le résultat.
-
-
-
- Description
-
-
- string system
- string command
- int
- return_var
-
-
-
-
- system est la version PHP de la fonction C
- qui exécute la commande command et
- retourne le résultat. Si une variable est fournie comme
- second argument, alors le code de statut de la commande y sera
- affecté.
-
-
- Notez que si vous allez fournir des commandes qui proviennent
- d'un utilisateur, il est avisé d'utiliser la fonction
- escapeshellcmd pour s'assurer que
- l'utilisateur n'essaie pas de profiter des caractères
- spéciaux pour tromper le système.
-
-
- system essaie automatiquement de vider
- les tampons du serveur web après chaque ligne de
- résultat PHP, lorsque ce dernier fonctionne comme un module.
-
-
- system retourne la dernière ligne du
- retour, en cas de succès, et &false; en
- cas d'échec.
-
-
- Si vous devez exécuter une commande et
- récupérer tout le résultat sans aucune
- intervention, utilisez la fonction passthru.
-
-
- Voir aussi
- exec,
- passthru,
- popen,
- escapeshellcmd et
- les opérateurs guillemets obliques.
-
-
-
-
+ system(escapeshellcmd($cmd));
+?>
+
+
+
+
+ Voir aussi
+ exec,
+ popen,
+ system, et
+ les opérateurs
+ guillemets obliques.
+
+
+
+
+
+ exec
+ Exécute un programme externe.
+
+
+ Description
+
+
+ string exec
+ string command
+ string
+ array
+
+
+ int
+ return_var
+
+
+
+
+ exec éxecute la commande
+ command, mais ne renvoie rien comme retour,
+ hormis la dernière ligne du résultat de la
+ commande. Pour exécuter une commande et obtenir le
+ résultat sans aucun traitement, il faut utiliser la
+ fonction passthru.
+
+
+ Si l'argument array est présent,
+ alors ce tableau sera rempli par les lignes retournées par
+ la commande. Il faut noter que si ce tableau contient des
+ éléments, exec ajoutera
+ les nouvelles lignes à la fin du tableau. Si vous ne
+ voulez pars que les nouveaux éléments soient
+ concaténés, utilisez la fonction
+ unset avec ce tableau avant
+ de le passer à exec.
+
+
+ Si l'argument return_var est présent
+ en plus du tableau array, alors de statut
+ de retour d'exécution sera inscrit dans cette variable.
+
+
+ Notez que si vous allez fournir des commandes qui proviennent
+ d'un utilisateur, il est avisé d'utiliser la fonction
+ escapeshellcmd pour s'assurer que
+ l'utilisateur n'essaie pas de profiter des caractères
+ spéciaux pour tromper le système.
+
+
+ Voir aussi system,
+ passthru, popen,
+ escapeshellcmd, et les opérateurs
+ guillemets obliques.
+
+
+
+
+
+ passthru
+
+ Exécute un programme externe et affiche le résultat brut.
+
+
+
+ Description
+
+
+ void passthru
+ string command
+ int
+ return_var
+
+
+
+
+ La fonction passthru est similaire
+ à la fonction exec car les
+ deux exécutent la commande command.
+ Si l'argument return_var est présent,
+ le code de statut de réponse UNIX y sera placé.
+ Cette fonction doit être utilisée de préférence
+ aux commandes exec ou system
+ lorsque le résultat attendu est de type binaire, et
+ doit être passé tel quel à un navigateur.
+ Une utilisation classique de cette fonction est l'exécution
+ de l'utilitaire pbmplus qui peut retourner une image. En fixant
+ le résultat du contenu (Content-Type) à
+ "image/gif" puis en appelant pbmplus pour obtenir
+ une image gif, vous pouvez créer des scripts PHP qui
+ retourne des images.
+
+
+ Voir aussi
+ exec,
+ system,
+ popen,
+ escapeshellcmd,
+ et les opérateurs
+ guillemets obliques.
+
+
+
+
+
+ system
+
+ Exécute un programme externe et affiche le résultat.
+
+
+
+ Description
+
+
+ string system
+ string command
+ int
+ return_var
+
+
+
+
+ system est la version PHP de la fonction C
+ qui exécute la commande command et
+ retourne le résultat. Si une variable est fournie comme
+ second argument, alors le code de statut de la commande y sera
+ affecté.
+
+
+ Notez que si vous allez fournir des commandes qui proviennent
+ d'un utilisateur, il est avisé d'utiliser la fonction
+ escapeshellcmd pour s'assurer que
+ l'utilisateur n'essaie pas de profiter des caractères
+ spéciaux pour tromper le système.
+
+
+ system essaie automatiquement de vider
+ les tampons du serveur web après chaque ligne de
+ résultat PHP, lorsque ce dernier fonctionne comme un module.
+
+
+ system retourne la dernière ligne du
+ retour, en cas de succès, et FALSE en
+ cas d'échec.
+
+
+ Si vous devez exécuter une commande et
+ récupérer tout le résultat sans aucune
+ intervention, utilisez la fonction passthru.
+
+
+ Voir aussi
+ exec,
+ passthru,
+ popen,
+ escapeshellcmd et
+ les opérateurs
+ guillemets obliques.
+
+
+
+
