# shell_exec

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

shell_exec — Führt einen Befehl auf der Shell aus und liefert die komplette Ausgabe als String

### Beschreibung

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

Diese Funktion ist identisch zum Backtick-Operator.

> Hinweis:

> Unter Windows wird die darunterliegende Pipe im Textmodus geöffnet, was bewirken kann, dass die Funktion für binäre Ausgaben fehlschlägt. Es ist zu erwägen, für solche Fälle stattdessen popen() zu verwenden.

### Parameter-Liste

`command`

  Der auszuführende Befehl.

### Rückgabewerte

Ein String, der die Ausgabe des ausgeführten Befehls enthält, `false`, wenn die Pipe nicht angelegt werden kann, oder `null`, wenn ein Fehler auftrat oder der Befehl keine Ausgabe erzeugt.

> Hinweis:

> Diese Funktion kann `null` zurückgeben, sowohl wenn ein Fehler auftritt als auch wenn das Programm keine Ausgabe erzeugt. Es ist nicht möglich, mit dieser Funktion das Scheitern der Ausführung festzustellen. Wenn Zugriff auf den Exitcode des Programms erforderlich ist, sollte exec() verwendet werden.

### Fehler/Exceptions

Ein Fehler der Stufe `E_WARNING` wird erzeugt, wenn die Pipe nicht angelegt werden kann.

### Beispiele

Beispiel #1 Ein shell_exec()-Beispiel

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

### Siehe auch

- exec() - Führt ein externes Programm aus
- escapeshellcmd() - Maskiert Metazeichen der Shell

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open