php/archived-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2026-03-23 23:32:16 +01:00
Code Issues Packages Projects Releases Wiki Activity

Обновление до английской версии

Browse Source
This commit is contained in:
Sergey Panteleev
2026-02-06 09:55:33 +03:00
parent 7d34112656
commit 8d40672b19
12 changed files with 122 additions and 41 deletions
Download Patch File Download Diff File Expand all files Collapse all files

6
language/predefined/closure/getcurrent.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 6fc2c24b6b465f4057d076a39c6910b8a484daad Maintainer: malferov Status: ready -->
<!-- EN-Revision: f6406cdb5ef1b83108f4022996985967c3e45b0b Maintainer: malferov Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="closure.getcurrent" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -20,7 +20,7 @@
</para>
<para>
Метод доступен только внутри замыкания; вызов извне контекста замыкания
сгенерирует ошибку.
сгенерирует ошибку: Current function is not a closure (текущая функция не является замыканием).
</para>
</refsect1>
@@ -55,7 +55,7 @@
<?php
$fibonacci = function (int $n) {
if (0 === $n || 1 === $n) {
if ($n === 0 || $n === 1) {
return $n;
}

13
language/predefined/generator/rewind.xml
View File

@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 873a99f094902ad72129ab391b1fb80525fab30e Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 5e6944e79f2b19783627d76bd7fd1411feb23c65 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="generator.rewind" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>Generator::rewind</refname>
<refpurpose>Перематывает генератор к первому выражению yield</refpurpose>
<refpurpose>Выполняет генератор до первого выражения yield</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -14,11 +14,10 @@
<void/>
</methodsynopsis>
<para>
Метод перематывает генератор к первому выражению &yield;.
При перемотке генератор выполнит код, который идёт перед первым выражением &yield;,
если при вызове метода генератор ещё не дошёл до первого выражения &yield;.
Метод выбросит исключение <classname>Exception</classname>,
если метод вызывали, когда генератор уже перешёл ко второму выражению &yield;.
Выполняет генератор до <emphasis>первого</emphasis> выражения &yield; включительно.
Если генератор уже находится в <emphasis>первом</emphasis> &yield;, никаких действий не будет выполнено.
Если генератор когда-либо продвигался дальше выражения &yield;,
метод выбросит ошибку <classname>Exception</classname>.
</para>
<note>

11
language/predefined/iterator/rewind.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 460f49a93d103cac99556147cb9325b095ca3d42 Maintainer: das Status: ready -->
<!-- EN-Revision: 7fbb16f538011636999459326a55d5f153ef2c61 Maintainer: das Status: ready -->
<!-- Reviewed: yes Maintainer: sergey -->
<refentry xml:id="iterator.rewind" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -22,6 +22,15 @@
Метод <emphasis>не будет</emphasis> вызван <emphasis>после</emphasis>
цикла &foreach;.
</para>
<simpara>
Поскольку &foreach; всегда вызывает метод <methodname>rewind</methodname> перед началом итерации,
ручное перемещение позиции итератора (например, с помощью метода <methodname>SplFileObject::seek</methodname>)
будет сброшено.
</simpara>
<simpara>
Для выполнения итерации без перемотки итератора, оберните его в
<classname>NoRewindIterator</classname>.
</simpara>
</note>
</refsect1>

14
reference/curl/functions/curl-close.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ce98b568f85353c4bf263133f09c4db9294833f9 Maintainer: shein Status: ready -->
<!-- EN-Revision: 86c8ebd19ed93843f293bdcecc9ce68cb4ab57bc Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.curl-close" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -52,6 +52,18 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Функция объявлена устаревшей.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Функция теперь является <acronym>NOP</acronym>.
</entry>
</row>
&curl.changelog.handle-param;
</tbody>
</tgroup>

5
reference/datetime/constants.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 130701dd4e64351d38da565ab3043a8f795698f8 Maintainer: tmn Status: ready -->
<!-- EN-Revision: 6bbb5b9685d27ac9df744702e06525047a163d4b Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<appendix xml:id="datetime.constants" xmlns="http://docbook.org/ns/docbook">
&reftitle.constants;
@@ -68,6 +68,7 @@
<listitem>
<simpara>
Дата и время в формате Atom (пример: <literal>2005-08-15T15:52:01+00:00</literal>).
совместимо с ISO-8601, RFC 3399 и XML Schema.
</simpara>
</listitem>
</varlistentry>
@@ -92,7 +93,7 @@
</term>
<listitem>
<simpara>
Дата и время в формате стандарта ISO-8601 (пример: <literal>2005-08-15T15:52:01+0000</literal>).
Дата и время в ISO-8601-подобном формате (пример: <literal>2005-08-15T15:52:01+0000</literal>).
</simpara>
<note>
<simpara>

4
reference/datetime/datetimeimmutable/createfromformat.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cafec7df4c6ba597b5ac45b03191aea18f3cabab Maintainer: shein Status: ready -->
<!-- EN-Revision: f5e51d56b0a4dd7e70dd47ea7eb3c07fdc207ddd Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="datetimeimmutable.createfromformat" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -383,7 +383,7 @@
«секунда», «милли-» или «микросекунда» и «часовой пояс»
до начальных значений Unix-эпохи: <literal>0</literal> для часа, минуты и секунды,
<literal>1</literal> для месяца и дня, <literal>1970</literal> для года
и <literal>UTC</literal> для информации о часовом поясе
и часового пояса по умолчанию
</entry>
<entry>
Без символа <literal>!</literal> метод установит полям

42
reference/intl/locale/canonicalize.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 1976eae0d815797af97a1e16c5cd90ffc2868395 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 14a6825b9b50f0ee22f19b3fce82ced1c866ca57 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="locale.canonicalize" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -14,11 +14,18 @@
<modifier>public</modifier> <modifier>static</modifier> <type class="union"><type>string</type><type>null</type></type><methodname>Locale::canonicalize</methodname>
<methodparam><type>string</type><parameter>locale</parameter></methodparam>
</methodsynopsis>
<para>
</para>
&warn.undocumented.func;
<simpara>
Канонизирует переданную строку локали в формат ICU.
</simpara>
<simpara>
Метод может не указывать или возвращать действительную локаль.
Это лишь версия входных данных, которая была канонизирована в соответствии с правилами ICU.
</simpara>
<simpara>
Поведение метода зависит от версии ICU,
используемой PHP (<constant>INTL_ICU_VERSION</constant>).
</simpara>
</refsect1>
@@ -28,9 +35,9 @@
<varlistentry>
<term><parameter>locale</parameter></term>
<listitem>
<para>
</para>
<simpara>
Оригинальная строка локализации.
</simpara>
</listitem>
</varlistentry>
</variablelist>
@@ -44,6 +51,25 @@
&intl.locale-len.return;
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример использования функции <function>locale_canonicalize</function></title>
<programlisting role="php">
<![CDATA[
echo Locale::canonicalize('en-US.utf8') . "\n";
echo Locale::canonicalize('totally-not-valid') . "\n";
]]>
</programlisting>
</example>
&example.outputs.similar;
<screen>
<![CDATA[
en_US
totally_NOT_VALID
]]>
</screen>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file

11
reference/json/setup.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: irker Status: ready -->
<!-- EN-Revision: 2b5015d025e2b72b2a4dd894323961626872cac7 Maintainer: irker Status: ready -->
<!-- Reviewed: no -->
<chapter xml:id="json.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
@@ -7,14 +7,11 @@
<section xml:id="json.installation">
&reftitle.install;
<para>
Модуль JSON включается и компилируется в PHP по умолчанию.
Модуль JSON является встроенным модулем PHP, поэтому он всегда включён.
</para>
<para>
Начиная с PHP 8.0.0 модуль JSON включили в ядро PHP, поэтому модуль не требуется включать и нельзя отключить.
</para>
<para>
&pecl.info;
<link xlink:href="&url.pecl.package;json">&url.pecl.package;json</link>
До PHP 8.0.0 модуль JSON был включён в состав PHP и скомпилирован по умолчанию,
но его можно было явно отключить с помощью <option role="configure">--disable-json</option>.
</para>
</section>

13
reference/ldap/functions/ldap-get-option.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 3ec3fa6848aae4b4535557105a42fbf8d57dcc07 Maintainer: mch Status: ready -->
<!-- EN-Revision: aa120f36c5762e99f9ee121d8caf910e0a67121e Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.ldap-get-option" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -11,7 +11,7 @@
&reftitle.description;
<methodsynopsis>
<type>bool</type><methodname>ldap_get_option</methodname>
<methodparam><type>LDAP\Connection</type><parameter>ldap</parameter></methodparam>
<methodparam><type class="union"><type>LDAP\Connection</type><type>null</type></type><parameter>ldap</parameter></methodparam>
<methodparam><type>int</type><parameter>option</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>array</type><type>string</type><type>int</type></type><parameter role="reference">value</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
@@ -28,7 +28,8 @@
<term><parameter>ldap</parameter></term>
<listitem>
<para>
&ldap.parameter.ldap;
Либо экземпляр <classname>LDAP\Connection</classname>, возвращаемый функцией <function>ldap_connect</function>,
для получения опции для этого соединения, либо &null; для получения глобальной опции.
</para>
</listitem>
</varlistentry>
@@ -243,6 +244,12 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Параметр <parameter>ldap</parameter> теперь допускает значение &null;.
</entry>
</row>
&ldap.changelog.ldap-object;
</tbody>
</tgroup>

7
reference/opcache/functions/opcache-is-script-cached.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 87d6bb1bbd5f118f5b0cf0160438f06c0f91ea45 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 3c36a56c9e6875fbe3295827a15747d6eae9572e Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.opcache-is-script-cached">
<refnamediv>
@@ -17,6 +17,8 @@
Функция проверяет, закеширован ли указанный скрипт в OPCache.
Может быть использована для определения, прогрет ли кеш для конкретного скрипта.
Функция проверяет только кеш в памяти, не проверяя файловый кеш.
Для проверки файлового кеша используйте функцию
<function>opcache_is_script_cached_in_file_cache</function>.
</simpara>
</refsect1>
@@ -37,7 +39,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Возвращает &true;, если <parameter>filename</parameter> закеширован в OPCache,
Возвращает &true;, если <parameter>filename</parameter> закеширован в OPCache в памяти,
&false; если нет.
</simpara>
</refsect1>
@@ -46,6 +48,7 @@
&reftitle.seealso;
<simplelist>
<member><function>opcache_compile_file</function></member>
<member><function>opcache_is_script_cached_in_file_cache</function></member>
</simplelist>
</refsect1>
</refentry>

15
reference/pgsql/functions/pg-copy-from.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: c2eca73ef79ebe78cebb34053e41b565af504c4f Maintainer: aur Status: ready -->
<!-- EN-Revision: aa120f36c5762e99f9ee121d8caf910e0a67121e Maintainer: aur Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.pg-copy-from" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -15,7 +15,7 @@
<type>bool</type><methodname>pg_copy_from</methodname>
<methodparam><type>PgSql\Connection</type><parameter>connection</parameter></methodparam>
<methodparam><type>string</type><parameter>table_name</parameter></methodparam>
<methodparam><type>array</type><parameter>rows</parameter></methodparam>
<methodparam><type class="union"><type>array</type><type>Traversable</type></type><parameter>rows</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>separator</parameter><initializer>"\t"</initializer></methodparam>
<methodparam choice="opt"><type>string</type><parameter>null_as</parameter><initializer>"\\\\N"</initializer></methodparam>
</methodsynopsis>
@@ -47,9 +47,9 @@
<term><parameter>rows</parameter></term>
<listitem>
<para>
Массив (<type>array</type>) данных для копирования в <parameter>table_name</parameter>.
Итерируемое значение (<type>iterable</type>) данных для копирования в <parameter>table_name</parameter>.
Каждое значение в <parameter>rows</parameter> становится строкой в <parameter>table_name</parameter>.
Каждое значение массива <parameter>rows</parameter> должно быть строкой с разделителем, содержащей
Каждое значение должно быть строкой с разделителем, содержащей
значения для вставки в каждое поле таблицы. Значения должны заканчиваться символом перевода строки.
</para>
</listitem>
@@ -94,6 +94,13 @@
</row>
</thead>
<tbody>
<row>
<entry>8.5.0</entry>
<entry>
Значение параметра <parameter>rows</parameter> теперь является итерируемым значением (<type>iterable</type>).
Ранее оно было массивом (<type>array</type>).
</entry>
</row>
&pgsql.changelog.connection-object;
</tbody>
</tgroup>

22
reference/phar/Phar.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 18900b16944d69c38808c42d30f7150e83faec0d Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 2b232242b1c4a99e689f79bd47735008c5009840 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<reference xml:id="class.phar" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">
<title>Класс Phar</title>
@@ -172,10 +172,30 @@
Добавлена поддержка модуля меток времени эпохи Unix для архивов на основе Zip.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Метаданные больше не десериализуются при открытии архива,
а откладываются до вызова метода <methodname>Phar::getMetadata</methodname>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</section>
<section role="notes">
&reftitle.notes;
<caution>
<simpara>
До PHP 8.0.0 метаданные десериализовались при открытии архива,
что могло привести к уязвимостям в безопасности.
Начиная с PHP 8.0.0, метаданные десериализуются только при вызове
метода <methodname>Phar::getMetadata</methodname>, у которого есть
опции для ограничения десериализации из соображений безопасности.
</simpara>
</caution>
</section>
</partintro>
&reference.phar.entities.Phar;