# 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 qui peut causer la fonction à échouer pour des sorties binaires. Considérer l'utilisation de popen() pour de tel 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é, `false` si le pipe ne peut pas être établie, 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.

### Erreurs / Exceptions

Une erreur de niveau `E_WARNING` est généré quand le pipe ne pas être établie.

### Exemples

Exemple #1 Exemple avec shell_exec()

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

### Voir aussi

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