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.