php:// — Доступ к различным потокам ввода-вывода
PHP предоставляет несколько разнообразных потоков ввода-вывода, которые позволяют получить доступ к собственным потокам ввода-вывода PHP, к дескрипторам стандартного ввода, вывода и потока ошибок, к временным файловым потокам в памяти и на диске, и фильтрам, которые могут манипулировать другими файловыми ресурсами по мере их считывания или записи.
php://stdin, php://stdout и
php://stderr позволяют получить прямой доступ к соответствующим
потокам ввода или вывода процесса PHP. Поток указывает на копию файлового
дескриптора, таким образом, если вы откроете
php://stdin
и потом закроете его, вы закроете только вашу копию дескриптора. Актуальный
поток, на который ссылается STDIN
, остаётся неизменным.
Рекомендуется просто использовать константы STDIN
,
STDOUT
и STDERR
вместо ручного
открытия потоков, используя эти обёртки.
Поток php://stdin предназначен только для чтения, тогда как php://stdout и php://stderr предназначены только для записи.
php://input является потоком только для чтения, который позволяет вам
читать необработанные данные из тела запроса.
php://input недоступен в POST-запросах с
enctype="multipart/form-data"
, если
опция
enable_post_data_reading включена.
php://output является потоком только для записи, который позволяет вам записать данные в выходной буфер аналогично, как это делают функции print и echo.
php://fd предоставляет прямой доступ к указанному файловому дескриптору. Например, php://fd/3 относится к файловому дескриптору 3.
php://memory и php://temp являются потоками для чтения/записи и позволяют сохранять временные данные в файлоподобной обёртке. Единственная разница между ними заключается в том, что php://memory будет всегда хранить данные в оперативной памяти, тогда как php://temp будет использовать временный файл в том случае, когда объем хранимой информации достигнет заданного лимита (по умолчанию 2 Мб). Расположение этого временного файла определяется аналогично функции sys_get_temp_dir().
Размер лимита для php://temp может устанавливаться путём
добавления /maxmemory:NN
, где NN
— это
максимальный размер данных в байтах для хранения в памяти перед использованием временного
файла.
Модулям PHP может потребоваться стандартный поток ввода-вывода и они могут попытаться преобразовать заданный поток в стандартный поток ввода-вывода. Это преобразование может завершиться ошибкой для потоков памяти, поскольку для такого приведения необходима функция fopencookie() языка Си. Такая функция языка Си недоступна в операционных системах Windows.
php://filter — это вид мета-обёртки, предназначенный для разрешения применения фильтров к потоку во время открытия. Это полезно для функционально полных файловых функций, таких как readfile(), file() и file_get_contents(), где нет возможности применить фильтр к потоку до того, как содержимое будет прочитано.
Поток php://filter принимает следующие параметры как часть своего пути. В одном пути можно указать несколько цепочек фильтров. Пожалуйста, ознакомьтесь с примерами и особенностями при использовании этих параметров.
Название | Описание |
---|---|
resource=<поток для фильтрации>
|
Этот параметр является необходимым. Он указывает потоку, что его необходимо отфильтровать. |
read=<список фильтров для применения к цепочке чтения>
|
Этот параметр является необязательным. Одно или несколько имён фильтров может быть указано
здесь, разделённых вертикальной чертой (| ).
|
write=<список фильтров для применения к цепочке записи>
|
Этот параметр является необязательным. Одно или несколько имён фильтров может быть указано
здесь, разделённых вертикальной чертой (| ).
|
<список фильтров для применения к обеим цепочкам чтения и записи>
|
Любой список фильтров, которые используются без префиксов read=
или write= , будет применён к обоим потокам на чтение и на запись
при необходимости.
|
Пример #1 php://temp/maxmemory
Этот необязательный параметр позволяет установить лимит памяти до того, как php://temp начнёт использовать временный файл.
<?php
// Установка предела в 5 MB.
$fiveMBs = 5 * 1024 * 1024;
$fp = fopen("php://temp/maxmemory:$fiveMBs", 'r+');
fputs($fp, "hello\n");
// Читаем то, что мы записали.
rewind($fp);
echo stream_get_contents($fp);
?>
Пример #2 php://filter/resource=<поток для фильтрации>
Этот параметр должен быть расположен в конце вашей спецификации php://filter и должен указывать на поток, который вы хотите фильтровать.
<?php
/* Это просто эквивалентно:
readfile("http://www.example.com");
так как на самом деле фильтры не указаны */
readfile("php://filter/resource=http://www.example.com");
?>
Пример #3 php://filter/read=<список фильтров для применения к цепочке чтения>
Этот параметр принимает один или более
имён фильтров, разделённых вертикальной чертой |
.
<?php
/* Этот скрипт выведет содержимое
www.example.com полностью в верхнем регистре */
readfile("php://filter/read=string.toupper/resource=http://www.example.com");
/* Этот скрипт делает тоже самое, что вверхний, но
будет также кодировать алгоритмом ROT13 */
readfile("php://filter/read=string.toupper|string.rot13/resource=http://www.example.com");
?>
Пример #4 php://filter/write=<список фильтров для применения к цепочке записи>
Этот параметр принимает один или более
имён фильтров, разделённых вертикальной чертой |
.
<?php
/* Этот скрипт будет фильтровать строку "Hello World"
через фильтр rot13, затем записывать результат в
файл example.txt в текущей директории */
file_put_contents("php://filter/write=string.rot13/resource=example.txt","Hello World");
?>
Пример #5 php://memory и php://temp нельзя переиспользовать
php://memory и php://temp нельзя переиспользовать, то есть после закрытия потоков невозможно сослаться на них снова.
file_put_contents('php://memory', 'PHP');
echo file_get_contents('php://memory'); // ничего не напечатает