diff --git a/language/wrappers/php.xml b/language/wrappers/php.xml index f0180a26f..1a2426fe3 100644 --- a/language/wrappers/php.xml +++ b/language/wrappers/php.xml @@ -1,5 +1,5 @@ - + @@ -10,30 +10,30 @@ &reftitle.description; - PHP предоставляет несколько разнообразных потоков ввода-вывода, которые позволяют - получить доступ к собственным потокам ввода-вывода PHP, к дескрипторам стандартного ввода, вывода и - потока ошибок, к временным файловым потокам в памяти и на диске, и фильтрам, которые - могут манипулировать другими файловыми ресурсами по мере их считывания + В PHP предусмотрели ряд потоков ввода-вывода, которые открывают + доступ к собственным потокам ввода-вывода PHP, к стандартным файловым дескрипторам ввода, вывода + и ошибок, к временным файловым потокам в памяти и на диске, и фильтрам, которые + умеют манипулировать другими файловыми ресурсами по мере их считывания или записи. php://stdin, php://stdout и php://stderr - php://stdin, php://stdout и - php://stderr позволяют получить прямой доступ к соответствующим - потокам ввода или вывода процесса PHP. Поток указывает на копию файлового - дескриптора, таким образом, если вы откроете + Потоки php://stdin, php://stdout + и php://stderr открывают прямой доступ к соответствующему потоку + ввода или вывода PHP-процесса. Поток указывает на копию файлового + дескриптора, поэтому, если открыть php://stdin - и потом закроете его, вы закроете только вашу копию дескриптора. Актуальный - поток, на который ссылается STDIN, остаётся неизменным. + а потом закрыть его, закроется только копия дескриптора — фактический + поток, на который ссылается STDIN, останется неизменным. Рекомендуется просто использовать константы STDIN, STDOUT и STDERR вместо ручного - открытия потоков, используя эти обёртки. + открытия потоков через эти обёртки. - Поток php://stdin предназначен только для чтения, тогда как - php://stdout и php://stderr предназначены + Поток php://stdin доступен только для чтения, тогда как + потоки php://stdout и php://stderr — только для записи. @@ -41,20 +41,20 @@ php://input - php://input является потоком только для чтения, который позволяет вам + Поток php://input — поток только для чтения, который разрешает читать необработанные данные из тела запроса. - php://input недоступен в POST-запросах с - enctype="multipart/form-data", если - опция - enable_post_data_reading включена. + Поток php://input недоступен в POST-запросах + с типом кодирования enctype="multipart/form-data", если включили + опцию + enable_post_data_reading. php://output - php://output является потоком только для записи, который позволяет вам - записать данные в выходной буфер аналогично, как это делают функции + Поток php://output — поток только для записи, который разрешает + записывать данные в механизм буфера вывода так же, как это делают языковые конструкции print и echo. @@ -62,7 +62,7 @@ php://fd - php://fd предоставляет прямой доступ к указанному файловому + Поток php://fd разрешает прямой доступ к файловому дескриптору. Например, php://fd/3 относится к файловому дескриптору 3. @@ -71,28 +71,28 @@ php://memory и php://temp - php://memory и php://temp являются - потоками для чтения/записи и позволяют сохранять временные данные в файлоподобной + Потоки php://memory и php://temp — + потоки чтения и записи, которые разреашют сохранять временные данные в файлоподобной обёртке. Единственная разница между ними заключается в том, что - php://memory будет всегда хранить данные в оперативной памяти, - тогда как php://temp будет использовать временный файл в том случае, когда - объем хранимой информации достигнет заданного лимита (по умолчанию 2 Мб). + поток php://memory будет всегда хранить данные в оперативной памяти, + тогда как php://temp будет использовать временный файл, как только + объем хранимой информации достигнет предопределённого предела (по умолчанию 2 МБ). Расположение этого временного файла определяется аналогично функции sys_get_temp_dir. - Размер лимита для php://temp может устанавливаться путём - добавления /maxmemory:NN, где NN — это - максимальный размер данных в байтах для хранения в памяти перед использованием временного - файла. + Ограничением памяти для потока php://temp управляют путём + добавления суффикса /maxmemory:NN, где NN — + максимальный размер данных в байтах для хранения в памяти перед тем как PHP создаст временный + файл. - Модулям PHP может потребоваться стандартный поток ввода-вывода - и они могут попытаться преобразовать заданный поток в стандартный поток ввода-вывода. + Отдельным PHP-модулям иногда требуется стандартный поток ввода-вывода + и модули могут попытаться преобразовать заданный поток в стандартный поток ввода-вывода. Это преобразование может завершиться ошибкой для потоков памяти, поскольку для такого приведения - необходима функция fopencookie языка Си. - Такая функция языка Си недоступна в операционных системах Windows. + необходима функция fopencookie языка C. + Такая функция языка C недоступна в операционных системах Windows. @@ -100,12 +100,12 @@ php://filter - php://filter — это вид мета-обёртки, предназначенный для - разрешения применения фильтров к - потоку во время открытия. Это полезно для функционально полных файловых функций, - таких как readfile, file и file_get_contents, - где нет возможности применить фильтр к потоку до того, как - содержимое будет прочитано. + Поток php://filter — вид мета-обёртки, которая разрешает + применять фильтры + к потоку во время открытия. Это полезно при работе с универсальными файловыми функциями + наподобие readfile, file и file_get_contents, + где иначе нет возможности применить фильтр к потоку до считывания + содержимого. Поток php://filter принимает следующие параметры @@ -129,7 +129,7 @@ resource=<поток для фильтрации> - Этот параметр является необходимым. Он указывает потоку, что его + Этот параметр обязателен. Он указывает поток, который необходимо отфильтровать. @@ -138,8 +138,8 @@ read=<список фильтров для применения к цепочке чтения> - Этот параметр является необязательным. Одно или несколько имён фильтров может быть указано - здесь, разделённых вертикальной чертой (|). + Этот параметр необязателен. Здесь можно указать одно или несколько имён фильтров + через символ вертикальной черты (|). @@ -147,18 +147,18 @@ write=<список фильтров для применения к цепочке записи> - Этот параметр является необязательным. Одно или несколько имён фильтров может быть указано - здесь, разделённых вертикальной чертой (|). + Этот параметр необязателен. Здесь можно указать одно или несколько имён фильтров + через символ вертикальной черты (|). - <список фильтров для применения к обеим цепочкам чтения и записи> + <список фильтров для применения к обеим цепочкам> - Любой список фильтров, которые используются без префиксов read= - или write=, будет применён к обоим потокам на чтение и на запись - при необходимости. + Любые списки фильтров без префикса read= + или write= будут применяться как к цепочкам чтения, так и к цепочкам + записи. @@ -173,8 +173,8 @@ - Основная информация (для <literal>php://filter</literal> смотрите - информацию по обёртке, которая подвергается фильтрации) + Краткое описание обёртки (для потока <literal>php://filter</literal> смотрите + информацию по фильтруемой обёртке) @@ -281,21 +281,23 @@ php://temp/maxmemory - Этот необязательный параметр позволяет установить лимит памяти до того, как - php://temp начнёт использовать временный файл. + Этот необязательный параметр разрешает установить ограничение памяти до того, как + поток php://temp начнёт использовать временный файл. ]]> @@ -303,16 +305,17 @@ echo stream_get_contents($fp); php://filter/resource=<поток для фильтрации> - Этот параметр должен быть расположен в - конце вашей спецификации php://filter и - должен указывать на поток, который вы хотите фильтровать. + Этот параметр должен находиться + в конце спецификации php://filter + и указывать на поток, который необходимо отфильтровать. @@ -328,6 +331,7 @@ readfile("php://filter/resource=http://www.example.com"); ]]> @@ -342,16 +347,18 @@ readfile("php://filter/read=string.toupper|string.rot13/resource=http://www.exam php://filter/write=<список фильтров для применения к цепочке записи> - Этот параметр принимает один или более - имён фильтров, разделённых вертикальной чертой |. + Этот параметр принимает одно + или несколько имён фильтров, разделённых вертикальной чертой |. ]]> @@ -359,7 +366,7 @@ file_put_contents("php://filter/write=string.rot13/resource=example.txt","Hello php://memory и php://temp нельзя переиспользовать - php://memory и php://temp + Потоки php://memory и php://temp нельзя переиспользовать, то есть после закрытия потоков невозможно сослаться на них снова.