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

Update 9b1673cf114a1e10c4563ab9223cb56aed552b89 to En (#1009)

Browse Source 
* Update date-sunrise.xml

* Update date-sunset.xml

* Update date-sunrise.xml

* Update gmstrftime.xml

* Update strftime.xml

* Update strptime.xml

* Update enchant-broker-free-dict.xml

* Update enchant-broker-free.xml

* Update enchant-broker-get-dict-path.xml

* Update enchant-broker-set-dict-path.xml

* Update libxml-disable-entity-loader.xml

* Update mhash-count.xml

* Update mhash-get-block-size.xml

* Update mhash-get-hash-name.xml

* Update mhash-keygen-s2k.xml

* Update mhash.xml

* Update get-client-info.xml

* Update init.xml

* Update kill.xml

* Update ping.xml

* Update refresh.xml

* Update openssl-free-key.xml

* Update openssl-pkey-free.xml

* Update openssl-x509-free.xml

* Update lcg-value.xml

* Update isdisabled.xml

* Update getclass.xml

* Update isarray.xml

* Update isarray.xml amend the code example

* Update iscallable.xml

* Update shmop-close.xml

* Update shmop-close.xml Add the missing block

* Update wakeup.xml

* Update utf8-decode.xml

* Update utf8-decode.xml

* Update utf8-encode.xml

* Update utf8-decode.xml

* Update odbc-result-all.xml

* Update xml-set-object.xml

* Update zip-close.xml

* Update zip-entry-close.xml

* Update zip-entry-compressedsize.xml

* Update zip-entry-compressionmethod.xml

* Update zip-entry-filesize.xml

* Update zip-entry-name.xml

* Update zip-entry-open.xml

* Update zip-entry-read.xml

* Update zip-open.xml

* Update zip-read.xml
This commit is contained in:
Mikhail Alferov
2024-12-02 07:09:11 +03:00
committed by GitHub
parent 59501b0cac
commit d96db32b2d
44 changed files with 765 additions and 510 deletions
Download Patch File Download Diff File Expand all files Collapse all files

82
reference/datetime/functions/date-sunrise.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5c951013ca04161992efed8b86fb40f55669958e Maintainer: tmn Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.date-sunrise" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -12,9 +12,9 @@
<refsynopsisdiv>
<warning>
<para>
Функция <emphasis>УСТАРЕЛА</emphasis>, начиная с PHP 8.1.0.
Полагаться на эту функцию крайне не рекомендуется. Используйте
вместо неё функцию <function>date_sun_info</function>.
Начиная с PHP 8.1.0 функция <emphasis>УСТАРЕЛА</emphasis>.
Разработчики языка настоятельно не рекомендуют полагаться на функцию.
Вместо неё лучше пользоваться функцией <function>date_sun_info</function>.
</para>
</warning>
</refsynopsisdiv>
@@ -22,6 +22,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>int</type><type>float</type><type>false</type></type><methodname>date_sunrise</methodname>
<methodparam><type>int</type><parameter>timestamp</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>returnFormat</parameter><initializer><constant>SUNFUNCS_RET_STRING</constant></initializer></methodparam>
@@ -31,9 +32,9 @@
<methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>utcOffset</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>date_sunrise</function> возвращает время рассвета для
определённых дня (заданного аргументом <parameter>timestamp</parameter>)
и местоположения.
Функция <function>date_sunrise</function> возвращает время рассвета
для дня, который указали в аргументе <parameter>timestamp</parameter>,
и расположения.
</para>
</refsect1>
@@ -45,8 +46,8 @@
<term><parameter>timestamp</parameter></term>
<listitem>
<para>
Временная метка (<parameter>timestamp</parameter>) дня, для которого
определяется время рассвета.
Параметр <parameter>timestamp</parameter> принимает метку времени дня,
для которого берётся время рассвета.
</para>
</listitem>
</varlistentry>
@@ -55,35 +56,34 @@
<listitem>
<para>
<table>
<title>&Constants; <parameter>returnFormat</parameter></title>
<title>&Constants;, которые принимает параметр <parameter>returnFormat</parameter></title>
<tgroup cols="2">
<thead>
<row>
<entry>константа</entry>
<entry>описание</entry>
<entry>пример</entry>
<entry>Константа</entry>
<entry>Описание</entry>
<entry>Пример</entry>
</row>
</thead>
<tbody>
<row>
<entry>SUNFUNCS_RET_STRING</entry>
<entry>
тип возвращаемого результата <type>string</type>
Возвращает результат в виде значения с типом <type>string</type>
</entry>
<entry>16:46</entry>
</row>
<row>
<entry>SUNFUNCS_RET_DOUBLE</entry>
<entry>
тип возвращаемого результата <type>float</type>
Возвращает результат в виде значения с типом <type>float</type>
</entry>
<entry>16.78243132</entry>
</row>
<row>
<entry>SUNFUNCS_RET_TIMESTAMP</entry>
<entry>
тип возвращаемого результата <type>int</type>
(временная метка)
Возвращает метку времени в виде значения с типом <type>int</type>
</entry>
<entry>1095034606</entry>
</row>
@@ -97,8 +97,8 @@
<term><parameter>latitude</parameter></term>
<listitem>
<para>
По умолчанию в Северном полушарии, для Южного передаётся
отрицательная величина. Смотрите также
Значение по умолчанию — Северное полушарие, для Южного передаётся
отрицательное значение. Смотрите также описание директивы
<link linkend="ini.date.default-latitude">date.default_latitude</link>.
</para>
</listitem>
@@ -107,8 +107,8 @@
<term><parameter>longitude</parameter></term>
<listitem>
<para>
По умолчанию восточная, для указания западной долготы
передаётся отрицательная величина. Смотрите также
Значение по умолчанию — восточная долгота, для западной передаётся
отрицательное значение. Смотрите также описание директивы
<link linkend="ini.date.default-longitude">date.default_longitude</link>.
</para>
</listitem>
@@ -117,11 +117,11 @@
<term><parameter>zenith</parameter></term>
<listitem>
<para>
<parameter>zenith</parameter> - это угол между центром Солнца и линией,
перпендикулярной поверхности Земли. По умолчанию
<link linkend="ini.date.sunrise-zenith">date.sunrise_zenith</link>
Параметр <parameter>zenith</parameter> устанавливает угол между центром Солнца и линией,
перпендикулярной поверхности Земли. По умолчанию параметр берёт значение директивы
<link linkend="ini.date.sunrise-zenith">date.sunrise_zenith</link>.
<table>
<title>Распространённые углы <parameter>zenith</parameter> angles</title>
<title>Распространённые углы зенита <parameter>zenith</parameter></title>
<tgroup cols="2">
<thead>
<row>
@@ -132,11 +132,11 @@
<tbody>
<row>
<entry>90°50'</entry>
<entry>Восход солнца: точка, где Солнце становится видимым.</entry>
<entry>Восход солнца: точка, в которой солнце становится видимым.</entry>
</row>
<row>
<entry>96°</entry>
<entry>Гражданские сумерки: обычно используются для обозначения начала рассвета.</entry>
<entry>Гражданские сумерки: традиционно обозначает начало рассвета.</entry>
</row>
<row>
<entry>102°</entry>
@@ -144,7 +144,7 @@
</row>
<row>
<entry>108°</entry>
<entry>Астрономические сумерки: точка, в которой Солнце начинает быть источником любого освещения.</entry>
<entry>Астрономические сумерки: момент, когда солнце становится источником освещения.</entry>
</row>
</tbody>
</tgroup>
@@ -157,9 +157,9 @@
<listitem>
<para>
Задаётся в часах.
<parameter>utcOffset</parameter> игнорируется, если
<parameter>returnFormat</parameter> -
<constant>SUNFUNCS_RET_TIMESTAMP</constant>
Функция игнорирует параметр <parameter>utcOffset</parameter>,
если значение параметра <parameter>returnFormat</parameter>
равно значению константы <constant>SUNFUNCS_RET_TIMESTAMP</constant>.
</para>
</listitem>
</varlistentry>
@@ -170,8 +170,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает время восхода солнца в заданном формате
<parameter>returnFormat</parameter>&return.falseforfailure;. Одна из возможных причин неудачного выполнения - солнце не поднимается над горизонтом вообще, что происходит внутри полярных кругов в течение части года.
Функция возвращает время восхода солнца в формате, который определили в параметре
<parameter>returnFormat</parameter>, если завершилась успешно,&return.falseforfailure;.
Функция завершится неудачно, если солнце вообще не поднимается над горизонтом,
что бывает внутри полярных кругов в течение части года.
</para>
</refsect1>
@@ -197,14 +199,14 @@
<row>
<entry>8.1.0</entry>
<entry>
Функция объявлена устаревшей, используйте вместе неё <function>date_sun_info</function>.
Функция устарела, пользуйтесь вместе неё функцию <function>date_sun_info</function>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>latitude</parameter>, <parameter>longitude</parameter>,
<parameter>zenith</parameter> и <parameter>utcOffset</parameter> теперь допускают значение null.
Параметры <parameter>latitude</parameter>, <parameter>longitude</parameter>,
<parameter>zenith</parameter> и <parameter>utcOffset</parameter> теперь принимают значение &null;.
</entry>
</row>
</tbody>
@@ -217,12 +219,12 @@
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>date_sunrise</function></title>
<title>Пример получения времени рассвета функцией <function>date_sunrise</function></title>
<programlisting role="php">
<![CDATA[
<?php
/* расчёт времени восхода солнца в Лиссабоне, Португалия
/* Расчёт времени восхода солнца в Лиссабоне, Португалия
Latitude: 38.4 North
Longitude: 9 West
Zenith ~= 90
@@ -242,12 +244,14 @@ Mon Dec 20 2004, время восхода солнца : 08:54
</screen>
</example>
<example>
<title>Нет восхода солнца</title>
<title>Пример работы функции для времени и расположения, при которых солнце не восходит</title>
<programlisting role="php">
<![CDATA[
<?php
$solstice = strtotime('2017-12-21');
var_dump(date_sunrise($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222));
?>
]]>
</programlisting>

93
reference/datetime/functions/date-sunset.xml
View File

@@ -1,20 +1,20 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5c951013ca04161992efed8b86fb40f55669958e Maintainer: tmn Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.date-sunset" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>date_sunset</refname>
<refpurpose>
Возвращает время захода солнца для заданных дня и местоположения
Возвращает время захода солнца для заданных дня и расположения
</refpurpose>
</refnamediv>
<refsynopsisdiv>
<warning>
<para>
Функция <emphasis>УСТАРЕЛА</emphasis>, начиная с PHP 8.1.0.
Полагаться на эту функцию крайне не рекомендуется. Используйте
вместо неё функцию <function>date_sun_info</function>.
Начиная с PHP 8.1.0 функция <emphasis>УСТАРЕЛА</emphasis>.
Разработчики языка настоятельно не рекомендуют полагаться на функцию.
Вместо неё лучше пользоваться функцией <function>date_sun_info</function>.
</para>
</warning>
</refsynopsisdiv>
@@ -22,6 +22,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>int</type><type>float</type><type>false</type></type><methodname>date_sunset</methodname>
<methodparam><type>int</type><parameter>timestamp</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>returnFormat</parameter><initializer><constant>SUNFUNCS_RET_STRING</constant></initializer></methodparam>
@@ -31,9 +32,9 @@
<methodparam choice="opt"><type class="union"><type>float</type><type>null</type></type><parameter>utcOffset</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>date_sunset</function> возвращает время захода солнца для
определённых дня (заданного аргументом <parameter>timestamp</parameter>)
и местоположения.
Функция <function>date_sunset</function> возвращает время захода солнца
для дня, который указали в аргументе <parameter>timestamp</parameter>,
и расположения.
</para>
</refsect1>
@@ -47,8 +48,8 @@
</term>
<listitem>
<para>
Временная метка (<parameter>timestamp</parameter>) дня, для которого
определяется время захода солнца.
Параметр <parameter>timestamp</parameter> принимает метку времени дня,
для которого берётся время захода солнца.
</para>
</listitem>
</varlistentry>
@@ -59,40 +60,34 @@
<listitem>
<para>
<table>
<title>Константы
<parameter>returnFormat</parameter>
</title>
<title>&Constants;, которые принимает параметр <parameter>returnFormat</parameter></title>
<tgroup cols="2">
<thead>
<row>
<entry>константа</entry>
<entry>описание</entry>
<entry>пример</entry>
<entry>Константа</entry>
<entry>Описание</entry>
<entry>Пример</entry>
</row>
</thead>
<tbody>
<row>
<entry>SUNFUNCS_RET_STRING</entry>
<entry>
тип возвращаемого результата
<type>string</type>
Возвращает результат в виде значения с типом <type>string</type>
</entry>
<entry>16:46</entry>
</row>
<row>
<entry>SUNFUNCS_RET_DOUBLE</entry>
<entry>
тип возвращаемого результата
<type>float</type>
Возвращает результат в виде значения с типом <type>float</type>
</entry>
<entry>16.78243132</entry>
</row>
<row>
<entry>SUNFUNCS_RET_TIMESTAMP</entry>
<entry>
тип возвращаемого результата
<type>int</type>
(временная метка)
Возвращает метку времени в виде значения с типом <type>int</type>
</entry>
<entry>1095034606</entry>
</row>
@@ -108,8 +103,8 @@
</term>
<listitem>
<para>
По умолчанию в Северном полушарии, для Южного передаётся
отрицательная величина. Смотрите также
Значение по умолчанию — Северное полушарие, для Южного передаётся
отрицательное значение. Смотрите также описание директивы
<link linkend="ini.date.default-latitude">date.default_latitude</link>.
</para>
</listitem>
@@ -120,8 +115,8 @@
</term>
<listitem>
<para>
По умолчанию восточная, для указания западной долготы
передаётся отрицательная величина. Смотрите также
Значение по умолчанию — восточная долгота, для западной передаётся
отрицательное значение. Смотрите также описание директивы
<link linkend="ini.date.default-longitude">date.default_longitude</link>.
</para>
</listitem>
@@ -132,14 +127,11 @@
</term>
<listitem>
<para>
<parameter>zenith</parameter>
- это угол между центром Солнца и линией,
перпендикулярной поверхности Земли. По умолчанию
<link linkend="ini.date.sunset-zenith">date.sunset_zenith</link>
Параметр <parameter>zenith</parameter> устанавливает угол между центром Солнца и линией,
перпендикулярной поверхности Земли. По умолчанию параметр берёт значение директивы
<link linkend="ini.date.sunrise-zenith">date.sunrise_zenith</link>.
<table>
<title>Распространённые углы
<parameter>zenith</parameter>
</title>
<title>Распространённые углы зенита <parameter>zenith</parameter></title>
<tgroup cols="2">
<thead>
<row>
@@ -150,11 +142,11 @@
<tbody>
<row>
<entry>90°50'</entry>
<entry>Восход солнца: точка, где Солнце становится невидимым.</entry>
<entry>Восход солнца: точка, в которой солнце становится невидимым.</entry>
</row>
<row>
<entry>96°</entry>
<entry>Гражданские сумерки: обычно используются для обозначения конца заката.</entry>
<entry>Гражданские сумерки: традиционно обозначает окончание заката.</entry>
</row>
<row>
<entry>102°</entry>
@@ -162,7 +154,7 @@
</row>
<row>
<entry>108°</entry>
<entry>Астрономические сумерки: точка, в которой Солнце заканчивает быть источником любого освещения.</entry>
<entry>Астрономические сумерки: момент, в которой солнце перестаёт быть источником освещения.</entry>
</row>
</tbody>
</tgroup>
@@ -177,10 +169,9 @@
<listitem>
<para>
Задаётся в часах.
<parameter>utcOffset</parameter>
игнорируется, если
<parameter>returnFormat</parameter>
- <constant>SUNFUNCS_RET_TIMESTAMP</constant>.
Функция игнорирует параметр <parameter>utcOffset</parameter>,
если значение параметра <parameter>returnFormat</parameter>
равно значению константы <constant>SUNFUNCS_RET_TIMESTAMP</constant>.
</para>
</listitem>
</varlistentry>
@@ -191,8 +182,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает время захода солнца в заданном формате
<parameter>returnFormat</parameter>&return.falseforfailure;. Одна из возможных причин неудачного выполнения - солнце не поднимается над горизонтом вообще, что происходит внутри полярных кругов в течение части года.
Функция возвращает время захода солнца в формате, который определили в параметре
<parameter>returnFormat</parameter>, если завершилась успешно,&return.falseforfailure;.
Функция завершится неудачно, если солнце вообще не заходит,
что бывает внутри полярных кругов в течение части года.
</para>
</refsect1>
@@ -218,14 +211,14 @@
<row>
<entry>8.1.0</entry>
<entry>
Функция объявлена устаревшей, используйте вместе неё <function>date_sun_info</function>.
Функция устарела, пользуйтесь вместе неё функцию <function>date_sun_info</function>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>latitude</parameter>, <parameter>longitude</parameter>,
<parameter>zenith</parameter> и <parameter>utcOffset</parameter> теперь допускают значение null.
Параметры <parameter>latitude</parameter>, <parameter>longitude</parameter>,
<parameter>zenith</parameter> и <parameter>utcOffset</parameter> теперь принимают значение &null;.
</entry>
</row>
</tbody>
@@ -238,12 +231,12 @@
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>date_sunset</function></title>
<title>Пример получения времени заката функцией <function>date_sunset</function></title>
<programlisting role="php">
<![CDATA[
<?php
/* calculate the sunset time for Lisbon, Portugal
/* Расчёт времени захода солнца в Лиссабоне, Португалия
Latitude: 38.4 North
Longitude: 9 West
Zenith ~= 90
@@ -263,12 +256,14 @@ Mon Dec 20 2004, время захода солнца : 18:13
</screen>
</example>
<example>
<title>Нет заката</title>
<title>Пример работы функции для времени и расположения, при которых солнце не заходит</title>
<programlisting role="php">
<![CDATA[
<?php
$solstice = strtotime('2017-12-21');
var_dump(date_sunset($solstice, SUNFUNCS_RET_STRING, 69.245833, -53.537222));
?>
]]>
</programlisting>

42
reference/datetime/functions/gmstrftime.xml
View File

@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5c951013ca04161992efed8b86fb40f55669958e Maintainer: shein Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.gmstrftime" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>gmstrftime</refname>
<refpurpose>Форматирует дату/время по Гринвичу с учётом текущей локали</refpurpose>
<refpurpose>Форматирует дату и время по Гринвичу с учётом текущей локали</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -18,22 +18,23 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>false</type></type><methodname>gmstrftime</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Эта функция идентична функции <function>strftime</function> за
исключением того, что возвращает время по Гринвичу (GMT). Например,
при запуске на системе, где установлено Eastern Standard Time (GMT-0500),
первая строка из примера ниже выведет "Dec 31 1998 20:00:00",
тогда как вторая - "Jan 01 1999 01:00:00".
Функция идентична функции <function>strftime</function>,
за исключением того, что возвращает время по Гринвичу (GMT). Например,
при запуске в системе, в которой установили часовой пояс Eastern Standard Time (GMT-0500),
первая строка из приведённого примера выведет "Dec 31 1998 20:00:00",
а вторая — "Jan 01 1999 01:00:00".
</para>
<warning>
<para>
Функция зависит от информации о локали операционной системы, которая может быть
несовместима друг с другом или вообще отсутствовать.
Вместо этой функции используйте метод <methodname>IntlDateFormatter::format</methodname>.
Функция зависит от региональных настроек операционной системы, которые иногда
несовместимы друг с другом или вообще недоступны.
Вместо этой функции лучше пользоваться методом <methodname>IntlDateFormatter::format</methodname>.
</para>
</warning>
</refsect1>
@@ -58,13 +59,13 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает строку, отформатированную согласно указанному формату
и с использованием временной метки из параметра <parameter>timestamp</parameter>
или текущего локального времени, если временная метка не была
указана. Названия месяцев, дней недели и других языкозависимых строк
будут показаны с учётом настроек текущей локали, установленных
с помощью функции <function>setlocale</function>.
В случае возникновения ошибки возвращает &false;.
Функция возвращает строку, которую отформатировала с учётом строки формата
и метки времени, которую передали в аргументе <parameter>timestamp</parameter>,
или текущего локального времени, если временную метку
не указали. Названия месяцев, дней недели и других языкозависимых строк
отобразятся с учётом настроек текущей локали, которую установили
функцией <function>setlocale</function>.
Функция возвращает &false;, если возникла ошибка.
</para>
</refsect1>
@@ -83,7 +84,7 @@
<row>
<entry>8.0.0</entry>
<entry>
<parameter>timestamp</parameter> теперь допускает значение null.
Параметр <parameter>timestamp</parameter> теперь принимает значение &null;.
</entry>
</row>
</tbody>
@@ -96,13 +97,16 @@
&reftitle.examples;
<para>
<example>
<title>Пример использования функции <function>gmstrftime</function></title>
<title>Пример форматирования даты и времени по Гринвичу функцией <function>gmstrftime</function></title>
<programlisting role="php">
<![CDATA[
<?php
setlocale(LC_TIME, 'en_US');
echo strftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n";
echo gmstrftime("%b %d %Y %H:%M:%S", mktime(20, 0, 0, 12, 31, 98)) . "\n";
?>
]]>
</programlisting>

5
reference/datetime/functions/strftime.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b93836ce6f7350932d11e784b793065fd2598e50 Maintainer: shein Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: shein Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.strftime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -18,6 +18,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>false</type></type><methodname>strftime</methodname>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>int</type><type>null</type></type><parameter>timestamp</parameter><initializer>&null;</initializer></methodparam>
@@ -51,7 +52,7 @@
<listitem>
<para>
<table>
<title>Строка параметра <parameter>format</parameter> распознаёт следующие символы</title>
<title>В строке параметра <parameter>format</parameter> распознаются следующие символы</title>
<tgroup cols="3">
<thead>
<row>

71
reference/datetime/functions/strptime.xml
View File

@@ -1,12 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 5c951013ca04161992efed8b86fb40f55669958e Maintainer: tmn Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.strptime" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>strptime</refname>
<refpurpose>
Разбирает строку даты/времени, сгенерированную функцией
<function>strftime</function>
Разбирает строку даты и времени, которую сгенерировала функция <function>strftime</function>
</refpurpose>
</refnamediv>
@@ -17,18 +16,19 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>array</type><type>false</type></type><methodname>strptime</methodname>
<methodparam><type>string</type><parameter>timestamp</parameter></methodparam>
<methodparam><type>string</type><parameter>format</parameter></methodparam>
</methodsynopsis>
<para>
<function>strptime</function> возвращает массив с данными разбора
строки <parameter>timestamp</parameter>, либо &false; в случае возникновения ошибки.
Функция <function>strptime</function> возвращает массив с данными разбора
строки <parameter>timestamp</parameter>, или &false;, если возникла ошибка.
</para>
<para>
Названия месяцев и недель, а также другие названия, зависящие от
языка, соответствуют текущим настройкам местоположения, установленным
посредством <function>setlocale</function> (<constant>LC_TIME</constant>).
Названия месяцев и дней недели, и другие строки, которые зависят
от языка, соответствуют текущим региональным настройкам, которые установили
функцией <function>setlocale</function> (см. описание константы <constant>LC_TIME</constant>).
</para>
</refsect1>
@@ -40,8 +40,8 @@
<term><parameter>timestamp</parameter> (<type>string</type>)</term>
<listitem>
<para>
Строка для разбора (например, строковый результат выполнения функции
<function>strftime</function>).
Строка наподобие той, которую возвращает функция <function>strftime</function>
и которую требуется разобрать.
</para>
</listitem>
</varlistentry>
@@ -49,17 +49,16 @@
<term><parameter>format</parameter> (<type>string</type>)</term>
<listitem>
<para>
Формат строки <parameter>timestamp</parameter> (например, формат,
используемый в функции <function>strftime</function>). Следует
обратить внимание на тот факт, что не все возможности форматирования
используемые в <function>strftime</function> будут обрабатываться в
<function>strptime</function>; набор поддерживаемых символов
форматирования зависит от ОС и используемой С-библиотеки.
Формат строки <parameter>timestamp</parameter> наподобие того,
с которым работает функция <function>strftime</function>. Обратите внимание,
отдельные параметры форматирования, которые доступны функции
<function>strftime</function>, не влияют на форматирование
функцией <function>strptime</function>; набор поддерживаемых символов
форматирования зависит от ОС и С-библиотеки.
</para>
<para>
За дополнительной информацией о возможностях форматирования
обращайтесь на страницу описания функции
<function>strftime</function>.
Подробнее о параметрах форматирования
рассказывает описание функции <function>strftime</function>.
</para>
</listitem>
</varlistentry>
@@ -70,13 +69,13 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает массив&return.falseforfailure;.
Функция возвращает массив&return.falseforfailure;.
</para>
<para>
<table>
<title>
Список элементов возвращаемого массива
Список элементов, которые возвращаются в массиве
</title>
<tgroup cols="2">
<thead>
@@ -127,8 +126,8 @@
<row>
<entry><literal>"unparsed"</literal></entry>
<entry>
Часть <parameter>timestamp</parameter>, которую не удалось
распознать в соответствии с <parameter>format</parameter>
Часть метки <parameter>timestamp</parameter>, которую не удалось
распознать в строке формата <parameter>format</parameter>
</entry>
</row>
</tbody>
@@ -153,9 +152,10 @@
<row>
<entry>8.1.0</entry>
<entry>
Функция объявлена устаревшей.
Вместо неё используйте <function>date_parse_from_format</function> (для синтаксического анализа, не зависящего от языкового стандарта)
или <methodname>IntlDateFormatter::parse</methodname> (для синтаксического анализа, зависящего от языкового стандарта).
Функция устарела.
Вместо неё рекомендуют пользоваться функцией <function>date_parse_from_format</function>,
чтобы разобрать дату и время независимо от региональных настроек,
или методом <methodname>IntlDateFormatter::parse</methodname>, чтобы разбор зависел от локали.
</entry>
</row>
</tbody>
@@ -168,16 +168,18 @@
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>strptime</function></title>
<title>Пример разбора даты и времени функцией <function>strptime</function></title>
<programlisting role="php">
<![CDATA[
<?php
$format = '%d/%m/%Y %H:%M:%S';
$strf = strftime($format);
echo "$strf\n";
print_r(strptime($strf, $format));
?>
]]>
</programlisting>
@@ -209,18 +211,17 @@ Array
&note.no-windows;
<note>
<para>
В действительности эта функция вызывает библиотечную функцию
<literal>strptime()</literal>. В различных ОС поведение функции
может сильно различаться. Функция <function>date_parse_from_format</function>
лишена этого недостатка и рекомендована к использованию.
Внутренне эта функция вызывает функцию <literal>strptime()</literal>
системной библиотеки на языке C. Поведение функции в одной операционной системе
иногда значительно отличается от поведения в другой. Функция <function>date_parse_from_format</function>
лишена этого недостатка, поэтому рекомендуют вызывать её.
</para>
</note>
<note>
<para>
<literal>"tm_sec"</literal> включает несколько секунд високосного года
(на данный момент до 2-х в год). Для получения дополнительной информации
о високосных секундах читайте <link
xlink:href="&url.wiki.leap-seconds;">статью на википедии</link>.
Элемент <literal>"tm_sec"</literal> включает високосные секунды — до двух в год.
Подробнее о високосных секунды рассказывает статья
<link xlink:href="&url.wiki.leap-seconds;">о високосной секунде</link> на сайте Википедии.
</para>
</note>
</refsect1>

15
reference/enchant/functions/enchant-broker-free-dict.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 94f2c273f0bb214580b3cba17273f79e8cc2cb25 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.enchant-broker-free-dict" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,12 +14,13 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>bool</type><methodname>enchant_broker_free_dict</methodname>
<methodparam><type>EnchantDictionary</type><parameter>dictionary</parameter></methodparam>
</methodsynopsis>
<para>
Освобождает словарь.
Начиная с PHP 8.0.0, рекомендуется уничтожить объект вместо вызова этой функции.
Начиная с PHP 8.0.0 вместо вызова функции рекомендуют уничтожить объект.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -52,8 +53,14 @@
<row>
<entry>8.0.0</entry>
<entry>
<parameter>dictionary</parameter> ожидает <classname>EnchantDictionary</classname>;
Ранее ожидался ресурс (&resource;).
Функция устарела в пользу удаления объекта.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Параметр <parameter>dictionary</parameter> теперь ожидает экземпляр класса <classname>EnchantDictionary</classname>;
раньше ожидался ресурс (&resource;).
</entry>
</row>
</tbody>

13
reference/enchant/functions/enchant-broker-free.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 94f2c273f0bb214580b3cba17273f79e8cc2cb25 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.enchant-broker-free" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,12 +14,13 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>bool</type><methodname>enchant_broker_free</methodname>
<methodparam><type>EnchantBroker</type><parameter>broker</parameter></methodparam>
</methodsynopsis>
<para>
Освобождает брокера со всеми его словарями.
Начиная с PHP 8.0.0, рекомендуется уничтожить объект вместо вызова этой функции.
Функция освобождает брокера со всеми его словарями.
Начиная с PHP 8.0.0 вместо вызова функции рекомендуют уничтожить объект.
</para>
</refsect1>
@@ -50,6 +51,12 @@
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела в пользу удаления объекта.
</entry>
</row>
&enchant.changelog.broker-param;
</tbody>
</tgroup>

17
reference/enchant/functions/enchant-broker-get-dict-path.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 94f2c273f0bb214580b3cba17273f79e8cc2cb25 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.enchant-broker-get-dict-path" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,12 +14,13 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>false</type></type><methodname>enchant_broker_get_dict_path</methodname>
<methodparam><type>EnchantBroker</type><parameter>broker</parameter></methodparam>
<methodparam><type>int</type><parameter>type</parameter></methodparam>
</methodsynopsis>
<para>
Возвращает путь словаря для заданного бэкенда.
Функция возвращает путь словаря для заданного бэкенда.
</para>
</refsect1>
@@ -32,7 +33,7 @@
<term><parameter>type</parameter></term>
<listitem>
<para>
Тип словарей, т.е. <constant>ENCHANT_MYSPELL</constant>
Тип словарей — <constant>ENCHANT_MYSPELL</constant>
или <constant>ENCHANT_ISPELL</constant>.
</para>
</listitem>
@@ -44,7 +45,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает путь к директории словаря в случае успешного выполнения&return.falseforfailure;.
Функция возвращает путь к директории словаря, если выполнилась успешно,&return.falseforfailure;.
</para>
</refsect1>
@@ -59,6 +60,12 @@
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела.
</entry>
</row>
&enchant.changelog.broker-param;
</tbody>
</tgroup>
@@ -69,7 +76,7 @@
&reftitle.notes;
<note>
<para>
Функция доступна, только если модуль был скомпилирован с Enchant v1.
Функция доступна, только если модуль скомпилировали с библиотекой Enchant v1.
</para>
</note>
</refsect1>

17
reference/enchant/functions/enchant-broker-set-dict-path.xml
View File

@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 94f2c273f0bb214580b3cba17273f79e8cc2cb25 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.enchant-broker-set-dict-path" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>enchant_broker_set_dict_path</refname>
<refpurpose>Установить путь для заданного бэкенда</refpurpose>
<refpurpose>Устанавливает путь для бэкенда</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -14,13 +14,14 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>bool</type><methodname>enchant_broker_set_dict_path</methodname>
<methodparam><type>EnchantBroker</type><parameter>broker</parameter></methodparam>
<methodparam><type>int</type><parameter>type</parameter></methodparam>
<methodparam><type>string</type><parameter>path</parameter></methodparam>
</methodsynopsis>
<para>
Установить путь для заданного бэкенда.
Функция устанавливает путь для заданного бэкенда.
</para>
</refsect1>
@@ -33,7 +34,7 @@
<term><parameter>type</parameter></term>
<listitem>
<para>
Тип словарей, т.е. <constant>ENCHANT_MYSPELL</constant>
Тип словарей — <constant>ENCHANT_MYSPELL</constant>
или <constant>ENCHANT_ISPELL</constant>.
</para>
</listitem>
@@ -68,6 +69,12 @@
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела.
</entry>
</row>
&enchant.changelog.broker-param;
</tbody>
</tgroup>
@@ -78,7 +85,7 @@
&reftitle.notes;
<note>
<para>
Функция доступна, только если модуль был скомпилирован с Enchant v1.
Функция доступна, только если модуль скомпилировали с библиотекой Enchant v1.
</para>
</note>
</refsect1>

27
reference/libxml/functions/libxml-disable-entity-loader.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: eae558e584a4e5f70e5d85b5cebc59e296399924 Maintainer: tmn Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.libxml-disable-entity-loader" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -16,6 +16,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>bool</type><methodname>libxml_disable_entity_loader</methodname>
<methodparam choice="opt"><type>bool</type><parameter>disable</parameter><initializer>&true;</initializer></methodparam>
</methodsynopsis>
@@ -58,10 +59,32 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает предыдущее значение.
Функция возвращает предыдущее значение.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<!--
<refsect1 role="errors">
&reftitle.errors;

20
reference/mhash/functions/mhash-count.xml
View File

@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8a2141dcc084f72feb4e0ae2feaff3b440e5c59e Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.mhash-count" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mhash_count</refname>
<refpurpose>Получить наибольший доступный идентификатор хеша</refpurpose>
<refpurpose>Получает наибольший доступный идентификатор хеша</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -14,11 +14,12 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>int</type><methodname>mhash_count</methodname>
<void/>
</methodsynopsis>
<para>
Возвращает наибольший доступный идентификатор хеша.
Функция возвращает наибольший доступный идентификатор хеша.
</para>
</refsect1>
@@ -30,8 +31,8 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Получить наибольший доступный идентификатор хеша. Хеши нумеруются от 0 до этого
идентификатора.
Функция возвращает наибольший доступный идентификатор хеша. Хеши нумеруются от 0 до этого
идентификатора хеша.
</para>
</refsect1>
@@ -50,8 +51,9 @@
<row>
<entry>8.1.0</entry>
<entry>
Функция объявлена устаревшей.
Используйте вместо неё <link linkend="ref.hash">функции <literal>hash_*()</literal></link>.
Функция устарела.
Вместо неё рекомендуют пользоваться функциями семейства
<link linkend="ref.hash">функции <literal>hash_*()</literal></link>.
</entry>
</row>
</tbody>
@@ -74,8 +76,10 @@ $nr = mhash_count();
for ($i = 0; $i <= $nr; $i++) {
echo sprintf("Размер блока хеша %s - %d\n",
mhash_get_hash_name($i),
mhash_get_block_size($i));
mhash_get_block_size($i))
;
}
?>
]]>
</programlisting>

20
reference/mhash/functions/mhash-get-block-size.xml
View File

@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8a2141dcc084f72feb4e0ae2feaff3b440e5c59e Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.mhash-get-block-size" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mhash_get_block_size</refname>
<refpurpose>Получить размер блока для заданного хеша</refpurpose>
<refpurpose>Получает размер блока хеша</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -15,11 +15,12 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>int</type><type>false</type></type><methodname>mhash_get_block_size</methodname>
<methodparam><type>int</type><parameter>algo</parameter></methodparam>
</methodsynopsis>
<para>
Возвращает размер блока для заданного <parameter>algo</parameter>.
Функция возвращает размер блока хеша, идентификатор которого указали в аргументе <parameter>algo</parameter>.
</para>
</refsect1>
@@ -31,7 +32,7 @@
<term><parameter>algo</parameter></term>
<listitem>
<para>
Идентификатор хеша. Одна из констант <constant>MHASH_hashname</constant>.
Идентификатор хеша. Константа семейства <constant>MHASH_*</constant>.
</para>
</listitem>
</varlistentry>
@@ -42,8 +43,8 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает размер в байтах или &false;, если параметр <parameter>algo</parameter>
задан некорректно.
Функция возвращает размер в байтах или &false;, если в аргументе <parameter>algo</parameter>
передали недопустимое значение.
</para>
</refsect1>
@@ -62,8 +63,9 @@
<row>
<entry>8.1.0</entry>
<entry>
Функция объявлена устаревшей.
Используйте вместо неё <link linkend="ref.hash">функции <literal>hash_*()</literal></link>.
Функция устарела.
Вместо неё рекомендуют пользоваться функциями семейства
<link linkend="ref.hash">функции <literal>hash_*()</literal></link>.
</entry>
</row>
</tbody>
@@ -76,7 +78,7 @@
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>mhash_get_block_size</function></title>
<title>Пример получения размера блока хеша функцией <function>mhash_get_block_size</function></title>
<programlisting role="php">
<![CDATA[
<?php

18
reference/mhash/functions/mhash-get-hash-name.xml
View File

@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8a2141dcc084f72feb4e0ae2feaff3b440e5c59e Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.mhash-get-hash-name" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mhash_get_hash_name</refname>
<refpurpose>Получить имя указанного хеша</refpurpose>
<refpurpose>Получает имя хеша</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -15,11 +15,12 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>false</type></type><methodname>mhash_get_hash_name</methodname>
<methodparam><type>int</type><parameter>algo</parameter></methodparam>
</methodsynopsis>
<para>
Возвращает имя заданного <parameter>algo</parameter>.
Функция возвращает имя хеша, идентификатор которого указали в аргументе <parameter>algo</parameter>.
</para>
</refsect1>
@@ -31,7 +32,7 @@
<term><parameter>algo</parameter></term>
<listitem>
<para>
Идентификатор хеша. Одна из констант <constant>MHASH_hashname</constant>.
Идентификатор хеша. Константа семейства <constant>MHASH_*</constant>.
</para>
</listitem>
</varlistentry>
@@ -42,7 +43,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает строку с названием или &false;, если такого хеша нет.
Функция возвращает строку с названием или &false;, если такого хеша нет.
</para>
</refsect1>
@@ -61,8 +62,9 @@
<row>
<entry>8.1.0</entry>
<entry>
Функция объявлена устаревшей.
Используйте вместо неё <link linkend="ref.hash">функции <literal>hash_*()</literal></link>.
Функция устарела.
Вместо неё рекомендуют пользоваться функциями семейства
<link linkend="ref.hash">функции <literal>hash_*()</literal></link>.
</entry>
</row>
</tbody>
@@ -75,7 +77,7 @@
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>mhash_get_hash_name</function></title>
<title>Пример получения названия хеша функцией <function>mhash_get_hash_name</function></title>
<programlisting role="php">
<![CDATA[
<?php

46
reference/mhash/functions/mhash-keygen-s2k.xml
View File

@@ -1,11 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8a2141dcc084f72feb4e0ae2feaff3b440e5c59e Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="function.mhash-keygen-s2k">
<refentry xml:id="function.mhash-keygen-s2k" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>mhash_keygen_s2k</refname>
<refpurpose>Генерация ключа</refpurpose>
<refpurpose>Генерирует ключ</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -15,6 +14,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>false</type></type><methodname>mhash_keygen_s2k</methodname>
<methodparam><type>int</type><parameter>algo</parameter></methodparam>
<methodparam><type>string</type><parameter>password</parameter></methodparam>
@@ -22,19 +22,20 @@
<methodparam><type>int</type><parameter>length</parameter></methodparam>
</methodsynopsis>
<para>
Генерирует ключ в соответствии с заданным <parameter>algo</parameter> и указанным
паролем <parameter>password</parameter>.
Функция генерирует ключ в соответствии с идентификатором хеша,
который передали в аргументе <parameter>algo</parameter>,
и пользовательским паролем, который передали в аргументе <parameter>password</parameter>.
</para>
<para>
Используется алгоритм S2K с солью, как описано в документе OpenPGP
(<link xlink:href="&url.rfc;2440">RFC 2440</link>).
Для генерации ключа функция использует алгоритм Salted S2K, как описывает документ OpenPGP
<link xlink:href="&url.rfc;2440">RFC 2440</link>.
</para>
<para>
Помните, что пользовательские пароли не являются подходящими
ключами для криптографических алгоритмов, так как обычно они как минимум
набираемы на клавиатуре. Такие пароли используют только 6-7 бит (или меньше)
на символ. Так что такие пароли крайне рекомендуется предварительно преобразовывать
(например этой функцией).
Помните, что пользовательские пароли не рекомендуют использовать
как ключи в криптографических алгоритмах, поскольку пользователи часто выбирают ключи,
которые доступны для набора на клавиатуре. Такие пароли используют только 6-7 битов на символ,
а иногда меньше. Поэтому пользовательский ключ настоятельно рекомендуют
преобразовывать функциями наподобие этой.
</para>
</refsect1>
@@ -46,7 +47,7 @@
<term><parameter>algo</parameter></term>
<listitem>
<para>
Идентификатор хеша. Одна из констант <constant>MHASH_hashname</constant>.
Идентификатор хеша с которым создаётся ключ. Константа семейства <constant>MHASH_*</constant>.
</para>
</listitem>
</varlistentry>
@@ -62,11 +63,11 @@
<term><parameter>salt</parameter></term>
<listitem>
<para>
Должна быть разной и достаточно случайной для каждого создаваемого
ключа. Так как <parameter>salt</parameter> должна быть известна
при проверке ключа, то хорошей идеей будет добавить её к ключу.
Соль имеет фиксированный размер в 8 байт и будет дополнена нулями, если
заданный параметр будет короче.
Для параметра рекомендуют устанавливать разную и достаточно случайную соль для каждого ключа,
который генерирует функция. Поскольку значение соли <parameter>salt</parameter> должно быть известно
при проверке ключей, то лучше добавлять соль в начало ключа.
Длина соли фиксирована и составляет 8 байтов, функция дополнит соль нулями,
если размер значения в аргументе окажется короче.
</para>
</listitem>
</varlistentry>
@@ -85,7 +86,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает строку с ключом или &false; в случае возникновения ошибки.
Функция возвращает строку с ключом или &false;, если возникла ошибка.
</para>
</refsect1>
@@ -104,8 +105,9 @@
<row>
<entry>8.1.0</entry>
<entry>
Функция объявлена устаревшей.
Используйте вместо неё <link linkend="ref.hash">функции <literal>hash_*()</literal></link>.
Функция устарела.
Вместо неё рекомендуют пользоваться функциями семейства
<link linkend="ref.hash">функции <literal>hash_*()</literal></link>.
</entry>
</row>
</tbody>

29
reference/mhash/functions/mhash.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8a2141dcc084f72feb4e0ae2feaff3b440e5c59e Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.mhash" xmlns="http://docbook.org/ns/docbook">
@@ -15,14 +15,15 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>false</type></type><methodname>mhash</methodname>
<methodparam><type>int</type><parameter>algo</parameter></methodparam>
<methodparam><type>string</type><parameter>data</parameter></methodparam>
<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>key</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
<function>mhash</function> принимает хеш-функцию, заданную
<parameter>algo</parameter> для <parameter>data</parameter>.
Функция <function>mhash</function> применяет к данным <parameter>data</parameter>
хеш-функцию, которую указали в аргументе <parameter>algo</parameter>.
</para>
</refsect1>
@@ -34,7 +35,7 @@
<term><parameter>algo</parameter></term>
<listitem>
<para>
Идентификатор хеша. Одна из констант <constant>MHASH_hashname</constant>.
Идентификатор хеша. Константа семейства <constant>MHASH_*</constant>.
</para>
</listitem>
</varlistentry>
@@ -50,11 +51,11 @@
<term><parameter>key</parameter></term>
<listitem>
<para>
Если задано, то функция вернёт результирующий HMAC.
HMAC - это код аутентификации сообщений, использующий хеш-функции,
который зависит от указанного ключа.
Не все алгоритмы, поддерживаемые mhash, могут использоваться в
режиме HMAC.
С этим параметром вместо хеша функция вернёт HMAC-код.
HMAC — код аутентификации сообщений, который включает криптографическую хеш-функцию
и секретный ключ, или проще — дайджест сообщения, который зависит от конкретного ключа.
Не каждый алгоритм, который поддерживается функцией mhash, доступен для формирования
кода в режиме HMAC.
</para>
</listitem>
</varlistentry>
@@ -65,7 +66,8 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает строку с результирующим хешем (также называемый дайджестом) или HMAC, или &false; в случае возникновения ошибки.
Функция возвращает строку либо с хешем, или дайджестом, либо с HMAC-кодом.
Функция возвращает &false;, если возникла ошибка.
</para>
</refsect1>
@@ -84,14 +86,15 @@
<row>
<entry>8.1.0</entry>
<entry>
Функция объявлена устаревшей.
Используйте вместо неё <link linkend="ref.hash">функции <literal>hash_*()</literal></link>.
Функция устарела.
Вместо неё рекомендуют пользоваться функциями семейства
<link linkend="ref.hash">функции <literal>hash_*()</literal></link>.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>key</parameter> теперь допускает значение null.
Параметр <parameter>key</parameter> теперь принимает значение &null;.
</entry>
</row>
</tbody>

17
reference/mysqli/mysqli/get-client-info.xml
View File

@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 035c126c0393fe154bac46e2c3c489ebadce48a5 Maintainer: bfl Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: bfl Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mysqli.get-client-info" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mysqli::$client_info</refname>
<refname>mysqli::get_client_info</refname>
<refname>mysqli_get_client_info</refname>
<refpurpose>Получает информацию о клиенте MySQL</refpurpose>
<refpurpose>Получает информацию о MySQL-клиенте</refpurpose>
</refnamediv>
<refsect1 role="description">
@@ -14,6 +14,7 @@
<para>&style.oop;</para>
<fieldsynopsis><type>string</type><varname linkend="mysqli.get-client-info">mysqli-&gt;client_info</varname></fieldsynopsis>
<methodsynopsis role="mysqli">
<modifier role="attribute">#[\Deprecated]</modifier>
<modifier>public</modifier> <type>string</type><methodname>mysqli::get_client_info</methodname>
<void/>
</methodsynopsis>
@@ -23,7 +24,7 @@
<methodparam choice="opt"><type class="union"><type>mysqli</type><type>null</type></type><parameter>mysql</parameter><initializer>&null;</initializer></methodparam>
</methodsynopsis>
<para>
Возвращает строку, содержащую версию клиентской библиотеки MySQL.
Функция возвращает строку с версией клиентской MySQL-библиотеки.
</para>
</refsect1>
@@ -35,7 +36,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Строка, содержащая версию клиентской библиотеки MySQL.
Функция возвращает строку, которая содержит версию клиентской библиотеки MySQL.
</para>
</refsect1>
@@ -54,7 +55,8 @@
<entry>8.1.0</entry>
<entry>
Вызов функции <function>mysqli_get_client_info</function> с аргументом <parameter>mysql</parameter> устарел.
Функция никогда не требовала параметра, но неправильно позволяла его в качестве необязательного параметра.
Функции никогда не требовался этот параметр, но она ошибочно разрешала передавать для него аргумент
и обрабатывала параметр как необязательный.
</entry>
</row>
<row>
@@ -73,15 +75,16 @@
&reftitle.examples;
<para>
<example>
<title>mysqli_get_client_info</title>
<title>Пример получения информации о MySQL-клиенте функцией mysqli_get_client_info</title>
<programlisting role="php">
<![CDATA[
<?php
/* Для определения версии клиентской библиотеки MySQL
нет необходимости в создании соединения */
не обязательно создавать соединение */
printf("Версия клиентской библиотеки: %s\n", mysqli_get_client_info());
?>
]]>
</programlisting>

26
reference/mysqli/mysqli/init.xml
View File

@@ -1,13 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 035c126c0393fe154bac46e2c3c489ebadce48a5 Maintainer: tmn Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mysqli.init" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mysqli::init</refname>
<refname>mysqli_init</refname>
<refpurpose>
Инициализирует MySQLi и возвращает объект для использования в функции
mysqli_real_connect()
Инициализирует MySQLi-коннектор и возвращает объект для работы с функцией mysqli_real_connect()
</refpurpose>
</refnamediv>
@@ -15,6 +14,7 @@
&reftitle.description;
<para>&style.oop;</para>
<methodsynopsis role="mysqli">
<modifier role="attribute">#[\Deprecated]</modifier>
<modifier>public</modifier> <type class="union"><type>bool</type><type>null</type></type><methodname>mysqli::init</methodname>
<void/>
</methodsynopsis>
@@ -24,14 +24,14 @@
<void/>
</methodsynopsis>
<para>
Выделяет память или инициализирует объект MYSQL, пригодный для использования в
функциях <function>mysqli_options</function>.
Функция выделяет память или инициализирует объект MySQL для работы
с функциями <function>mysqli_options</function> и <function>mysqli_real_connect</function>.
</para>
<note>
<para>
Любые последующие вызовы mysqli-функций с этим ресурсом (кроме
<function>mysqli_options</function>) потерпят неудачу, пока не будет
вызвана функция <function>mysqli_real_connect</function>.
Очередные вызовы функций модуля mysqli, за исключением функции
<function>mysqli_options</function>, завершается ошибкой,
пока не вызовут функцию <function>mysqli_real_connect</function>.
</para>
</note>
</refsect1>
@@ -44,8 +44,8 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Метод <methodname>mysqli::init</methodname> возвращает &null; в случае успешного выполнения&return.falseforfailure;.
Функция <function>mysqli_init</function> возвращает объект в случае успешного выполнения&return.falseforfailure;.
Метод <methodname>mysqli::init</methodname> возвращает значение &null;, если завершился успешно,&return.falseforfailure;.
Функция <function>mysqli_init</function> возвращает объект, если завершилась успешно,&return.falseforfailure;.
</para>
</refsect1>
@@ -64,8 +64,8 @@
<entry>8.1.0</entry>
<entry>
Объектно-ориентированный стиль вызова метода <methodname>mysqli::init</methodname> устарел.
Замените вызов метода <methodname>parent::init</methodname> с помощью
<methodname>parent::__construct</methodname>.
Замените вызов метода <methodname>parent::init</methodname>
вызовом метода <methodname>parent::__construct</methodname>.
</entry>
</row>
</tbody>
@@ -76,7 +76,7 @@
<refsect1 role="examples">
&reftitle.examples;
<para>
Смотрите <function>mysqli_real_connect</function>.
Смотрите описание функции <function>mysqli_real_connect</function>.
</para>
</refsect1>

48
reference/mysqli/mysqli/kill.xml
View File

@@ -1,12 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 7ce9e1661da0479fe49641e3da2c2761cf029d5c Maintainer: tmn Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mysqli.kill" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mysqli::kill</refname>
<refname>mysqli_kill</refname>
<refpurpose>
Запрос для сервера завершить выполнение процесса MySQL
Просит сервер завершить MySQL-поток
</refpurpose>
</refnamediv>
@@ -18,24 +18,24 @@
&reftitle.description;
<para>&style.oop;</para>
<methodsynopsis role="mysqli">
<modifier role="attribute">#[\Deprecated]</modifier>
<modifier>public</modifier> <type>bool</type><methodname>mysqli::kill</methodname>
<methodparam><type>int</type><parameter>process_id</parameter></methodparam>
</methodsynopsis>
<para>&style.procedural;</para>
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>bool</type><methodname>mysqli_kill</methodname>
<methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
<methodparam><type>int</type><parameter>process_id</parameter></methodparam>
</methodsynopsis>
<para>
Эта функция используется, чтобы отправить на сервер команду завершить MySQL
процесс заданный параметром <parameter>process_id</parameter>. Значение этого
параметра должно быть получено с помощью функции
<function>mysqli_thread_id</function>.
Функция отправляет на сервер запрос на завершение MySQL-потока
с идентификатором, который указали в аргументе <parameter>process_id</parameter>.
Значение идентификатора получают функцией <function>mysqli_thread_id</function>.
</para>
<para>
Для завершения работы текущего запроса используйте SQL команду
<literal>KILL QUERY processid</literal>.
Работу текущего запроса останавливают SQL-командой <literal>KILL QUERY processid</literal>.
</para>
</refsect1>
@@ -74,9 +74,9 @@
<row>
<entry>8.4.0</entry>
<entry>
Оба метода <methodname>mysqli::kill</methodname> и
<function>mysqli_kill</function> устарели.
Вместо них используйте SQL-команды <literal>KILL</literal>.
Метод <methodname>mysqli::kill</methodname>
и функция <function>mysqli_kill</function> устарели.
Вместо них рекомендуют выполнять SQL-команду <literal>KILL</literal>.
</entry>
</row>
</tbody>
@@ -87,33 +87,35 @@
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример использования <methodname>mysqli::kill</methodname></title>
<title>Пример уничтожения потока методом <methodname>mysqli::kill</methodname></title>
<para>&style.oop;</para>
<programlisting role="php">
<![CDATA[
<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* проверка соединения */
/* Проверка соединения */
if (mysqli_connect_errno()) {
printf("Не удалось подключиться: %s\n", mysqli_connect_error());
exit();
}
/* определим id нашего процесса */
/* Определение id процесса */
$thread_id = $mysqli->thread_id;
/* убиваем соединение */
/* Убиваем соединение */
$mysqli->kill($thread_id);
/* здесь должна произойти ошибка */
/* Это вызовет ошибку */
if (!$mysqli->query("CREATE TABLE myCity LIKE City")) {
printf("Ошибка: %s\n", $mysqli->error);
exit;
}
/* закрываем соединение */
/* Закрываем соединение */
$mysqli->close();
?>
]]>
</programlisting>
@@ -121,28 +123,30 @@ $mysqli->close();
<programlisting role="php">
<![CDATA[
<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* проверка соединения */
/* Проверка соединения */
if (mysqli_connect_errno()) {
printf("Не удалось подключиться: %s\n", mysqli_connect_error());
exit();
}
/* определим id нашего процесса */
/* Опредеение id процесса */
$thread_id = mysqli_thread_id($link);
/* убиваем соединение */
/* Убиваем соединение */
mysqli_kill($link, $thread_id);
/* здесь должна произойти ошибка */
/* Это вызовет ошибку */
if (!mysqli_query($link, "CREATE TABLE myCity LIKE City")) {
printf("Ошибка: %s\n", mysqli_error($link));
exit;
}
/* закрываем соединение */
/* Закрываем соединение */
mysqli_close($link);
?>
]]>
</programlisting>

46
reference/mysqli/mysqli/ping.xml
View File

@@ -1,13 +1,13 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 7ce9e1661da0479fe49641e3da2c2761cf029d5c Maintainer: tmn Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mysqli.ping" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>mysqli::ping</refname>
<refname>mysqli_ping</refname>
<refpurpose>
Проверяет работоспособность соединения или пытается переподключиться, если
соединение разорвано
Проверяет соединение с сервером или пытается переподключиться,
если соединение прервалось
</refpurpose>
</refnamediv>
@@ -19,29 +19,32 @@
&reftitle.description;
<para>&style.oop;</para>
<methodsynopsis role="mysqli">
<modifier role="attribute">#[\Deprecated]</modifier>
<modifier>public</modifier> <type>bool</type><methodname>mysqli::ping</methodname>
<void/>
</methodsynopsis>
<para>&style.procedural;</para>
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>bool</type><methodname>mysqli_ping</methodname>
<methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
</methodsynopsis>
<para>
Проверяет работоспособность соединения с сервером. Если соединение разорвано, а
глобальная настройка <link linkend="ini.mysqli.reconnect">mysqli.reconnect</link> включена, PHP попытается
автоматически переподключиться.
Функция проверяет соединение с сервером. PHP попытается автоматически переподключиться,
если соединение прервалось и включена глобальная настройка
<link linkend="ini.mysqli.reconnect">mysqli.reconnect</link>.
</para>
<note>
<simpara>
Настройка &php.ini; mysqli.reconnect игнорируется драйвером "mysqlnd", так что
автоматического переподключения не произойдёт.
Драйвер <literal>mysqlnd</literal> игнорирует директиву
<literal>mysqli.reconnect</literal> файла &php.ini;,
поэтому не переподключается автоматически.
</simpara>
</note>
<para>
Эта функция может использоваться клиентами, которые простаивают без дела долгое
время, чтобы проверить, что сервер их не отключил, и переподключиться в
случае необходимости.
Функцией пользуются клиенты, которые долго простаивали,
чтобы проверить, не закрыл ли сервер соединение,
и требуется ли переподключение.
</para>
</refsect1>
@@ -80,10 +83,10 @@
<row>
<entry>8.4.0</entry>
<entry>
Оба метода <methodname>mysqli::ping</methodname> и
<function>mysqli_ping</function> устарели.
Функция <literal>reconnect</literal> была недоступна,
начиная с PHP 8.2.0, что делает эту функцию устаревшей.
Метод <methodname>mysqli::ping</methodname>
и функция <function>mysqli_ping</function> устарели.
Функция <literal>reconnect</literal> была недоступна
с PHP 8.2.0, что делает эту функцию устаревшей.
</entry>
</row>
</tbody>
@@ -94,20 +97,21 @@
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример использования <methodname>mysqli::ping</methodname></title>
<title>Пример проверки соединения с сервером методом <methodname>mysqli::ping</methodname></title>
<para>&style.oop;</para>
<programlisting role="php">
<![CDATA[
<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* проверка соединения */
/* Проверка соединения */
if ($mysqli->connect_errno) {
printf("Не удалось подключиться: %s\n", $mysqli->connect_error);
exit();
}
/* проверим, жив ли сервер */
/* Проверяем, жив ли сервер */
if ($mysqli->ping()) {
printf ("Соединение в порядке!\n");
} else {
@@ -116,6 +120,7 @@ if ($mysqli->ping()) {
/* закрываем соединение */
$mysqli->close();
?>
]]>
</programlisting>
@@ -131,15 +136,16 @@ if (mysqli_connect_errno()) {
exit();
}
/* проверим, жив ли сервер */
/* Проверяем, жив ли сервер */
if (mysqli_ping($link)) {
printf ("Соединение в порядке!\n");
} else {
printf ("Ошибка: %s\n", mysqli_error($link));
}
/* закрываем соединение */
/* Закрываем соединение */
mysqli_close($link);
?>
]]>
</programlisting>

25
reference/mysqli/mysqli/refresh.xml
View File

@@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 7ce9e1661da0479fe49641e3da2c2761cf029d5c Maintainer: tmn Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="mysqli.refresh" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>mysqli::refresh</refname>
<refname>mysqli_refresh</refname>
<refpurpose>Обновление</refpurpose>
<refpurpose>Обновляет таблицы или кеш</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -16,17 +16,19 @@
&reftitle.description;
<para>&style.oop;</para>
<methodsynopsis role="mysqli">
<modifier role="attribute">#[\Deprecated]</modifier>
<modifier>public</modifier> <type>bool</type><methodname>mysqli::refresh</methodname>
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>&style.procedural;</para>
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>bool</type><methodname>mysqli_refresh</methodname>
<methodparam><type>mysqli</type><parameter>mysql</parameter></methodparam>
<methodparam><type>int</type><parameter>flags</parameter></methodparam>
</methodsynopsis>
<para>
Очищает таблицы или кеш, либо сбрасывает копию серверной информации.
Функция очищает таблицы или кеш, либо сбрасывает информацию сервера репликации.
</para>
</refsect1>
@@ -39,13 +41,12 @@
<term><parameter>flags</parameter></term>
<listitem>
<para>
Настройки обновления задаются константами MYSQLI_REFRESH_*, которые
описаны в разделе документации <link linkend="mysqli.constants">Константы
MySQLi</link>.
Настройки обновления задаются константами семейства MYSQLI_REFRESH_*,
которые описавает раздел документации «<link linkend="mysqli.constants">Константы модуля MySQLi</link>».
</para>
<para>
Смотрите также официальную документацию <link
xlink:href="&url.mysql.docs.refresh;">MySQL Refresh</link>.
Смотрите также официальную документацию
<link xlink:href="&url.mysql.docs.refresh;">MySQL Refresh</link>.
</para>
</listitem>
</varlistentry>
@@ -56,7 +57,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&true; в случае успешного выполнения, &false; в противном случае.
Функция возвращает значение &true;, если выполнилась успешно, иначе возвращает значение &false;.
</para>
</refsect1>
@@ -74,9 +75,9 @@
<row>
<entry>8.4.0</entry>
<entry>
Оба метода <methodname>mysqli::refresh</methodname> и
<function>mysqli_refresh</function> устарели.
Вместо них используйте SQL-команды <literal>FLUSH</literal>.
Метод <methodname>mysqli::refresh</methodname>
и функция <function>mysqli_refresh</function> устарели.
Вместо них рекомендуют выполнять SQL-команду <literal>FLUSH</literal>.
</entry>
</row>
</tbody>

3
reference/openssl/functions/openssl-free-key.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.openssl-free-key" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,6 +14,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>void</type><methodname>openssl_free_key</methodname>
<methodparam><type>OpenSSLAsymmetricKey</type><parameter>key</parameter></methodparam>
</methodsynopsis>

15
reference/openssl/functions/openssl-pkey-free.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 52dc204a77076e1404257cf39f179882b90b5780 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.openssl-pkey-free" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,13 +14,14 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>void</type><methodname>openssl_pkey_free</methodname>
<methodparam><type>OpenSSLAsymmetricKey</type><parameter>key</parameter></methodparam>
</methodsynopsis>
&note.resource-migration-8.0-dead-function;
<para>
Функция высвобождает ресурс закрытого ключа, созданный
<function>openssl_pkey_new</function>.
Функция высвобождает ресурс закрытого ключа, который создали
функцией <function>openssl_pkey_new</function>.
</para>
</refsect1>
@@ -32,7 +33,7 @@
<term><parameter>key</parameter></term>
<listitem>
<para>
Ресурс, содержащий ключ.
Ресурс, в котором содержится ключ.
</para>
</listitem>
</varlistentry>
@@ -61,14 +62,14 @@
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела, так как больше не имеет смысла.
Функция устарела, поскольку больше ни на что не влияет.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>key</parameter> теперь принимает экземпляр <classname>OpenSSLAsymmetricKey</classname>;
ранее принимался ресурс (&resource;) типа <literal>OpenSSL key</literal>.
Параметр <parameter>key</parameter> теперь принимает экземпляр класса <classname>OpenSSLAsymmetricKey</classname>;
раньше принимался ресурс (&resource;), который принадлежит типу <literal>OpenSSL key</literal>.
</entry>
</row>
</tbody>

11
reference/openssl/functions/openssl-x509-free.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 52dc204a77076e1404257cf39f179882b90b5780 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.openssl-x509-free" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,12 +14,13 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>void</type><methodname>openssl_x509_free</methodname>
<methodparam><type>OpenSSLCertificate</type><parameter>certificate</parameter></methodparam>
</methodsynopsis>
&note.resource-migration-8.0-dead-function;
<para>
<function>openssl_x509_free</function> удаляет сертификат с идентификатором
Функция <function>openssl_x509_free</function> удаляет сертификат с идентификатором
<parameter>certificate</parameter> из памяти.
</para>
</refsect1>
@@ -60,14 +61,14 @@
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела, так как больше не имеет смысла.
Функция устарела, поскольку больше ни на что не влияет.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
<parameter>certificate</parameter> теперь принимает экземпляр <classname>OpenSSLCertificate</classname>;
ранее принимался ресурс (&resource;) типа <literal>OpenSSL X.509</literal>.
Параметр <parameter>certificate</parameter> теперь принимает экземпляр класса <classname>OpenSSLCertificate</classname>;
раньше принимался ресурс (&resource;), который принадлежит типу <literal>OpenSSL X.509</literal>.
</entry>
</row>
</tbody>

5
reference/random/functions/lcg-value.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: af621f747bd54d2cbec62340a10cc7c76a082a42 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.lcg-value" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,6 +14,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>float</type><methodname>lcg_value</methodname>
<void/>
</methodsynopsis>
@@ -51,7 +52,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает псевдослучайное число с плавающей точкой в диапазоне от 0.0 до 1.0 включительно.
Функция возвращает псевдослучайное число с плавающей точкой в диапазоне от 0.0 до 1.0 включительно.
</para>
</refsect1>

32
reference/reflection/reflectionfunction/isdisabled.xml
View File

@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: tmn Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="reflectionfunction.isdisabled" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>ReflectionFunction::isDisabled</refname>
<refpurpose>Проверяет, что функция отключена</refpurpose>
<refpurpose>Проверяет, отключили ли функцию</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -14,11 +14,12 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="ReflectionFunction">
<modifier role="attribute">#[\Deprecated]</modifier>
<modifier>public</modifier> <type>bool</type><methodname>ReflectionFunction::isDisabled</methodname>
<void/>
</methodsynopsis>
<para>
Проверяет, отключена ли функция, с помощью директивы
Метод проверяет, отключили ли функцию через директиву
<link linkend="ini.disable-functions">disable_functions</link>.
</para>
</refsect1>
@@ -31,10 +32,33 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&true;, если функция отключена, &false; противном случае.
Функция возвращает значение &true;, если функцию отключили, иначе возвращает значение &false;.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела, поскольку экземпляр класса <classname>ReflectionFunction</classname>
больше нельзя создавать для отключённых функций.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>

45
reference/reflection/reflectionparameter/getclass.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: tmn Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="reflectionparameter.getclass" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
@@ -14,16 +14,18 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="ReflectionParameter">
<modifier role="attribute">#[\Deprecated]</modifier>
<modifier>public</modifier> <type class="union"><type>ReflectionClass</type><type>null</type></type><methodname>ReflectionParameter::getClass</methodname>
<void/>
</methodsynopsis>
<para>
Получает объект <classname>ReflectionClass</classname> для отражаемого параметра или &null;.
Метод получает объект <classname>ReflectionClass</classname> для отражаемого параметра или &null;.
</para>
<para>
Начиная с PHP 8.0.0 эта функция устарела и не рекомендуется.
Вместо неё используйте <methodname>ReflectionParameter::getType</methodname>, чтобы получить <classname>ReflectionType</classname> параметра,
а затем опросите этот объект, чтобы определить тип параметра.
Начиная с PHP 8.0.0 метод устарел и им не рекомендуют пользоваться.
Вместо него лучше вызывать метод <methodname>ReflectionParameter::getType</methodname>,
чтобы получить экземпляр отражения параметра — <classname>ReflectionType</classname>,
а затем опросить этот объект, чтобы определить тип параметра.
</para>
&warn.undocumented.func;
@@ -38,8 +40,8 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Объект класса <classname>ReflectionClass</classname> или &null;, если тип не объявлен
или если объявленный тип не является классом или интерфейсом.
Метод возвращает объект класса <classname>ReflectionClass</classname> или &null;,
если тип не объявили или если объявленный тип не принадлежит классу или интерфейсу.
</para>
</refsect1>
@@ -47,17 +49,19 @@
&reftitle.examples;
<para>
<example>
<title>Пример использования класса <classname>ReflectionParameter</classname></title>
<title>Пример получения объекта <classname>ReflectionParameter</classname> для отражаемого параметра</title>
<programlisting role="php">
<![CDATA[
<?php
function foo(Exception $a) { }
function foo(Exception $a) {}
$functionReflection = new ReflectionFunction('foo');
$parameters = $functionReflection->getParameters();
$aParameter = $parameters[0];
echo $aParameter->getClass()->name;
?>
]]>
</programlisting>
@@ -65,6 +69,29 @@ echo $aParameter->getClass()->name;
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Метод устарел в пользу метода
<methodname>ReflectionParameter::getType</methodname>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>

55
reference/reflection/reflectionparameter/isarray.xml
View File

@@ -1,25 +1,26 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: tmn Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="reflectionparameter.isarray" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>ReflectionParameter::isArray</refname>
<refpurpose>Проверяет, ожидает ли аргумент массив в качестве значения</refpurpose>
<refpurpose>Проверяет, ожидает ли параметр массив в аргументе</refpurpose>
</refnamediv>
<refsynopsisdiv>
&warn.deprecated.function-8-0-0;
<para>В приведённом ниже примере показан альтернативный способ получения этой информации.</para>
<para>Пример на этой странице показыват альтернативный способ, которым получают эту информацию.</para>
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="ReflectionParameter">
<modifier role="attribute">#[\Deprecated]</modifier>
<modifier>public</modifier> <type>bool</type><methodname>ReflectionParameter::isArray</methodname>
<void/>
</methodsynopsis>
<para>
Проверяет, ожидает ли аргумент массив в качестве значения.
Метод проверяет, ожидает ли параметр массив как значение аргумента.
</para>
</refsect1>
@@ -31,35 +32,69 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&true;, если в качестве значения ожидается массив (<type>array</type>),
&false; в противном случае.
Метод возвращает &true;, если параметр ожидает в аргументе значение с типом <type>array</type>,
иначе возвращает &false;.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Метод устарел в пользу метода
<methodname>ReflectionParameter::getType</methodname>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Альтернатива в PHP 8.0.0</title>
<para>
Начиная с PHP 8.0.0, следующий код сообщит, поддерживает ли тип вызываемые объекты,
Начиная с PHP 8.0.0 следующий код сообщит, объявляет ли тип массивы,
в том числе как часть объединения.
</para>
<programlisting role="php">
<![CDATA[
<?php
function declaresArray(ReflectionParameter $reflectionParameter): bool
{
$reflectionType = $reflectionParameter->getType();
if (!$reflectionType) return false;
if (!$reflectionType) {
return false;
}
$types = $reflectionType instanceof ReflectionUnionType
? $reflectionType->getTypes()
: [$reflectionType];
: [$reflectionType]
;
return in_array('array', array_map(fn(ReflectionNamedType $t) => $t->getName(), $types));
return in_array(
'array',
array_map(
fn(ReflectionNamedType $t) => $t->getName(),
$types
)
);
}
?>
]]>
</programlisting>

50
reference/reflection/reflectionparameter/iscallable.xml
View File

@@ -1,22 +1,23 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ec2fe9a592f794978114ef5021db9f1d00c2e05d Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="reflectionparameter.iscallable" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>ReflectionParameter::isCallable</refname>
<refpurpose>Определяет, должен ли параметр принадлежать типу callable</refpurpose>
<refpurpose>Проверяет, объявили ли тип параметра как callable</refpurpose>
</refnamediv>
<refsynopsisdiv>
&warn.deprecated.function-8-0-0;
<para>
В приведённом примере показан альтернативный способ, которым получают эту информацию.
Пример на этой странице показывает альтернативный способ, которым получают эту информацию.
</para>
</refsynopsisdiv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="ReflectionParameter">
<modifier role="attribute">#[\Deprecated]</modifier>
<modifier>public</modifier> <type>bool</type><methodname>ReflectionParameter::isCallable</methodname>
<void/>
</methodsynopsis>
@@ -36,18 +37,41 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Метод возвращает &true;, если тип параметра <type>callable</type>, иначе &false;.
В случае ошибки метод вернёт &null;.
Метод возвращает &true;, если тип параметра <type>callable</type>, иначе возвращает &false;.
Метод вернёт &null;, если возникла ошибка.
</para>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.0.0</entry>
<entry>
Метод устарел в пользу метода
<methodname>ReflectionParameter::getType</methodname>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>
<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>Альтернатива в PHP 8.0.0</title>
<title>Пример альтернативного способа получить информацию о принадлежности параметра типу callable для PHP 8.0.0</title>
<para>
С PHP 8.0.0 следующий код сообщит, поддерживает ли тип вызываемые объекты,
Начиная с PHP 8.0.0 следующий код сообщит, поддерживает ли параметр тип callable,
в том числе как часть объединения.
</para>
<programlisting role="php">
@@ -58,14 +82,22 @@ function declaresCallable(ReflectionParameter $reflectionParameter): bool
{
$reflectionType = $reflectionParameter->getType();
if (!$reflectionType) return false;
if (!$reflectionType) {
return false;
}
$types = $reflectionType instanceof ReflectionUnionType
? $reflectionType->getTypes()
: [$reflectionType]
;
return in_array('callable', array_map(fn(ReflectionNamedType $t) => $t->getName(), $types));
return in_array(
'callable',
array_map(
fn(ReflectionNamedType $t) => $t->getName(),
$types
)
);
}
?>

28
reference/shmop/functions/shmop-close.xml
View File

@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 52dc204a77076e1404257cf39f179882b90b5780 Maintainer: aur Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: aur Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.shmop-close" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>shmop_close</refname>
<refpurpose>Закрытие блока разделяемой памяти</refpurpose>
<refpurpose>Закрывает блок разделяемой памяти</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -14,13 +14,14 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>void</type><methodname>shmop_close</methodname>
<methodparam><type>Shmop</type><parameter>shmop</parameter></methodparam>
</methodsynopsis>
&note.resource-migration-8.0-dead-function;
<para>
<function>shmop_close</function> используется для завершения доступа к
блоку разделяемой памяти.
Функция <function>shmop_close</function> используется закрывает доступа
к блоку разделяемой памяти.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -31,7 +32,7 @@
<term><parameter>shmop</parameter></term>
<listitem>
<para>
Ресурс блока памяти, возвращаемый функцией <function>shmop_open</function>
Ресурс блока общей памяти, который создали функцией <function>shmop_open</function>.
</para>
</listitem>
</varlistentry>
@@ -59,7 +60,14 @@
<row>
<entry>8.0.0</entry>
<entry>
Параметр <parameter>shmop</parameter> ожидает экземпляр <classname>Shmop</classname>; ранее ожидался ресурс (<type>resource</type>).
Функция устарела, поскольку больше ни на что не влияет.
</entry>
</row>
<row>
<entry>8.0.0</entry>
<entry>
Параметр <parameter>shmop</parameter> ожидает экземпляр класса <classname>Shmop</classname>;
раньше ожидался ресурс (<type>resource</type>).
</entry>
</row>
</tbody>
@@ -71,19 +79,21 @@
&reftitle.examples;
<para>
<example>
<title>Закрытие блока разделяемой памяти</title>
<title>Пример закрытия блока разделяемой памяти</title>
<programlisting role="php">
<![CDATA[
<?php
shmop_close($shm_id);
?>
]]>
</programlisting>
</example>
</para>
<para>
В данном примере прекращается доступ к блоку памяти, имеющему
идентификатор <literal>$shm_id</literal>.
В приведённом примере закрывается доступ к блоку общей памяти
с идентификатором <literal>$shm_id</literal>.
</para>
</refsect1>
<refsect1 role="seealso">

11
reference/spl/splfixedarray/wakeup.xml
View File

@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 03674dde72012054d8e7d34d97ce9f10aef24bd5 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="splfixedarray.wakeup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>SplFixedArray::__wakeup</refname>
<refpurpose>Переинициализация массива после десериализации</refpurpose>
<refpurpose>Переинициализирует массив после десериализации</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -14,11 +14,12 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="SplFixedArray">
<modifier role="attribute">#[\Deprecated]</modifier>
<modifier>public</modifier> <type>void</type><methodname>SplFixedArray::__wakeup</methodname>
<void/>
</methodsynopsis>
<para>
Проинициализирует массив после десериализации.
Функция проинициализирует массив после десериализации.
</para>
</refsect1>
@@ -48,8 +49,8 @@
<row>
<entry>8.4.0</entry>
<entry>
Метод объявлен устаревшим, используйте вместо него
<methodname>SplFixedArray::__unserialize</methodname>.
Метод устарел, вместо него рекомендуют пользоваться
методом <methodname>SplFixedArray::__unserialize</methodname>.
</entry>
</row>
</tbody>

103
reference/strings/functions/utf8-decode.xml
View File

@@ -1,10 +1,12 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b676d0b9c968ebb0b7429835f2f6bd364275eed1 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.utf8-decode">
<refentry xml:id="function.utf8-decode" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>utf8_decode</refname>
<refpurpose>Преобразовывает строку из кодировки UTF-8 в кодировку ISO-8859-1, заменяя недопустимые или непредставимые символы</refpurpose>
<refpurpose>
Преобразовывает строку из кодировки UTF-8 в кодировку ISO-8859-1, заменяя недопустимые или непредставимые символы
</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -14,29 +16,30 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>string</type><methodname>utf8_decode</methodname>
<methodparam><type>string</type><parameter>string</parameter></methodparam>
</methodsynopsis>
<para>
Функция преобразовывает строку <parameter>string</parameter> из кодировки
<literal>UTF-8</literal> в кодировку <literal>ISO-8859-1</literal>.
Байты в строке, которые не соответствуют корректным символам <literal>UTF-8</literal>
и символам <literal>UTF-8</literal>, которые не существуют в <literal>ISO-8859-1</literal>
(то есть кодовые точки выше <literal>U+00FF</literal>), будут заменены на символ <literal>?</literal>.
Байты в строке, которые не соответствуют корректным символам кодировки <literal>UTF-8</literal>
и <literal>UTF-8</literal>-символам, которые не содержатся в кодировке <literal>ISO-8859-1</literal> —
кодовые точки выше <literal>U+00FF</literal>, заменяются на символ <literal>?</literal>.
</para>
<note>
<para>
Многие веб-страницы, отмеченные как использующие кодировку
<literal>ISO-8859-1</literal>, на самом деле используют схожую кодировку
<literal>Windows-1252</literal>, и веб-браузеры интерпретируют
страницы <literal>ISO-8859-1</literal> как <literal>Windows-1252</literal>.
Однако <literal>Windows-1252</literal> содержит дополнительные печатные
символы, такие как знак Евро (<literal>€</literal>) и фигурные кавычки
(<literal>“</literal> <literal>”</literal>) вместо управляющих кодов
<literal>ISO-8859-1</literal>. Эта функция не конвертирует такие символы
<literal>Windows-1252</literal> корректно. Используйте другую функцию,
если нужна конвертация в <literal>Windows-1252</literal>.
Часто веб-страницы, которые отметили как страницы в кодировке
<literal>ISO-8859-1</literal>, кодируются похожей кодировкой —
<literal>Windows-1252</literal>, и браузеры интерпретируют
страницы в кодировке <literal>ISO-8859-1</literal> как страницы в кодировке <literal>Windows-1252</literal>.
Однако кодировка <literal>Windows-1252</literal> вместо управляющих кодов
кодировки <literal>ISO-8859-1</literal> содержит дополнительные печатные
символы наподобие знака евро <literal>€</literal> и английских двойных кавычек
<literal>“</literal> <literal>”</literal>. Функция не конвертирует такие символы
кодировки <literal>Windows-1252</literal> корректно. Для конвертации в кодировку
<literal>Windows-1252</literal> пользуются альтернативными функциями.
</para>
</note>
</refsect1>
@@ -49,7 +52,7 @@
<term><parameter>string</parameter></term>
<listitem>
<para>
Строка, закодированная в UTF-8.
Строка в кодировке UTF-8.
</para>
</listitem>
</varlistentry>
@@ -60,7 +63,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает данные параметра <parameter>string</parameter>, переведённые в кодировку ISO-8859-1.
Функция возвращает данные параметра <parameter>string</parameter>, которые преобразовала в кодировку ISO-8859-1.
</para>
</refsect1>
@@ -79,14 +82,14 @@
<row>
<entry>8.2.0</entry>
<entry>
Функция объявлена устаревшей.
Функция устарела.
</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>
Функция была перенесена из модуля XML в ядро PHP.
В предыдущих версиях она была доступна только при установленном модуле XML.
Функцию перенесли из модуля XML в ядро PHP.
В предыдущих версиях функция была доступна только при установленном модуле XML.
</entry>
</row>
</tbody>
@@ -98,25 +101,27 @@
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Простой пример</title>
<title>Простой пример преобразования строки из кодировки UTF-8 в кодировку ISO-8859-1</title>
<programlisting role="php">
<![CDATA[
<?php
// Преобразование строки 'Zoë' из UTF-8 в ISO 8859-1
// Преобразование строки 'Zoë' из кодировки UTF-8 в кодировку ISO 8859-1
$utf8_string = "\x5A\x6F\xC3\xAB";
$iso8859_1_string = utf8_decode($utf8_string);
echo bin2hex($iso8859_1_string), "\n";
// Неправильные последовательности UTF-8 заменяются на '?'
// Неправильные для кодировки UTF-8 последовательности заменяются на '?'
$invalid_utf8_string = "\xC3";
$iso8859_1_string = utf8_decode($invalid_utf8_string);
var_dump($iso8859_1_string);
// Символы, не существующие в ISO 8859-1, такие как
// '€' (Знак евро) также заменяются на '?'
// Символы, которые не содержатся в кодировке ISO 8859-1 наподобие
// знака евро '€', тоже заменяются символом '?'
$utf8_string = "\xE2\x82\xAC";
$iso8859_1_string = utf8_decode($utf8_string);
var_dump($iso8859_1_string);
?>
]]>
</programlisting>
@@ -136,27 +141,29 @@ string(1) "?"
<note>
<title>Устаревание и альтернативы</title>
<para>
Функция <emphasis>устарела</emphasis>, начиная с PHP 8.2.0 и будет удалена в будущей версии.
Существующие варианты использования должны быть проверены и заменены подходящими альтернативами.
Начиная с PHP 8.2.0 функция <emphasis>устарела</emphasis> и её удалят в будущей версии.
Разработчики языка рекомендуют заменить вызовы функции в коде альтернативами.
</para>
<para>
Аналогичной функциональности можно достичь с помощью функции <function>mb_convert_encoding</function>,
которая поддерживает ISO-8859-1 и многие другие кодировки символов.
Аналогичную функциональность даёт функция <function>mb_convert_encoding</function>,
которая поддерживает кодировку ISO-8859-1 и набор других кодировок символов.
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
$utf8_string = "\xC3\xAB"; // 'ë' (e с диерезисом) в UTF-8
$utf8_string = "\xC3\xAB"; // 'ë' — буква «e» с диерезисом в кодировке UTF-8
$iso8859_1_string = mb_convert_encoding($utf8_string, 'ISO-8859-1', 'UTF-8');
echo bin2hex($iso8859_1_string), "\n";
$utf8_string = "\xCE\xBB"; // 'λ' (Греческая строчная лямбда) в UTF-8
$utf8_string = "\xCE\xBB"; // 'λ' — греческая строчная лямбда в кодировке UTF-8
$iso8859_7_string = mb_convert_encoding($utf8_string, 'ISO-8859-7', 'UTF-8');
echo bin2hex($iso8859_7_string), "\n";
$utf8_string = "\xE2\x82\xAC"; // '€' (Символ евро) в UTF-8 (отсутствует в ISO-8859-1)
$utf8_string = "\xE2\x82\xAC"; // '€' — символ евро в кодировке UTF-8, не содержится в кодировке ISO-8859-1
$windows_1252_string = mb_convert_encoding($utf8_string, 'Windows-1252', 'UTF-8');
echo bin2hex($windows_1252_string), "\n";
?>
]]>
</programlisting>
@@ -171,16 +178,18 @@ eb
</informalexample>
</para>
<para>
Другие опции, которые могут быть доступны в зависимости от установленных модулей:
<methodname>UConverter::transcode</methodname> и <function>iconv</function>.
Другие способы, доступность которых зависит от загруженных модулей, —
метод <methodname>UConverter::transcode</methodname> и функция <function>iconv</function>.
</para>
<para>
Все следующие варианты дают один и тот же результат:
Каждый следующий способ даёт один и тот же результат:
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
$utf8_string = "\x5A\x6F\xC3\xAB"; // 'Zoë' в UTF-8
$utf8_string = "\x5A\x6F\xC3\xAB"; // 'Zoë' в кодировке UTF-8
$iso8859_1_string = utf8_decode($utf8_string);
echo bin2hex($iso8859_1_string), "\n";
@@ -192,6 +201,7 @@ echo bin2hex($iso8859_1_string), "\n";
$iso8859_1_string = UConverter::transcode($utf8_string, 'ISO-8859-1', 'UTF8');
echo bin2hex($iso8859_1_string), "\n";
?>
]]>
</programlisting>
@@ -205,19 +215,26 @@ echo bin2hex($iso8859_1_string), "\n";
]]>
</screen>
</informalexample>
Указание <literal>'?'</literal> в качестве опции <literal>'to_subst'</literal>
в методе <methodname>UConverter::transcode</methodname> даёт тот же результат,
что и функция <function>utf8_decode</function> для строк,
которые являются недопустимыми или не могут быть представлены в ISO 8859-1.
Символ <literal>'?'</literal> как значение элемента <literal>'to_subst'</literal> в массиве опций
метода <methodname>UConverter::transcode</methodname> даёт тот же результат,
что и функция <function>utf8_decode</function> для недопустимых строк
или строк, которые невозможно представить в кодировке ISO 8859-1.
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
$utf8_string = "\xE2\x82\xAC"; // € (Символ евро) отсутствует в ISO-8859-1
$utf8_string = "\xE2\x82\xAC"; // € — символ евро, отсутствует в кодировке ISO-8859-1
$iso8859_1_string = UConverter::transcode(
$utf8_string, 'ISO-8859-1', 'UTF-8', ['to_subst' => '?']
$utf8_string,
'ISO-8859-1',
'UTF-8',
['to_subst' => '?']
);
var_dump($iso8859_1_string);
?>
]]>
</programlisting>

55
reference/strings/functions/utf8-encode.xml
View File

@@ -1,7 +1,7 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b676d0b9c968ebb0b7429835f2f6bd364275eed1 Maintainer: sergey Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: sergey Status: ready -->
<!-- Reviewed: no -->
<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.utf8-encode">
<refentry xml:id="function.utf8-encode" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>utf8_encode</refname>
<refpurpose>Преобразовывает строку из кодировки ISO-8859-1 в кодировку UTF-8</refpurpose>
@@ -14,6 +14,7 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>string</type><methodname>utf8_encode</methodname>
<methodparam><type>string</type><parameter>string</parameter></methodparam>
</methodsynopsis>
@@ -31,16 +32,16 @@
если предполагалась другая кодировка.
</para>
<para>
Многие веб-страницы, отмеченные как использующие кодировку
<literal>ISO-8859-1</literal>, на самом деле используют схожую кодировку
Часто веб-страницы, которые отметили как страницы в кодировке
<literal>ISO-8859-1</literal>, кодируются похожей кодировкой —
<literal>Windows-1252</literal>, и браузеры интерпретируют
страницы <literal>ISO-8859-1</literal> как <literal>Windows-1252</literal>.
Однако кодировка <literal>Windows-1252</literal> содержит дополнительные печатаемые
символы наподобие знака Евро (<literal>€</literal>) и фигурные кавычки
(<literal>“</literal> <literal>”</literal>) вместо управляющих кодов
<literal>ISO-8859-1</literal>. Эта функция не конвертирует такие
<literal>Windows-1252</literal>-символы корректно. Если требуется преобразование
из кодировки <literal>Windows-1252</literal>, пользуются другой функцией.
страницы в кодировке <literal>ISO-8859-1</literal> как страницы в кодировке <literal>Windows-1252</literal>.
Однако кодировка <literal>Windows-1252</literal> вместо управляющих кодов
кодировки <literal>ISO-8859-1</literal> содержит дополнительные печатные
символы наподобие знака евро <literal>€</literal> и английских двойных кавычек
<literal>“</literal> <literal>”</literal>. Функция не конвертирует такие символы
кодировки <literal>Windows-1252</literal> корректно. Для конвертации в кодировку
<literal>Windows-1252</literal> пользуются альтернативными функциями.
</para>
</note>
</refsect1>
@@ -53,7 +54,7 @@
<term><parameter>string</parameter></term>
<listitem>
<para>
Строка ISO-8859-1.
Строка в кодировке ISO-8859-1.
</para>
</listitem>
</varlistentry>
@@ -64,7 +65,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Функция возвращает строку <parameter>string</parameter>, которую она преобразовала в кодировку в UTF-8.
Функция возвращает строку <parameter>string</parameter>, которую преобразовала в кодировку в UTF-8.
</para>
</refsect1>
@@ -83,13 +84,13 @@
<row>
<entry>8.2.0</entry>
<entry>
This function has been deprecated.
Функция устарела.
</entry>
</row>
<row>
<entry>7.2.0</entry>
<entry>
Функция перенесли из модуля XML в ядро PHP.
Функцию перенесли из модуля XML в ядро PHP.
В предыдущих версиях функция была доступна только при установленном модуле XML.
</entry>
</row>
@@ -102,12 +103,12 @@
<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Простой пример</title>
<title>Простой пример преобразования строки из кодировки ISO-8859-1 в кодировку UTF-8</title>
<programlisting role="php">
<![CDATA[
<?php
// Преобразование строки 'Zoë' из ISO 8859-1 в UTF-8
// Преобразование строки 'Zoë' из кодировки ISO 8859-1 в кодировку UTF-8
$iso8859_1_string = "\x5A\x6F\xEB";
$utf8_string = utf8_encode($iso8859_1_string);
echo bin2hex($utf8_string), "\n";
@@ -129,26 +130,26 @@ echo bin2hex($utf8_string), "\n";
<note>
<title>Устаревание и альтернативы</title>
<para>
С PHP 8.2.0 функция <emphasis>устарела</emphasis> и её удалят в будущей версии.
Требуется проверить и заменить вызовы этой функции в коде альтернативынми функциями.
Начиная с PHP 8.2.0 функция <emphasis>устарела</emphasis> и её удалят в будущей версии.
Разработчики языка рекомендуют заменить вызовы функции в коде альтернативами.
</para>
<para>
Аналогичную функциональность даёт функция <function>mb_convert_encoding</function>,
которая поддерживает кодировку ISO-8859-1 и многие другие кодировки символов.
которая поддерживает кодировку ISO-8859-1 и набор других кодировок символов.
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
$iso8859_1_string = "\xEB"; // Буква «ë» (e с диерезисом) в кодировке UTF-8
$iso8859_1_string = "\xEB"; // Символ "ë" — буква «e» с диерезисом в кодировке UTF-8
$utf8_string = mb_convert_encoding($iso8859_1_string, 'UTF-8', 'ISO-8859-1');
echo bin2hex($utf8_string), "\n";
$iso8859_7_string = "\xEB"; // Та же строка в кодировке ISO-8859-7 представляет символ «λ» (греческая строчная лямбда)
$iso8859_7_string = "\xEB"; // Та же строка в кодировке ISO-8859-7 представляет символ «λ» — греческую строчную лямбду
$utf8_string = mb_convert_encoding($iso8859_7_string, 'UTF-8', 'ISO-8859-7');
echo bin2hex($utf8_string), "\n";
$windows_1252_string = "\x80"; // Символ «€» (знак евро) в кодировке Windows-1252, но не в кодировке ISO-8859-1
$windows_1252_string = "\x80"; // Символ "€" — знак евро в кодировке Windows-1252, не содержится в кодировке ISO-8859-1
$utf8_string = mb_convert_encoding($windows_1252_string, 'UTF-8', 'Windows-1252');
echo bin2hex($utf8_string), "\n";
@@ -166,17 +167,17 @@ e282ac
</informalexample>
</para>
<para>
Другие опции, которые могут быть доступны в зависимости от установленных модулей:
<methodname>UConverter::transcode</methodname> и <function>iconv</function>.
Другие способы, доступность которых зависит от загруженных модулей, —
метод <methodname>UConverter::transcode</methodname> и функция <function>iconv</function>.
</para>
<para>
Каждый следующий вариант даёт одинаковый результат:
Каждый следующий способ даёт один и тот же результат:
<informalexample>
<programlisting role="php">
<![CDATA[
<?php
$iso8859_1_string = "\x5A\x6F\xEB"; // 'Zoë' в ISO-8859-1
$iso8859_1_string = "\x5A\x6F\xEB"; // 'Zoë' в кодировке ISO-8859-1
$utf8_string = utf8_encode($iso8859_1_string);
echo bin2hex($utf8_string), "\n";

18
reference/uodbc/functions/odbc-result-all.xml
View File

@@ -1,7 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8a2141dcc084f72feb4e0ae2feaff3b440e5c59e Maintainer: zors1 Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: zors1 Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.odbc-result-all" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>odbc_result_all</refname>
@@ -15,19 +14,20 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>int</type><type>false</type></type><methodname>odbc_result_all</methodname>
<methodparam><type>resource</type><parameter>statement</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>format</parameter><initializer>""</initializer></methodparam>
</methodsynopsis>
<para>
Печатает все строки из идентификатора результата, созданного
Функция печатает все строки из идентификатора результата, который создали функцией
<function>odbc_exec</function>. Результат печатается в формате HTML-таблицы.
Данные <emphasis>не</emphasis> экранируются.
</para>
<para>
Функция не предназначена для использования в производственной среде;
она должна использоваться при разработке для быстрого получения
результирующего набора.
Функция не предназначена для производственной среды;
функцией пользуются при разработке, чтобы быстро получить
результирующий набор.
</para>
</refsect1>
@@ -58,8 +58,8 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает количество строк в результате или &false; в случае возникновения
ошибки.
Функция возвращает количество строк в результате или &false;,
если возникла ошибка.
</para>
</refsect1>
@@ -78,7 +78,7 @@
<row>
<entry>8.1.0</entry>
<entry>
Функция объявлена устаревшей.
Функция устарела.
</entry>
</row>
</tbody>

26
reference/xml/functions/xml-set-object.xml
View File

@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 9cd8eb0f11edb4e59fd22f723137bbb91d6ab64f Maintainer: tmn Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: tmn Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.xml-set-object" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>xml_set_object</refname>
<refpurpose>Использование XML-анализатора внутри объекта</refpurpose>
<refpurpose>Устанавливает XML-парсер внутри объекта</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -14,15 +14,16 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>true</type><methodname>xml_set_object</methodname>
<methodparam><type>XMLParser</type><parameter>parser</parameter></methodparam>
<methodparam><type>object</type><parameter>object</parameter></methodparam>
</methodsynopsis>
<para>
Эта функция позволяет использовать <parameter>parser</parameter> внутри
объекта <parameter>object</parameter>. Все callback-функции могут быть
установлены функциями <function>xml_set_element_handler</function>
и т.п. и использоваться как методы объекта <parameter>object</parameter>.
Функция разрешает использовать парсер <parameter>parser</parameter> внутри
объекта <parameter>object</parameter>. Callback-функции
устанавливаются функциями наподобие <function>xml_set_element_handler</function>
и вызываются как методы объекта <parameter>object</parameter>.
</para>
</refsect1>
@@ -42,7 +43,7 @@
<term><parameter>object</parameter></term>
<listitem>
<para>
Объект, в котором будет использоваться XML-анализатор.
Объект, в котором будет вызываться XML-анализатор.
</para>
</listitem>
</varlistentry>
@@ -71,8 +72,8 @@
<row>
<entry>8.4.0</entry>
<entry>
Функция устарела, вместо неё передавайте соответствующие
значения типа <type>callable</type> в функции <function>xml_set_</function>.
Функция устарела, вместо неё передают правильные
значения с типом <type>callable</type> в функции <function>xml_set_</function>.
</entry>
</row>
&xml.changelog.parser-param;
@@ -85,10 +86,11 @@
&reftitle.examples;
<para>
<example>
<title>Пример использования <function>xml_set_object</function></title>
<title>Пример установки XML-парсера внутри объекта функцией <function>xml_set_object</function></title>
<programlisting role="php">
<![CDATA[
<?php
class CustomXMLParser
{
private $parser;
@@ -121,11 +123,11 @@ class CustomXMLParser
{
var_dump($tag);
}
} // окончание определения класса xml
}
$xml_parser = new CustomXMLParser();
$xml_parser->parse("<A ID='hallo'>PHP</A>");
?>
]]>
</programlisting>

10
reference/zip/functions/zip-close.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e7278889420140e0af5df90efe9f1cb63eb63842 Maintainer: mch Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.zip-close" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,11 +14,12 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>void</type><methodname>zip_close</methodname>
<methodparam><type>resource</type><parameter>zip</parameter></methodparam>
</methodsynopsis>
<para>
Закрывает дескриптор ZIP-архива.
Функция закрывает дескриптор ZIP-архива.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -29,7 +30,7 @@
<term><parameter>zip</parameter></term>
<listitem>
<para>
ZIP-файл должен быть открыт с помощью функции <function>zip_open</function>.
ZIP-файл, который прежде открыли функцией <function>zip_open</function>.
</para>
</listitem>
</varlistentry>
@@ -58,7 +59,8 @@
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела в пользу Object API, смотрите <methodname>ZipArchive::close</methodname>.
Функция устарела в пользу объектно-ориентированного API,
смотрите описание метода <methodname>ZipArchive::close</methodname>.
</entry>
</row>
</tbody>

9
reference/zip/functions/zip-entry-close.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: d24e819ef190ffbf93f0b8a86e4ceb204a2579d4 Maintainer: mch Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.zip-entry-close" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,11 +14,12 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>bool</type><methodname>zip_entry_close</methodname>
<methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
</methodsynopsis>
<para>
Закрывает заданный дескриптор директории.
Функция закрывает заданный дескриптор директории.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -29,7 +30,7 @@
<term><parameter>zip_entry</parameter></term>
<listitem>
<para>
Дескриптор директории, ранее открытый функцией <function>zip_entry_open</function>.
Дескриптор директории, который прежде открыли функцией <function>zip_entry_open</function>.
</para>
</listitem>
</varlistentry>
@@ -58,7 +59,7 @@
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела в пользу Object API.
Функция устарела в пользу объектно-ориентированного API.
</entry>
</row>
</tbody>

12
reference/zip/functions/zip-entry-compressedsize.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e7278889420140e0af5df90efe9f1cb63eb63842 Maintainer: mch Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.zip-entry-compressedsize" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,11 +14,12 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>int</type><type>false</type></type><methodname>zip_entry_compressedsize</methodname>
<methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
</methodsynopsis>
<para>
Возвращает сжатый размер заданного дескриптора директории.
Функция возвращает сжатый размер заданного дескриптора директории.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -29,7 +30,7 @@
<term><parameter>zip_entry</parameter></term>
<listitem>
<para>
Дескриптор директории, возвращаемый функцией <function>zip_read</function>.
Дескриптор директории, который возвращает функция <function>zip_read</function>.
</para>
</listitem>
</varlistentry>
@@ -39,7 +40,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Сжатый размер дескриптора директории&return.falseforfailure;.
Функция возвращает сжатый размер дескриптора директории&return.falseforfailure;.
</para>
</refsect1>
@@ -58,7 +59,8 @@
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела в пользу Object API, смотрите <methodname>ZipArchive::statIndex</methodname>.
Функция устарела в пользу объектно-ориентированного API,
смотрите описание метода <methodname>ZipArchive::statIndex</methodname>.
</entry>
</row>
</tbody>

12
reference/zip/functions/zip-entry-compressionmethod.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e7278889420140e0af5df90efe9f1cb63eb63842 Maintainer: mch Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.zip-entry-compressionmethod" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,12 +14,13 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>false</type></type><methodname>zip_entry_compressionmethod</methodname>
<methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
</methodsynopsis>
<para>
Возвращает метод сжатия дескриптора директории,
заданного в <parameter>zip_entry</parameter>.
Функция возвращает метод сжатия дескриптора директории,
который указали в аргументе <parameter>zip_entry</parameter>.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -30,7 +31,7 @@
<term><parameter>zip_entry</parameter></term>
<listitem>
<para>
Дескриптор директории, возвращаемый функцией <function>zip_read</function>.
Дескриптор директории, который возвращает функция <function>zip_read</function>.
</para>
</listitem>
</varlistentry>
@@ -59,7 +60,8 @@
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела в пользу Object API, смотрите <methodname>ZipArchive::statIndex</methodname>.
Функция устарела в пользу объектно-ориентированного API,
смотрите описание метода <methodname>ZipArchive::statIndex</methodname>.
</entry>
</row>
</tbody>

12
reference/zip/functions/zip-entry-filesize.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e7278889420140e0af5df90efe9f1cb63eb63842 Maintainer: mch Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.zip-entry-filesize" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,11 +14,12 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>int</type><type>false</type></type><methodname>zip_entry_filesize</methodname>
<methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
</methodsynopsis>
<para>
Возвращает реальный размер заданного дескриптора директории.
Функция возвращает реальный размер заданного дескриптора директории.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -29,7 +30,7 @@
<term><parameter>zip_entry</parameter></term>
<listitem>
<para>
Дескриптор директории, возвращаемый функцией <function>zip_read</function>.
Дескриптор директории, который возвращает функция <function>zip_read</function>.
</para>
</listitem>
</varlistentry>
@@ -39,7 +40,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Реальный размер дескриптора директории&return.falseforfailure;.
Функция возвращает реальный размер дескриптора директории&return.falseforfailure;.
</para>
</refsect1>
@@ -58,7 +59,8 @@
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела в пользу Object API, смотрите <methodname>ZipArchive::statIndex</methodname>.
Функция устарела в пользу объектно-ориентированного API,
смотрите описание метода <methodname>ZipArchive::statIndex</methodname>.
</entry>
</row>
</tbody>

12
reference/zip/functions/zip-entry-name.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e7278889420140e0af5df90efe9f1cb63eb63842 Maintainer: mch Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.zip-entry-name" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,11 +14,12 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>false</type></type><methodname>zip_entry_name</methodname>
<methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
</methodsynopsis>
<para>
Возвращает имя заданного дескриптора директории.
Функция возвращает имя заданного дескриптора директории.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -29,7 +30,7 @@
<term><parameter>zip_entry</parameter></term>
<listitem>
<para>
Дескриптор директории, возвращаемый функцией <function>zip_read</function>.
Дескриптор директории, который возвращает функция <function>zip_read</function>.
</para>
</listitem>
</varlistentry>
@@ -39,7 +40,7 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Имя дескриптора директории&return.falseforfailure;.
Функция возвращает имя дескриптора директории&return.falseforfailure;.
</para>
</refsect1>
@@ -58,7 +59,8 @@
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела в пользу Object API, смотрите <methodname>ZipArchive::statIndex</methodname>.
Функция устарела в пользу объектно-ориентированного API,
смотрите описание метода <methodname>ZipArchive::statIndex</methodname>.
</entry>
</row>
</tbody>

23
reference/zip/functions/zip-entry-open.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e7278889420140e0af5df90efe9f1cb63eb63842 Maintainer: aur Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: aur Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.zip-entry-open" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,13 +14,14 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type>bool</type><methodname>zip_entry_open</methodname>
<methodparam><type>resource</type><parameter>zip_dp</parameter></methodparam>
<methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
<methodparam choice="opt"><type>string</type><parameter>mode</parameter><initializer>"rb"</initializer></methodparam>
</methodsynopsis>
<para>
Открывает директорию в ZIP-архиве для чтения.
Функция открывает директорию в ZIP-архиве для чтения.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -31,7 +32,7 @@
<term><parameter>zip_dp</parameter></term>
<listitem>
<para>
Дескриптор, возвращаемый функцией <function>zip_open</function>.
Дескриптор, который возвращает функция <function>zip_open</function>.
</para>
</listitem>
</varlistentry>
@@ -39,7 +40,7 @@
<term><parameter>zip_entry</parameter></term>
<listitem>
<para>
Дескриптор директории, возвращаемый функцией <function>zip_read</function>.
Дескриптор директории, который возвращает функция <function>zip_read</function>.
</para>
</listitem>
</varlistentry>
@@ -47,13 +48,13 @@
<term><parameter>mode</parameter></term>
<listitem>
<para>
Доступные режимы приведены в документации к функции
Доступные режимы приводит документация к функции
<function>fopen</function>.
</para>
<note>
<para>
В настоящее время параметр <parameter>mode</parameter> игнорируется и всегда имеет значение
<literal>"rb"</literal>. Это связано с тем, что ZIP в PHP поддерживается только в режиме чтения.
Функция пока игнорирует параметр <parameter>mode</parameter>, а значение параметра
всегда равно <literal>"rb"</literal>. Это связано с тем, что ZIP в PHP поддерживается только в режиме чтения.
</para>
</note>
</listitem>
@@ -69,9 +70,9 @@
<note>
<para>
В отличие от функции <function>fopen</function> и других подобных функций, значение,
возвращаемое функцией <function>zip_entry_open</function> только информирует нас о
результате выполнения операции и не требуется для последующего чтения или закрытия
дескриптора директории.
которое возвращает функция <function>zip_entry_open</function>, указывает только
результат операции и не требуется для чтения или закрытия
дескриптора каталога.
</para>
</note>
</refsect1>
@@ -91,7 +92,7 @@
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела в пользу Object API.
Функция устарела в пользу объектно-ориентированного API.
</entry>
</row>
</tbody>

19
reference/zip/functions/zip-entry-read.xml
View File

@@ -1,10 +1,10 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e7278889420140e0af5df90efe9f1cb63eb63842 Maintainer: aur Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: aur Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.zip-entry-read" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
<refname>zip_entry_read</refname>
<refpurpose>Читает данные из открытого ранее дескриптора директории</refpurpose>
<refpurpose>Считывает данные из открытого прежде дескриптора каталога</refpurpose>
</refnamediv>
<refsynopsisdiv>
@@ -14,12 +14,13 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>string</type><type>false</type></type><methodname>zip_entry_read</methodname>
<methodparam><type>resource</type><parameter>zip_entry</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>len</parameter><initializer>1024</initializer></methodparam>
</methodsynopsis>
<para>
Читает данные из открытого ранее дескриптора директории.
Функция считывает данные из открытого прежде дескриптора каталога.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -30,7 +31,7 @@
<term><parameter>zip_entry</parameter></term>
<listitem>
<para>
Дескриптор директории, возвращаемый функцией <function>zip_read</function>.
Дескриптор директории, который возвращает функция <function>zip_read</function>.
</para>
</listitem>
</varlistentry>
@@ -38,11 +39,11 @@
<term><parameter>len</parameter></term>
<listitem>
<para>
Число байт, которое нужно считать.
Число байтов, которое требуется считать.
</para>
<note>
<para>
В параметре необходимо указывать объем данных, которые вы хотите считать,
В параметре указывают объём данных, который требуется считать,
без учёта сжатия.
</para>
</note>
@@ -54,7 +55,8 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает считанные данные, пустую строку, если достигнут конец файла, или &false; в случае возникновения ошибки.
Функция возвращает данные, которые считала, пустую строку,
если достигла конца файла, или &false;, если возникла ошибка.
</para>
</refsect1>
@@ -73,7 +75,8 @@
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела в пользу Object API, смотрите <methodname>ZipArchive::getFromIndex</methodname>.
Функция устарела в пользу объектно-ориентированного API,
смотрите описание метода <methodname>ZipArchive::getFromIndex</methodname>.
</entry>
</row>
</tbody>

16
reference/zip/functions/zip-open.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e7278889420140e0af5df90efe9f1cb63eb63842 Maintainer: mch Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.zip-open" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,11 +14,12 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>resource</type><type>int</type><type>false</type></type><methodname>zip_open</methodname>
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
</methodsynopsis>
<para>
Открывает ZIP-архив для чтения.
Функция открывает ZIP-архив для чтения.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -29,7 +30,7 @@
<term><parameter>filename</parameter></term>
<listitem>
<para>
Имя файла ZIP-архива для открытия.
Название файла ZIP-архива, который требуется открыть.
</para>
</listitem>
</varlistentry>
@@ -39,10 +40,10 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает ссылку на ресурс для последующего использования с функциями
Функция возвращает ссылку на ресурс для передачи в функции
<function>zip_read</function> и <function>zip_close</function>
либо возвращает номер ошибки, если <parameter>filename</parameter> не существует
или в случае другой ошибки.
или возвращает номер ошибки, если файл <parameter>filename</parameter> не существует
или возникла ошибка.
</para>
</refsect1>
@@ -61,7 +62,8 @@
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела в пользу Object API, смотрите <methodname>ZipArchive::open</methodname>.
Функция устарела в пользу объектно-ориентированного API,
смотрите описание метода <methodname>ZipArchive::open</methodname>.
</entry>
</row>
</tbody>

16
reference/zip/functions/zip-read.xml
View File

@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: e7278889420140e0af5df90efe9f1cb63eb63842 Maintainer: mch Status: ready -->
<!-- EN-Revision: 9b1673cf114a1e10c4563ab9223cb56aed552b89 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.zip-read" xmlns="http://docbook.org/ns/docbook">
<refnamediv>
@@ -14,11 +14,12 @@
<refsect1 role="description">
&reftitle.description;
<methodsynopsis>
<modifier role="attribute">#[\Deprecated]</modifier>
<type class="union"><type>resource</type><type>false</type></type><methodname>zip_read</methodname>
<methodparam><type>resource</type><parameter>zip</parameter></methodparam>
</methodsynopsis>
<para>
Считывает следующую запись в ZIP-архиве.
Функция считывает следующую запись в ZIP-архиве.
</para>
</refsect1>
<refsect1 role="parameters">
@@ -29,7 +30,7 @@
<term><parameter>zip</parameter></term>
<listitem>
<para>
ZIP-файл, предварительно открытый с помощью функции <function>zip_open</function>.
ZIP-файл, который прежде открыли функцией <function>zip_open</function>.
</para>
</listitem>
</varlistentry>
@@ -39,9 +40,9 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает запись каталога для дальнейшего использования с функциями
<literal>zip_entry_...</literal>, или &false;, если больше нет записей для чтения,
или код ошибки, если она произошла.
Функция возвращает запись каталога для передачи в функции семейства
<literal>zip_entry_*</literal> или &false;, если записей для чтения не осталось,
или код ошибки, если она возникла.
</para>
</refsect1>
@@ -60,7 +61,8 @@
<row>
<entry>8.0.0</entry>
<entry>
Функция устарела в пользу Object API, смотрите <methodname>ZipArchive::statIndex</methodname>.
Функция устарела в пользу объектно-ориентированного API,
смотрите описание метода <methodname>ZipArchive::statIndex</methodname>.
</entry>
</row>
</tbody>