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

# shell_exec

(PHP 4, PHP 5, PHP 7)

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

### Description

shell_exec ( string `$cmd` ) : string

shell_exec() est identique aux guillemets obliques.

### Liste de paramètres

`cmd`

  La commande à exécuter.

### Valeurs de retour

La sortie de l'exécution de la commande 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 lorsque vous souhaitez récupérer le code de sortie de votre programme.

### Exemples

Exemple #1 Exemple avec shell_exec()

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

### Notes

> Note:

> Cette fonction est désactivée par le safe-mode

### Voir aussi

- exec() - Exécute un programme externe
- escapeshellcmd() - Protège les caractères spéciaux du Shell