array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'de', ), 'this' => array ( 0 => 'function.shell-exec.php', 1 => 'shell_exec', 2 => 'Führt einen Befehl auf der Shell aus und liefert die komplette Ausgabe als String', ), 'up' => array ( 0 => 'ref.exec.php', 1 => 'Funktionen zur Programmausführung', ), 'prev' => array ( 0 => 'function.proc-terminate.php', 1 => 'proc_terminate', ), 'next' => array ( 0 => 'function.system.php', 1 => 'system', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'de', '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 — 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