shell_exec

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

shell_execВыполнить команду через оболочку и вернуть вывод в виде строки

Описание

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

Функция идентична оператору с обратным апострофом.

Замечание:

В Windows нижележащий канал открывается в текстовом режиме, что может привести к сбою функции для двоичного вывода. В таком случае попробуйте вместо этого использовать popen().

Список параметров

command

Команда, которая будет выполнена.

Возвращаемые значения

Строка (string), содержащая вывод выполненной команды, false, если канал не может быть установлен или null в случае возникновения ошибки или отсутствии вывода команды.

Замечание:

Эта функция может вернуть null в двух случаях: если произошла ошибка или если выполняемая команда ничего не выводит. Не пользуйтесь этой функцией, для определения, успешно ли выполнилась команда. Вместо этого используйте exec(), так как она предоставляет возможность проверить код возврата.

Ошибки

Выдаётся ошибка уровня E_WARNING, когда канал не может быть установлен.

Примеры

Пример #1 Пример использования shell_exec()

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

Смотрите также

  • exec() - Выполнить внешнюю программу
  • escapeshellcmd() - Экранировать метасимволы командной строки