Руководство по PHP
Пред. |  | След.

# exec

(PHP 3, PHP 4, PHP 5)

exec -- Execute an external program

## Описание

string exec ( string command [, array &output [, int &return_var]] )

exec() executes the given `command`.

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

`command`

  The command that will be executed.

`output`

  If the `output` argument is present, then the specified array will be filled with every line of output from the command. Trailing whitespace, such as `\n`, is not included in this array. Note that if the array already contains some elements, exec() will append to the end of the array. If you do not want the function to append elements, call unset() on the array before passing it to exec().

`return_var`

  If the `return_var` argument is present along with the `output` argument, then the return status of the executed command will be written to this variable.

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

The last line from the result of the command. If you need to execute a command and have all the data from the command passed directly back without any interference, use the passthru() function.

To get the output of the executed command, be sure to set and use the `output` parameter.

## Примеры

Пример 1. An exec() example

`<?php // outputs the username that owns the running php/httpd process // (on a system with the "whoami" executable in the path) echo exec('whoami'); ?>`

## Примечания

Внимание
Если вы собираетесь передавать функции данные, отправленные пользователем, вы должны использовать функции escapeshellarg() или escapeshellcmd() для того, чтобы обезопасить исполнение команд.

> Замечание: Если вы собираетесь использовать эту функцию в программе, работающей в качестве демона, убедитесь, что стандартный вывод функции направлен в файл или другой поток, в противном случае PHP зависнет вплоть до конца выполнения программы.

> Замечание: В случае работы в безопасном режиме, вы можете запускать что-либо только в пределах safe_mode_exec_dir. В настоящее время, использование `..` в пути запрещено

Внимание
В случае работы в безопасном режиме, все слова, следующие за начальной командой, рассматриваются как единый аргумент. То есть `echo y | echo x` будет работать как `echo "y | echo x"`.

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

system()
passthru()
escapeshellcmd()
pcntl_exec()
system()
backtick operator

Пред. | Начало | След.
escapeshellcmd | Уровень выше | passthru