php:// — Acceso a los diversos flujos I/O
PHP proporciona un número importante de flujos I/O que permiten acceder a los flujos de entrada y salida de PHP mismo, a los descriptores de ficheros de entrada, salida y error estándar, a flujos que representan ficheros temporales en memoria viva o en disco, así como a filtros que pueden manipular otros recursos de ficheros durante la lectura o escritura.
php://stdin, php://stdout y
php://stderr permiten acceso directo a los flujos de entrada
o salida correspondientes del proceso PHP. El flujo hace referencia a una copia
del descriptor de fichero, lo que significa que si se abre php://stdin
y se cierra más tarde, solo se cierra la copia del descriptor; el
flujo realmente referenciado por STDIN no se ve afectado.
Se recomienda utilizar únicamente las constantes STDIN,
STDOUT y STDERR en lugar
de abrir manualmente los flujos utilizando estas envolturas.
php://stdin es de solo lectura, mientras que php://stdout y php://stderr son de solo escritura.
php://input es un flujo de solo lectura que permite
leer datos sin tratar desde el cuerpo de la petición.
php://input no está disponible en las peticiones POST con
enctype="multipart/form-data" si la opción
enable_post_data_reading
está activada.
php://output es un flujo de solo escritura, que permite escribir en el mecanismo de buffer de salida de la misma manera que las funciones print y echo.
php://fd permite acceso directo al descriptor de fichero especificado. Por ejemplo, php://fd/3 corresponde al descriptor de fichero número 3.
php://memory y php://temp son flujos de lectura/escritura que permiten almacenar datos temporales en una envoltura de ficheros. Una diferencia entre estos dos flujos es que php://memory almacenará siempre sus datos en memoria, mientras que php://temp utilizará un fichero temporal una vez que la cantidad de datos almacenados haya superado un límite predefinido (por omisión, 2 Mo). La ubicación de este fichero temporal se determina de la misma manera que para la función sys_get_temp_dir().
El límite de memoria de php://temp puede ser controlado
añadiendo /maxmemory:NN, donde NN es
la cantidad máxima de datos a conservar en memoria antes de utilizar
un fichero temporal, en bytes.
Algunas extensiones PHP pueden requerir un flujo IO estándar, y pueden intentar convertir un flujo dado a un flujo IO estándar. Esta conversión puede fallar para los flujos de memoria, ya que la función C fopencookie() debe estar disponible. Esta función C no está disponible en Windows.
php://filter es una especie de envoltura prevista para permitir la aplicación de filtros sobre un flujo en el momento de su apertura. Esto es muy práctico con funciones sobre ficheros todas-en-una como las funciones readfile(), file() y file_get_contents(), donde no existe otro mecanismo que permita aplicar un filtro al flujo antes de que el contenido sea leído.
La meta de php://filter toma los parámetros siguientes bajo la forma de componentes de su ruta. Varios filtros encadenados pueden ser especificados en una sola ruta. Consúltese los ejemplos para un uso correcto de estos parámetros.
| Nombre | Descripción |
|---|---|
resource=<flujo a filtrar>
|
Este parámetro es requerido. Especifica el flujo que se desea filtrar. |
read=<lista de filtros a aplicar a la lectura>
|
Este parámetro es opcional. Uno o más nombres de filtros
pueden ser proporcionados aquí, separados por un carácter pipe (|).
|
write=<lista de filtros a aplicar a la escritura>
|
Este parámetro es opcional. Uno o más nombres de filtros
pueden ser proporcionados aquí, separados por un carácter pipe (|).
|
<lista de filtros a aplicar tanto a la lectura como a la escritura>
|
Todos los filtros proporcionados sin ser prefijados por read=
o write= serán aplicados tanto a la
lectura como a la escritura.
|
Ejemplo #1 php://temp/maxmemory
Este parámetro opcional permite configurar el límite de memoria antes de que php://temp comience a utilizar un fichero temporal.
<?php
// Define el límite a 5 Mo.
$fiveMBs = 5 * 1024 * 1024;
$fp = fopen("php://temp/maxmemory:$fiveMBs", 'r+');
fputs($fp, "hello\n");
// Lee lo que acabamos de escribir.
rewind($fp);
echo stream_get_contents($fp);
?>Ejemplo #2 php://filter/resource=<flujo a filtrar>
Este parámetro debe ser colocado al final de la especificación de php://filter y debe apuntar al flujo que se desea filtrar.
<?php
/* Esto es equivalente a
readfile("http://www.example.com");
ya que no se especifica ningún filtro */
readfile("php://filter/resource=http://www.example.com");
?>Ejemplo #3 php://filter/read=<lista de filtros a aplicar a la lectura>
Este parámetro toma uno o más nombres de filtros separados por
un carácter pipe |.
<?php
/* Esto mostrará el contenido de
www.example.com completamente en mayúsculas */
readfile("php://filter/read=string.toupper/resource=http://www.example.com");
/* Esto hará lo mismo que el anterior,
pero codificará además el resultado en ROT13 */
readfile("php://filter/read=string.toupper|string.rot13/resource=http://www.example.com");
?>Ejemplo #4 php://filter/write=<lista de filtros a aplicar a la escritura>
Este parámetro toma uno o más nombres de filtros separados por
un carácter pipe |.
<?php
/* Esto filtrará la cadena "Hello World"
a través del filtro rot13, y luego escribirá el resultado
en el fichero example.txt del directorio actual */
file_put_contents("php://filter/write=string.rot13/resource=example.txt","Hello World");
?>Ejemplo #5 php://memory y php://temp no son reutilizables
php://memory y php://temp no son reutilizables, es decir, después de que los flujos hayan sido cerrados no hay manera de referenciarlos nuevamente.
<?php
file_put_contents('php://memory', 'PHP');
echo file_get_contents('php://memory'); // no muestra nada