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() - Экранирует метасимволы командной строки