(PHP 4, PHP 5, PHP 7, PHP 8)
popen — Abre um processo como ponteiro de arquivo
Abre uma pipe para um processo executado ao se dar um fork para o comando dado por command.
commandO comando
mode O modo. Pode ser 'r' para leitura ou 'w' para escrita.
No Windows, o padrão de popen() é modo texto, isto é, qualquer caractere \n escrito ou lido do tubo será traduzido para \r\n. Se isto não for desejado, o modo binário pode ser forçado definindo-se o mode para 'rb' e 'wb', respectivamente.
Retorna um ponteiro de arquivo idêntico ao retornado por fopen(), exceto que ele é unidirecional (pode ser usado somente para leitura ou gravação) e tem que ser fechado com pclose(). Este ponteiro pode ser usado com fgets(), fgetss() e fwrite(). Quando o modo é 'r', o ponteiro de arquivo retornado é igual ao STDOUT do comando; quando o modo é 'w', o ponteiro de arquivo é igual ao STDIN do comando.
Se um erro ocorrer, retorna false.
Exemplo #1 Exemplo de popen()
<?php
$handle = popen("/bin/ls", "r");
?>Se o comando a ser executado não for encontrado, um resource válido é retornado. Isso pode parecer estranho, mas tem sentido: permite que você acesse qualquer mensagem de erro retornado pelo sistema operacional.
Exemplo #2 Exemplo da popen()
<?php
error_reporting(E_ALL);
$handle = popen('/caminho/para/executavel 2>&1', 'r');
echo "'$handle'; " . gettype($handle) . "\n";
$read = fread($handle, 2096);
echo $read;
pclose($handle);
?>Nota:
Se for necessário suporte bidirecional (duas mãos), use proc_open().