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

# 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

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

Esta função é identica ao operador de execução.

> Nota:

> 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.

> Nota:

> 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

Exemplo #1 Um exemplo de shell_exec()

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

### Veja Também

- exec() - Executa um programa externo
- escapeshellcmd() - Escapa meta-caracteres shell

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open