popen

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

popenAbre un proceso de un puntero a un fichero

Descripción

popen(string$command, string$mode): resource

Abre una tubería hacia un proceso ejecutado bifurcando el comando dado por command.

Parámetros

command

El comando

mode

El modo

Valores devueltos

Devuelve un puntero al fichero idéntico al devuelto por fopen(), excepto que es uni-direccional (sólo se puede usar para lectura o escritura) y debe ser cerrado con pclose(). Este puntero se puede usar con fgets(), fgetss(), y fwrite(). Cuando el modo es 'r', el puntero al fichero devuelto iguala al STDOUT del comando, cuando el modo es 'w', el puntero al fichero devuelto iguala al STDIN del comando.

Si se produjo un error, devuelve false.

Ejemplos

Ejemplo #1 Ejemplo de popen()

<?php
$gestor
= popen("/bin/ls", "r");
?>

Si el comando a ejecutar no puede ser encontrado, se devuelve un recurso válido. Esto puede parecer extraño, pero tiene sentido; permite el acceso a cualquier mensaje de error devuelto por el intérprete de comandos:

Ejemplo #2 Ejemplo de popen()

<?php
error_reporting
(E_ALL);


$gestor = popen('/ruta/al/ejecutable 2>&1', 'r');
echo
"'$gestor'; " . gettype($gestor) . "\n";
$leer = fread($gestor, 2096);
echo
$leer;
pclose($gestor);
?>

Notas

Nota:

Si está buscando un soporte bi-direccional (dos-vías), use proc_open().

Ver también

  • pclose() - Cierra un proceso de un puntero a un fichero
  • fopen() - Abre un fichero o un URL
  • proc_open() - Ejecuta un comando y abre un puntero de fichero para entrada/salida
To Top