shell_exec

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

shell_exec — Executa um comando via shell e retorna a saída inteira como uma string

Descrição

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

Esta função é identica ao operador crase.

Note:

No Windows, o tubo subjacente é aberto em modo texto o que pode fazer com que a função falhe para saída binária. Considere usar popen() alternativamente para estes casos.

Parâmetros

command

O comando que será executado.

Valor Retornado

Uma string contendo a saída do comando executado, false se o tubo não puder ser estabelecido ou null se um erro ocorrer ou o comando não gerar saída.

Note:

Esta função pode retornar null quando um erro ocorre ou quando o programa não produz saída. Não é possível detectar falhas de execução usando esta função. exec() deve ser usada quando o acesso ao código de saída do programa é requerido.

Erros/Exceções

Um erro de nível E_WARNING é gerado quando o tubo não puder ser estabelecido.

Exemplos

Example #1 Um exemplo de shell_exec()

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

Veja Também