Update fopen.xml

This commit is contained in:
Mikhail Alferov
2024-05-21 03:42:21 +03:00
committed by GitHub
parent b475129152
commit 058d63ce24

View File

@ -4,7 +4,7 @@
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.fopen">
<refnamediv>
<refname>fopen</refname>
<refpurpose>Открывает файл или URL</refpurpose>
<refpurpose>Открывает файл или URL-адрес</refpurpose>
</refnamediv>
<refsect1 role="description">
@ -17,8 +17,8 @@
<methodparam choice="opt"><type class="union"><type>resource</type><type>null</type></type><parameter>context</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>fopen</function> закрепляет именованный ресурс, указанный
в аргументе <parameter>filename</parameter>, за потоком.
Функция <function>fopen</function> закрепляет именованный ресурс, который задали
в параметре <parameter>filename</parameter>, за потоком.
</para>
</refsect1>
@ -30,28 +30,28 @@
<term><parameter>filename</parameter></term>
<listitem>
<para>
Если <parameter>filename</parameter> передан в форме "scheme://...",
он считается URL и PHP проведёт поиск обработчика протокола
(также известного как "обёртка") для этой схемы. Если ни одна
Если значение аргумента для параметра <parameter>filename</parameter> передали в форме «scheme://...»,
значение считается URL-адресом и PHP проведёт поиск обработчика протокола
(который также знают как «обёртка») для этой схемы. Если ни одна
обёртка не закреплена за протоколом, PHP выдаст замечание,
чтобы помочь вам отследить потенциальную проблему в вашем
скрипте и затем продолжит выполнение, как если бы <parameter>filename</parameter>
чтобы помочь отследить потенциальную проблему
в скрипте и затем продолжит выполнение, как если бы параметр <parameter>filename</parameter>
указывал на обыкновенный файл.
</para>
<para>
Если PHP установлено, что <parameter>filename</parameter> указывает на
Если PHP решил, что имя файла <parameter>filename</parameter> указывает на
локальный файл, тогда выполняется попытка открыть поток к этому файлу.
Файл должен быть доступен PHP, так что вам следует убедиться,
что права доступа на файл это разрешают.
Если вы включили <link linkend="ini.open-basedir">open_basedir</link>, то накладываются
Файл должен быть доступен PHP, поэтому следует убедиться,
что права доступа на файл разрешают этот доступ.
Если включили директиву <link linkend="ini.open-basedir">open_basedir</link>, то накладываются
дальнейшие ограничения.
</para>
<para>
Если PHP установил, что <parameter>filename</parameter> указывает на
Если PHP установил, что параметр <parameter>filename</parameter> указывает на
зарегистрированный протокол и этот протокол зарегистрирован как
сетевой URL, PHP выполняет проверку состояния директивы
сетевой URL-адрес, PHP выполняет проверку состояния директивы
<link linkend="ini.allow-url-fopen">allow_url_fopen</link>.
Если она выключена, PHP выдаст предупреждение и вызов fopen закончится
Если директива выключена, PHP выдаст предупреждение и вызов fopen закончится
неудачей.
</para>
<note>
@ -72,7 +72,9 @@
<programlisting role="php">
<![CDATA[
<?php
$handle = fopen("c:\\folder\\resource.txt", "r");
?>
]]>
</programlisting>
@ -276,7 +278,7 @@ $handle = fopen("c:\\folder\\resource.txt", "r");
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает указатель на файл в случае успешного выполнения&return.falseforfailure;
Функция возвращает указатель на файл в случае успешного выполнения&return.falseforfailure;
</para>
</refsect1>