array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.system.php', 1 => 'system', 2 => 'Exécute un programme externe et affiche le résultat', ), 'up' => array ( 0 => 'ref.exec.php', 1 => 'Fonctions sur l\'exécution de programmes externes', ), 'prev' => array ( 0 => 'function.shell-exec.php', 1 => 'shell_exec', ), 'next' => array ( 0 => 'book.parallel.php', 1 => 'parallel', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/exec/functions/system.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

system

(PHP 4, PHP 5, PHP 7, PHP 8)

system — Exécute un programme externe et affiche le résultat

Description

system(string $command, int &$result_code = null): string|false

system() est la version PHP de la fonction C qui exécute la commande command et retourne le résultat.

L'appel à la fonction system() tente également d'actualiser le buffer de sortie du serveur web après chaque ligne de sortie si PHP fonctionne en tant que module serveur.

S'il faut exécuter une commande et récupérer tout le résultat sans aucune intervention, il convient d'utiliser la fonction passthru().

Liste de paramètres

command

La commande à exécuter.

result_code

Si l'argument result_code est présent, alors le statut retourné de l'exécution de la commande sera écrit dans cette variable.

Valeurs de retour

Retourne la dernière ligne de la sortie de la commande en cas de succès, et false si une erreur survient.

Exemples

Exemple #1 Exemple avec system()

<?php
echo '<pre>';

// Affiche le résultat de la commande "ls" et retourne
// la dernière ligne dans $last_line. Stocke la valeur retournée
// par la commande shell dans $retval.
$last_line = system('ls', $retval);

// Affichage d'autres informations
echo '
</pre>
<hr />La dernière ligne en sortie de la commande : ' . $last_line . '
<hr />Valeur retournée : ' . $retval;
?>

Notes

Avertissement

Si des données provenant des utilisateurs ont la permission d'être passées à cette fonction, utilisez escapeshellarg() ou escapeshellcmd() pour s'assurer que les utilisateurs ne peuvent pas amener le système à exécuter des commandes arbitraires.

Note:

Si un programme est démarré avec cette fonction et qu'il tourne en arrière plan, la sortie du programme doit être redirigée vers un fichier, ou un autre flux de sortie. À défaut, PHP sera bloqué jusqu'à la fin de l'exécution du programme.

Voir aussi