array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.shell-exec.php', 1 => 'shell_exec', 2 => 'Exécute une commande via le Shell et retourne le résultat sous forme de chaîne', ), 'up' => array ( 0 => 'ref.exec.php', 1 => 'Fonctions sur l\'exécution de programmes externes', ), 'prev' => array ( 0 => 'function.proc-terminate.php', 1 => 'proc_terminate', ), 'next' => array ( 0 => 'function.system.php', 1 => 'system', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/exec/functions/shell-exec.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

shell_exec

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

shell_exec — Exécute une commande via le Shell et retourne le résultat sous forme de chaîne

Description

shell_exec(string $command): string|false|null

shell_exec() est identique aux guillemets obliques.

Note:

Sur Windows, le tube sous-jacent est ouvert en mode texte, ce qui peut entraîner l'échec de la fonction pour des sorties binaires. Il est recommandé d'utiliser popen() dans de tels cas.

Liste de paramètres

command

La commande à exécuter.

Valeurs de retour

Une chaîne de caractères contenant le résultat de la commande exécutée, false si le pipe ne peut pas être établi, ou null si une erreur survient ou si la commande ne produit aucune sortie.

Note:

Cette fonction peut retourner null lorsqu'une erreur survient mais aussi lorsque le programme ne produit aucune sortie. Il n'est pas possible de détecter les échecs d'exécution en utilisant cette fonction. La fonction exec() doit être utilisée lorsqu'on souhaite récupérer le code de sortie du programme.

Erreurs / Exceptions

Une erreur de niveau E_WARNING est générée lorsque le pipe ne peut pas être établi.

Exemples

Exemple #1 Exemple avec shell_exec()

<?php
$output = shell_exec('ls -lart');
echo "<pre>$output</pre>";
?>

Voir aussi