Manual do PHP
Anterior |  | Próxima

# system

(PHP 3, PHP 4 )

system -- Executa um programa externo e mostra a saída

## Descrição

string system ( string command [, int return_var])

system() é igual a versão C desta função no que executa o `command` indicado e mostra o resultado. Se é dada uma variável como segundo argumento, então o código de status de retorno será escrito nesta variável.

Atenção
Se você irá permitir que dados vindos do usuário sejam passados para esta função, você deve usar escapeshellarg() ou escapeshellcmd() para ter certesa que os usuários não enganem o sistema executando comandos arbritários.

> Nota: Se você iniciar um programa usando esta função e quiser deixar ele sendo executado em segundo plano, você deve ter certesa que a saída do programa é redirecionada para um arquivo ou outro stream de saída se não o PHP irá parar até que termine a execução do programa.

A função system() também tenta automaticamente limpar o buffer de saída do servidor mandando os dados para o browser após cada linha de saída se o PHP estiver sendo executado como módulo de servidor.

Retorna a última linha da saída do comando em caso de sucesso ou `FALSE` em caso de falha.

Se você precisa executar um comando e ter todos os dados do comando passados sem nenhuma interferencia, use a função passthru().

Exemplo 1. Exemplo system()

`<?php echo '<pre>'; // Mostra todo o resultado do comando do shell "ls", e retorna // a última linha da saída em $last_line. Guarda o valor de retorno // do comando shell em $retval. $last_line = system('ls', $retval); // Mostrando informação adicional echo ' </pre> <hr>Última linha da saída: '.$last_line.' <hr>Valor de Retorno: '.$retval; ?>`

Veja também exec(), passthru(), popen(), escapeshellcmd(), e backtick operator.

Anterior | Principal | Próxima
shell_exec | Acima | Impressão