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
$command
): string|false|nullDiese 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