From d96db32b2de023909eb7eef4714b9c410d9decb4 Mon Sep 17 00:00:00 2001 From: Mikhail Alferov Date: Mon, 2 Dec 2024 07:09:11 +0300 Subject: [PATCH] Update 9b1673cf114a1e10c4563ab9223cb56aed552b89 to En (#1009) * 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 --- reference/datetime/functions/date-sunrise.xml | 82 +++++++------- reference/datetime/functions/date-sunset.xml | 93 ++++++++-------- reference/datetime/functions/gmstrftime.xml | 42 +++---- reference/datetime/functions/strftime.xml | 5 +- reference/datetime/functions/strptime.xml | 71 ++++++------ .../functions/enchant-broker-free-dict.xml | 15 ++- .../enchant/functions/enchant-broker-free.xml | 13 ++- .../enchant-broker-get-dict-path.xml | 17 ++- .../enchant-broker-set-dict-path.xml | 17 ++- .../libxml-disable-entity-loader.xml | 27 ++++- reference/mhash/functions/mhash-count.xml | 20 ++-- .../mhash/functions/mhash-get-block-size.xml | 20 ++-- .../mhash/functions/mhash-get-hash-name.xml | 18 +-- .../mhash/functions/mhash-keygen-s2k.xml | 46 ++++---- reference/mhash/functions/mhash.xml | 29 ++--- reference/mysqli/mysqli/get-client-info.xml | 17 +-- reference/mysqli/mysqli/init.xml | 26 ++--- reference/mysqli/mysqli/kill.xml | 48 ++++---- reference/mysqli/mysqli/ping.xml | 46 ++++---- reference/mysqli/mysqli/refresh.xml | 25 +++-- .../openssl/functions/openssl-free-key.xml | 3 +- .../openssl/functions/openssl-pkey-free.xml | 15 +-- .../openssl/functions/openssl-x509-free.xml | 11 +- reference/random/functions/lcg-value.xml | 5 +- .../reflectionfunction/isdisabled.xml | 32 +++++- .../reflectionparameter/getclass.xml | 45 ++++++-- .../reflectionparameter/isarray.xml | 55 ++++++++-- .../reflectionparameter/iscallable.xml | 50 +++++++-- reference/shmop/functions/shmop-close.xml | 28 +++-- reference/spl/splfixedarray/wakeup.xml | 11 +- reference/strings/functions/utf8-decode.xml | 103 ++++++++++-------- reference/strings/functions/utf8-encode.xml | 55 +++++----- reference/uodbc/functions/odbc-result-all.xml | 18 +-- reference/xml/functions/xml-set-object.xml | 26 +++-- reference/zip/functions/zip-close.xml | 10 +- reference/zip/functions/zip-entry-close.xml | 9 +- .../functions/zip-entry-compressedsize.xml | 12 +- .../functions/zip-entry-compressionmethod.xml | 12 +- .../zip/functions/zip-entry-filesize.xml | 12 +- reference/zip/functions/zip-entry-name.xml | 12 +- reference/zip/functions/zip-entry-open.xml | 23 ++-- reference/zip/functions/zip-entry-read.xml | 19 ++-- reference/zip/functions/zip-open.xml | 16 +-- reference/zip/functions/zip-read.xml | 16 +-- 44 files changed, 765 insertions(+), 510 deletions(-) diff --git a/reference/datetime/functions/date-sunrise.xml b/reference/datetime/functions/date-sunrise.xml index 3c15b55fc..39f6927bc 100644 --- a/reference/datetime/functions/date-sunrise.xml +++ b/reference/datetime/functions/date-sunrise.xml @@ -1,5 +1,5 @@ - + @@ -12,9 +12,9 @@ - Функция УСТАРЕЛА, начиная с PHP 8.1.0. - Полагаться на эту функцию крайне не рекомендуется. Используйте - вместо неё функцию date_sun_info. + Начиная с PHP 8.1.0 функция УСТАРЕЛА. + Разработчики языка настоятельно не рекомендуют полагаться на функцию. + Вместо неё лучше пользоваться функцией date_sun_info. @@ -22,6 +22,7 @@ &reftitle.description; + #[\Deprecated] stringintfloatfalsedate_sunrise inttimestamp intreturnFormatSUNFUNCS_RET_STRING @@ -31,9 +32,9 @@ floatnullutcOffset&null; - date_sunrise возвращает время рассвета для - определённых дня (заданного аргументом timestamp) - и местоположения. + Функция date_sunrise возвращает время рассвета + для дня, который указали в аргументе timestamp, + и расположения. @@ -45,8 +46,8 @@ timestamp - Временная метка (timestamp) дня, для которого - определяется время рассвета. + Параметр timestamp принимает метку времени дня, + для которого берётся время рассвета. @@ -55,35 +56,34 @@ - &Constants; <parameter>returnFormat</parameter> + &Constants;, которые принимает параметр <parameter>returnFormat</parameter> - константа - описание - пример + Константа + Описание + Пример SUNFUNCS_RET_STRING - тип возвращаемого результата string + Возвращает результат в виде значения с типом string 16:46 SUNFUNCS_RET_DOUBLE - тип возвращаемого результата float + Возвращает результат в виде значения с типом float 16.78243132 SUNFUNCS_RET_TIMESTAMP - тип возвращаемого результата int - (временная метка) + Возвращает метку времени в виде значения с типом int 1095034606 @@ -97,8 +97,8 @@ latitude - По умолчанию в Северном полушарии, для Южного передаётся - отрицательная величина. Смотрите также + Значение по умолчанию — Северное полушарие, для Южного передаётся + отрицательное значение. Смотрите также описание директивы date.default_latitude. @@ -107,8 +107,8 @@ longitude - По умолчанию восточная, для указания западной долготы - передаётся отрицательная величина. Смотрите также + Значение по умолчанию — восточная долгота, для западной передаётся + отрицательное значение. Смотрите также описание директивы date.default_longitude. @@ -117,11 +117,11 @@ zenith - zenith - это угол между центром Солнца и линией, - перпендикулярной поверхности Земли. По умолчанию - date.sunrise_zenith + Параметр zenith устанавливает угол между центром Солнца и линией, + перпендикулярной поверхности Земли. По умолчанию параметр берёт значение директивы + date.sunrise_zenith.
- Распространённые углы <parameter>zenith</parameter> angles + Распространённые углы зенита <parameter>zenith</parameter> @@ -132,11 +132,11 @@ 90°50' - Восход солнца: точка, где Солнце становится видимым. + Восход солнца: точка, в которой солнце становится видимым. 96° - Гражданские сумерки: обычно используются для обозначения начала рассвета. + Гражданские сумерки: традиционно обозначает начало рассвета. 102° @@ -144,7 +144,7 @@ 108° - Астрономические сумерки: точка, в которой Солнце начинает быть источником любого освещения. + Астрономические сумерки: момент, когда солнце становится источником освещения. @@ -157,9 +157,9 @@ Задаётся в часах. - utcOffset игнорируется, если - returnFormat - - SUNFUNCS_RET_TIMESTAMP + Функция игнорирует параметр utcOffset, + если значение параметра returnFormat + равно значению константы SUNFUNCS_RET_TIMESTAMP. @@ -170,8 +170,10 @@ &reftitle.returnvalues; - Возвращает время восхода солнца в заданном формате - returnFormat&return.falseforfailure;. Одна из возможных причин неудачного выполнения - солнце не поднимается над горизонтом вообще, что происходит внутри полярных кругов в течение части года. + Функция возвращает время восхода солнца в формате, который определили в параметре + returnFormat, если завершилась успешно,&return.falseforfailure;. + Функция завершится неудачно, если солнце вообще не поднимается над горизонтом, + что бывает внутри полярных кругов в течение части года. @@ -197,14 +199,14 @@ 8.1.0 - Функция объявлена устаревшей, используйте вместе неё date_sun_info. + Функция устарела, пользуйтесь вместе неё функцию date_sun_info. 8.0.0 - latitude, longitude, - zenith и utcOffset теперь допускают значение null. + Параметры latitude, longitude, + zenith и utcOffset теперь принимают значение &null;. @@ -217,12 +219,12 @@ &reftitle.examples; - Пример использования <function>date_sunrise</function> + Пример получения времени рассвета функцией <function>date_sunrise</function> - Нет восхода солнца + Пример работы функции для времени и расположения, при которых солнце не восходит ]]> diff --git a/reference/datetime/functions/date-sunset.xml b/reference/datetime/functions/date-sunset.xml index 856749f6c..a6b4fc2a9 100644 --- a/reference/datetime/functions/date-sunset.xml +++ b/reference/datetime/functions/date-sunset.xml @@ -1,20 +1,20 @@ - + date_sunset - Возвращает время захода солнца для заданных дня и местоположения + Возвращает время захода солнца для заданных дня и расположения - Функция УСТАРЕЛА, начиная с PHP 8.1.0. - Полагаться на эту функцию крайне не рекомендуется. Используйте - вместо неё функцию date_sun_info. + Начиная с PHP 8.1.0 функция УСТАРЕЛА. + Разработчики языка настоятельно не рекомендуют полагаться на функцию. + Вместо неё лучше пользоваться функцией date_sun_info. @@ -22,6 +22,7 @@ &reftitle.description; + #[\Deprecated] stringintfloatfalsedate_sunset inttimestamp intreturnFormatSUNFUNCS_RET_STRING @@ -31,9 +32,9 @@ floatnullutcOffset&null; - date_sunset возвращает время захода солнца для - определённых дня (заданного аргументом timestamp) - и местоположения. + Функция date_sunset возвращает время захода солнца + для дня, который указали в аргументе timestamp, + и расположения. @@ -47,8 +48,8 @@ - Временная метка (timestamp) дня, для которого - определяется время захода солнца. + Параметр timestamp принимает метку времени дня, + для которого берётся время захода солнца. @@ -59,40 +60,34 @@
- Константы - <parameter>returnFormat</parameter> - + &Constants;, которые принимает параметр <parameter>returnFormat</parameter> - константа - описание - пример + Константа + Описание + Пример SUNFUNCS_RET_STRING - тип возвращаемого результата - string + Возвращает результат в виде значения с типом string 16:46 SUNFUNCS_RET_DOUBLE - тип возвращаемого результата - float + Возвращает результат в виде значения с типом float 16.78243132 SUNFUNCS_RET_TIMESTAMP - тип возвращаемого результата - int - (временная метка) + Возвращает метку времени в виде значения с типом int 1095034606 @@ -108,8 +103,8 @@ - По умолчанию в Северном полушарии, для Южного передаётся - отрицательная величина. Смотрите также + Значение по умолчанию — Северное полушарие, для Южного передаётся + отрицательное значение. Смотрите также описание директивы date.default_latitude. @@ -120,8 +115,8 @@ - По умолчанию восточная, для указания западной долготы - передаётся отрицательная величина. Смотрите также + Значение по умолчанию — восточная долгота, для западной передаётся + отрицательное значение. Смотрите также описание директивы date.default_longitude. @@ -132,14 +127,11 @@ - zenith - - это угол между центром Солнца и линией, - перпендикулярной поверхности Земли. По умолчанию - date.sunset_zenith + Параметр zenith устанавливает угол между центром Солнца и линией, + перпендикулярной поверхности Земли. По умолчанию параметр берёт значение директивы + date.sunrise_zenith.
- Распространённые углы - <parameter>zenith</parameter> - + Распространённые углы зенита <parameter>zenith</parameter> @@ -150,11 +142,11 @@ 90°50' - Восход солнца: точка, где Солнце становится невидимым. + Восход солнца: точка, в которой солнце становится невидимым. 96° - Гражданские сумерки: обычно используются для обозначения конца заката. + Гражданские сумерки: традиционно обозначает окончание заката. 102° @@ -162,7 +154,7 @@ 108° - Астрономические сумерки: точка, в которой Солнце заканчивает быть источником любого освещения. + Астрономические сумерки: момент, в которой солнце перестаёт быть источником освещения. @@ -177,10 +169,9 @@ Задаётся в часах. - utcOffset - игнорируется, если - returnFormat - - SUNFUNCS_RET_TIMESTAMP. + Функция игнорирует параметр utcOffset, + если значение параметра returnFormat + равно значению константы SUNFUNCS_RET_TIMESTAMP. @@ -191,8 +182,10 @@ &reftitle.returnvalues; - Возвращает время захода солнца в заданном формате - returnFormat&return.falseforfailure;. Одна из возможных причин неудачного выполнения - солнце не поднимается над горизонтом вообще, что происходит внутри полярных кругов в течение части года. + Функция возвращает время захода солнца в формате, который определили в параметре + returnFormat, если завершилась успешно,&return.falseforfailure;. + Функция завершится неудачно, если солнце вообще не заходит, + что бывает внутри полярных кругов в течение части года. @@ -218,14 +211,14 @@ 8.1.0 - Функция объявлена устаревшей, используйте вместе неё date_sun_info. + Функция устарела, пользуйтесь вместе неё функцию date_sun_info. 8.0.0 - latitude, longitude, - zenith и utcOffset теперь допускают значение null. + Параметры latitude, longitude, + zenith и utcOffset теперь принимают значение &null;. @@ -238,12 +231,12 @@ &reftitle.examples; - Пример использования <function>date_sunset</function> + Пример получения времени заката функцией <function>date_sunset</function> - Нет заката + Пример работы функции для времени и расположения, при которых солнце не заходит ]]> diff --git a/reference/datetime/functions/gmstrftime.xml b/reference/datetime/functions/gmstrftime.xml index 8a0f3bfcd..8e0e7739a 100644 --- a/reference/datetime/functions/gmstrftime.xml +++ b/reference/datetime/functions/gmstrftime.xml @@ -1,10 +1,10 @@ - + gmstrftime - Форматирует дату/время по Гринвичу с учётом текущей локали + Форматирует дату и время по Гринвичу с учётом текущей локали @@ -18,22 +18,23 @@ &reftitle.description; + #[\Deprecated] stringfalsegmstrftime stringformat intnulltimestamp&null; - Эта функция идентична функции strftime за - исключением того, что возвращает время по Гринвичу (GMT). Например, - при запуске на системе, где установлено Eastern Standard Time (GMT-0500), - первая строка из примера ниже выведет "Dec 31 1998 20:00:00", - тогда как вторая - "Jan 01 1999 01:00:00". + Функция идентична функции strftime, + за исключением того, что возвращает время по Гринвичу (GMT). Например, + при запуске в системе, в которой установили часовой пояс Eastern Standard Time (GMT-0500), + первая строка из приведённого примера выведет "Dec 31 1998 20:00:00", + а вторая — "Jan 01 1999 01:00:00". - Функция зависит от информации о локали операционной системы, которая может быть - несовместима друг с другом или вообще отсутствовать. - Вместо этой функции используйте метод IntlDateFormatter::format. + Функция зависит от региональных настроек операционной системы, которые иногда + несовместимы друг с другом или вообще недоступны. + Вместо этой функции лучше пользоваться методом IntlDateFormatter::format. @@ -58,13 +59,13 @@ &reftitle.returnvalues; - Возвращает строку, отформатированную согласно указанному формату - и с использованием временной метки из параметра timestamp - или текущего локального времени, если временная метка не была - указана. Названия месяцев, дней недели и других языкозависимых строк - будут показаны с учётом настроек текущей локали, установленных - с помощью функции setlocale. - В случае возникновения ошибки возвращает &false;. + Функция возвращает строку, которую отформатировала с учётом строки формата + и метки времени, которую передали в аргументе timestamp, + или текущего локального времени, если временную метку + не указали. Названия месяцев, дней недели и других языкозависимых строк + отобразятся с учётом настроек текущей локали, которую установили + функцией setlocale. + Функция возвращает &false;, если возникла ошибка. @@ -83,7 +84,7 @@ 8.0.0 - timestamp теперь допускает значение null. + Параметр timestamp теперь принимает значение &null;. @@ -96,13 +97,16 @@ &reftitle.examples; - Пример использования функции <function>gmstrftime</function> + Пример форматирования даты и времени по Гринвичу функцией <function>gmstrftime</function> ]]> diff --git a/reference/datetime/functions/strftime.xml b/reference/datetime/functions/strftime.xml index 21af2fa46..bf2c8a8e7 100644 --- a/reference/datetime/functions/strftime.xml +++ b/reference/datetime/functions/strftime.xml @@ -1,5 +1,5 @@ - + @@ -18,6 +18,7 @@ &reftitle.description; + #[\Deprecated] stringfalsestrftime stringformat intnulltimestamp&null; @@ -51,7 +52,7 @@
- Строка параметра <parameter>format</parameter> распознаёт следующие символы + В строке параметра <parameter>format</parameter> распознаются следующие символы diff --git a/reference/datetime/functions/strptime.xml b/reference/datetime/functions/strptime.xml index d52b5b328..1a7f122bb 100644 --- a/reference/datetime/functions/strptime.xml +++ b/reference/datetime/functions/strptime.xml @@ -1,12 +1,11 @@ - + strptime - Разбирает строку даты/времени, сгенерированную функцией - strftime + Разбирает строку даты и времени, которую сгенерировала функция strftime @@ -17,18 +16,19 @@ &reftitle.description; + #[\Deprecated] arrayfalsestrptime stringtimestamp stringformat - strptime возвращает массив с данными разбора - строки timestamp, либо &false; в случае возникновения ошибки. + Функция strptime возвращает массив с данными разбора + строки timestamp, или &false;, если возникла ошибка. - Названия месяцев и недель, а также другие названия, зависящие от - языка, соответствуют текущим настройкам местоположения, установленным - посредством setlocale (LC_TIME). + Названия месяцев и дней недели, и другие строки, которые зависят + от языка, соответствуют текущим региональным настройкам, которые установили + функцией setlocale (см. описание константы LC_TIME). @@ -40,8 +40,8 @@ timestamp (string) - Строка для разбора (например, строковый результат выполнения функции - strftime). + Строка наподобие той, которую возвращает функция strftime + и которую требуется разобрать. @@ -49,17 +49,16 @@ format (string) - Формат строки timestamp (например, формат, - используемый в функции strftime). Следует - обратить внимание на тот факт, что не все возможности форматирования - используемые в strftime будут обрабатываться в - strptime; набор поддерживаемых символов - форматирования зависит от ОС и используемой С-библиотеки. + Формат строки timestamp наподобие того, + с которым работает функция strftime. Обратите внимание, + отдельные параметры форматирования, которые доступны функции + strftime, не влияют на форматирование + функцией strptime; набор поддерживаемых символов + форматирования зависит от ОС и С-библиотеки. - За дополнительной информацией о возможностях форматирования - обращайтесь на страницу описания функции - strftime. + Подробнее о параметрах форматирования + рассказывает описание функции strftime. @@ -70,13 +69,13 @@ &reftitle.returnvalues; - Возвращает массив&return.falseforfailure;. + Функция возвращает массив&return.falseforfailure;.
- Список элементов возвращаемого массива + Список элементов, которые возвращаются в массиве @@ -127,8 +126,8 @@ "unparsed" - Часть timestamp, которую не удалось - распознать в соответствии с format + Часть метки timestamp, которую не удалось + распознать в строке формата format @@ -153,9 +152,10 @@ 8.1.0 - Функция объявлена устаревшей. - Вместо неё используйте date_parse_from_format (для синтаксического анализа, не зависящего от языкового стандарта) - или IntlDateFormatter::parse (для синтаксического анализа, зависящего от языкового стандарта). + Функция устарела. + Вместо неё рекомендуют пользоваться функцией date_parse_from_format, + чтобы разобрать дату и время независимо от региональных настроек, + или методом IntlDateFormatter::parse, чтобы разбор зависел от локали. @@ -168,16 +168,18 @@ &reftitle.examples; - Пример использования <function>strptime</function> + Пример разбора даты и времени функцией <function>strptime</function> ]]> @@ -209,18 +211,17 @@ Array ¬e.no-windows; - В действительности эта функция вызывает библиотечную функцию - strptime(). В различных ОС поведение функции - может сильно различаться. Функция date_parse_from_format - лишена этого недостатка и рекомендована к использованию. + Внутренне эта функция вызывает функцию strptime() + системной библиотеки на языке C. Поведение функции в одной операционной системе + иногда значительно отличается от поведения в другой. Функция date_parse_from_format + лишена этого недостатка, поэтому рекомендуют вызывать её. - "tm_sec" включает несколько секунд високосного года - (на данный момент до 2-х в год). Для получения дополнительной информации - о високосных секундах читайте статью на википедии. + Элемент "tm_sec" включает високосные секунды — до двух в год. + Подробнее о високосных секунды рассказывает статья + о високосной секунде на сайте Википедии. diff --git a/reference/enchant/functions/enchant-broker-free-dict.xml b/reference/enchant/functions/enchant-broker-free-dict.xml index cfd061608..f552f22e2 100644 --- a/reference/enchant/functions/enchant-broker-free-dict.xml +++ b/reference/enchant/functions/enchant-broker-free-dict.xml @@ -1,5 +1,5 @@ - + @@ -14,12 +14,13 @@ &reftitle.description; + #[\Deprecated] boolenchant_broker_free_dict EnchantDictionarydictionary Освобождает словарь. - Начиная с PHP 8.0.0, рекомендуется уничтожить объект вместо вызова этой функции. + Начиная с PHP 8.0.0 вместо вызова функции рекомендуют уничтожить объект. @@ -52,8 +53,14 @@ 8.0.0 - dictionary ожидает EnchantDictionary; - Ранее ожидался ресурс (&resource;). + Функция устарела в пользу удаления объекта. + + + + 8.0.0 + + Параметр dictionary теперь ожидает экземпляр класса EnchantDictionary; + раньше ожидался ресурс (&resource;). diff --git a/reference/enchant/functions/enchant-broker-free.xml b/reference/enchant/functions/enchant-broker-free.xml index 565951d17..e16269e12 100644 --- a/reference/enchant/functions/enchant-broker-free.xml +++ b/reference/enchant/functions/enchant-broker-free.xml @@ -1,5 +1,5 @@ - + @@ -14,12 +14,13 @@ &reftitle.description; + #[\Deprecated] boolenchant_broker_free EnchantBrokerbroker - Освобождает брокера со всеми его словарями. - Начиная с PHP 8.0.0, рекомендуется уничтожить объект вместо вызова этой функции. + Функция освобождает брокера со всеми его словарями. + Начиная с PHP 8.0.0 вместо вызова функции рекомендуют уничтожить объект. @@ -50,6 +51,12 @@ + + 8.0.0 + + Функция устарела в пользу удаления объекта. + + &enchant.changelog.broker-param; diff --git a/reference/enchant/functions/enchant-broker-get-dict-path.xml b/reference/enchant/functions/enchant-broker-get-dict-path.xml index 5012fafe3..7095c942a 100644 --- a/reference/enchant/functions/enchant-broker-get-dict-path.xml +++ b/reference/enchant/functions/enchant-broker-get-dict-path.xml @@ -1,5 +1,5 @@ - + @@ -14,12 +14,13 @@ &reftitle.description; + #[\Deprecated] stringfalseenchant_broker_get_dict_path EnchantBrokerbroker inttype - Возвращает путь словаря для заданного бэкенда. + Функция возвращает путь словаря для заданного бэкенда. @@ -32,7 +33,7 @@ type - Тип словарей, т.е. ENCHANT_MYSPELL + Тип словарей — ENCHANT_MYSPELL или ENCHANT_ISPELL. @@ -44,7 +45,7 @@ &reftitle.returnvalues; - Возвращает путь к директории словаря в случае успешного выполнения&return.falseforfailure;. + Функция возвращает путь к директории словаря, если выполнилась успешно,&return.falseforfailure;. @@ -59,6 +60,12 @@ + + 8.0.0 + + Функция устарела. + + &enchant.changelog.broker-param; @@ -69,7 +76,7 @@ &reftitle.notes; - Функция доступна, только если модуль был скомпилирован с Enchant v1. + Функция доступна, только если модуль скомпилировали с библиотекой Enchant v1. diff --git a/reference/enchant/functions/enchant-broker-set-dict-path.xml b/reference/enchant/functions/enchant-broker-set-dict-path.xml index 6465ce217..fb9f1dba2 100644 --- a/reference/enchant/functions/enchant-broker-set-dict-path.xml +++ b/reference/enchant/functions/enchant-broker-set-dict-path.xml @@ -1,10 +1,10 @@ - + enchant_broker_set_dict_path - Установить путь для заданного бэкенда + Устанавливает путь для бэкенда @@ -14,13 +14,14 @@ &reftitle.description; + #[\Deprecated] boolenchant_broker_set_dict_path EnchantBrokerbroker inttype stringpath - Установить путь для заданного бэкенда. + Функция устанавливает путь для заданного бэкенда. @@ -33,7 +34,7 @@ type - Тип словарей, т.е. ENCHANT_MYSPELL + Тип словарей — ENCHANT_MYSPELL или ENCHANT_ISPELL. @@ -68,6 +69,12 @@ + + 8.0.0 + + Функция устарела. + + &enchant.changelog.broker-param; @@ -78,7 +85,7 @@ &reftitle.notes; - Функция доступна, только если модуль был скомпилирован с Enchant v1. + Функция доступна, только если модуль скомпилировали с библиотекой Enchant v1. diff --git a/reference/libxml/functions/libxml-disable-entity-loader.xml b/reference/libxml/functions/libxml-disable-entity-loader.xml index 45805b564..13738d9ea 100644 --- a/reference/libxml/functions/libxml-disable-entity-loader.xml +++ b/reference/libxml/functions/libxml-disable-entity-loader.xml @@ -1,5 +1,5 @@ - + @@ -16,6 +16,7 @@ &reftitle.description; + #[\Deprecated] boollibxml_disable_entity_loader booldisable&true; @@ -58,10 +59,32 @@ &reftitle.returnvalues; - Возвращает предыдущее значение. + Функция возвращает предыдущее значение. + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Функция устарела. + + + + + + + + mhash_count - Получить наибольший доступный идентификатор хеша + Получает наибольший доступный идентификатор хеша @@ -14,11 +14,12 @@ &reftitle.description; + #[\Deprecated] intmhash_count - Возвращает наибольший доступный идентификатор хеша. + Функция возвращает наибольший доступный идентификатор хеша. @@ -30,8 +31,8 @@ &reftitle.returnvalues; - Получить наибольший доступный идентификатор хеша. Хеши нумеруются от 0 до этого - идентификатора. + Функция возвращает наибольший доступный идентификатор хеша. Хеши нумеруются от 0 до этого + идентификатора хеша. @@ -50,8 +51,9 @@ 8.1.0 - Функция объявлена устаревшей. - Используйте вместо неё функции hash_*(). + Функция устарела. + Вместо неё рекомендуют пользоваться функциями семейства + функции hash_*(). @@ -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)) + ; } + ?> ]]> diff --git a/reference/mhash/functions/mhash-get-block-size.xml b/reference/mhash/functions/mhash-get-block-size.xml index 9d51be19a..9bb99083b 100644 --- a/reference/mhash/functions/mhash-get-block-size.xml +++ b/reference/mhash/functions/mhash-get-block-size.xml @@ -1,11 +1,11 @@ - + mhash_get_block_size - Получить размер блока для заданного хеша + Получает размер блока хеша @@ -15,11 +15,12 @@ &reftitle.description; + #[\Deprecated] intfalsemhash_get_block_size intalgo - Возвращает размер блока для заданного algo. + Функция возвращает размер блока хеша, идентификатор которого указали в аргументе algo. @@ -31,7 +32,7 @@ algo - Идентификатор хеша. Одна из констант MHASH_hashname. + Идентификатор хеша. Константа семейства MHASH_*. @@ -42,8 +43,8 @@ &reftitle.returnvalues; - Возвращает размер в байтах или &false;, если параметр algo - задан некорректно. + Функция возвращает размер в байтах или &false;, если в аргументе algo + передали недопустимое значение. @@ -62,8 +63,9 @@ 8.1.0 - Функция объявлена устаревшей. - Используйте вместо неё функции hash_*(). + Функция устарела. + Вместо неё рекомендуют пользоваться функциями семейства + функции hash_*(). @@ -76,7 +78,7 @@ &reftitle.examples; - Пример использования <function>mhash_get_block_size</function> + Пример получения размера блока хеша функцией <function>mhash_get_block_size</function> - + mhash_get_hash_name - Получить имя указанного хеша + Получает имя хеша @@ -15,11 +15,12 @@ &reftitle.description; + #[\Deprecated] stringfalsemhash_get_hash_name intalgo - Возвращает имя заданного algo. + Функция возвращает имя хеша, идентификатор которого указали в аргументе algo. @@ -31,7 +32,7 @@ algo - Идентификатор хеша. Одна из констант MHASH_hashname. + Идентификатор хеша. Константа семейства MHASH_*. @@ -42,7 +43,7 @@ &reftitle.returnvalues; - Возвращает строку с названием или &false;, если такого хеша нет. + Функция возвращает строку с названием или &false;, если такого хеша нет. @@ -61,8 +62,9 @@ 8.1.0 - Функция объявлена устаревшей. - Используйте вместо неё функции hash_*(). + Функция устарела. + Вместо неё рекомендуют пользоваться функциями семейства + функции hash_*(). @@ -75,7 +77,7 @@ &reftitle.examples; - Пример использования <function>mhash_get_hash_name</function> + Пример получения названия хеша функцией <function>mhash_get_hash_name</function> - + - - + mhash_keygen_s2k - Генерация ключа + Генерирует ключ @@ -15,6 +14,7 @@ &reftitle.description; + #[\Deprecated] stringfalsemhash_keygen_s2k intalgo stringpassword @@ -22,19 +22,20 @@ intlength - Генерирует ключ в соответствии с заданным algo и указанным - паролем password. + Функция генерирует ключ в соответствии с идентификатором хеша, + который передали в аргументе algo, + и пользовательским паролем, который передали в аргументе password. - Используется алгоритм S2K с солью, как описано в документе OpenPGP - (RFC 2440). + Для генерации ключа функция использует алгоритм Salted S2K, как описывает документ OpenPGP + RFC 2440. - Помните, что пользовательские пароли не являются подходящими - ключами для криптографических алгоритмов, так как обычно они как минимум - набираемы на клавиатуре. Такие пароли используют только 6-7 бит (или меньше) - на символ. Так что такие пароли крайне рекомендуется предварительно преобразовывать - (например этой функцией). + Помните, что пользовательские пароли не рекомендуют использовать + как ключи в криптографических алгоритмах, поскольку пользователи часто выбирают ключи, + которые доступны для набора на клавиатуре. Такие пароли используют только 6-7 битов на символ, + а иногда меньше. Поэтому пользовательский ключ настоятельно рекомендуют + преобразовывать функциями наподобие этой. @@ -46,7 +47,7 @@ algo - Идентификатор хеша. Одна из констант MHASH_hashname. + Идентификатор хеша с которым создаётся ключ. Константа семейства MHASH_*. @@ -62,11 +63,11 @@ salt - Должна быть разной и достаточно случайной для каждого создаваемого - ключа. Так как salt должна быть известна - при проверке ключа, то хорошей идеей будет добавить её к ключу. - Соль имеет фиксированный размер в 8 байт и будет дополнена нулями, если - заданный параметр будет короче. + Для параметра рекомендуют устанавливать разную и достаточно случайную соль для каждого ключа, + который генерирует функция. Поскольку значение соли salt должно быть известно + при проверке ключей, то лучше добавлять соль в начало ключа. + Длина соли фиксирована и составляет 8 байтов, функция дополнит соль нулями, + если размер значения в аргументе окажется короче. @@ -85,7 +86,7 @@ &reftitle.returnvalues; - Возвращает строку с ключом или &false; в случае возникновения ошибки. + Функция возвращает строку с ключом или &false;, если возникла ошибка. @@ -104,8 +105,9 @@ 8.1.0 - Функция объявлена устаревшей. - Используйте вместо неё функции hash_*(). + Функция устарела. + Вместо неё рекомендуют пользоваться функциями семейства + функции hash_*(). diff --git a/reference/mhash/functions/mhash.xml b/reference/mhash/functions/mhash.xml index 6ccac5387..ef0403b52 100644 --- a/reference/mhash/functions/mhash.xml +++ b/reference/mhash/functions/mhash.xml @@ -1,5 +1,5 @@ - + @@ -15,14 +15,15 @@ &reftitle.description; + #[\Deprecated] stringfalsemhash intalgo stringdata stringnullkey&null; - mhash принимает хеш-функцию, заданную - algo для data. + Функция mhash применяет к данным data + хеш-функцию, которую указали в аргументе algo. @@ -34,7 +35,7 @@ algo - Идентификатор хеша. Одна из констант MHASH_hashname. + Идентификатор хеша. Константа семейства MHASH_*. @@ -50,11 +51,11 @@ key - Если задано, то функция вернёт результирующий HMAC. - HMAC - это код аутентификации сообщений, использующий хеш-функции, - который зависит от указанного ключа. - Не все алгоритмы, поддерживаемые mhash, могут использоваться в - режиме HMAC. + С этим параметром вместо хеша функция вернёт HMAC-код. + HMAC — код аутентификации сообщений, который включает криптографическую хеш-функцию + и секретный ключ, или проще — дайджест сообщения, который зависит от конкретного ключа. + Не каждый алгоритм, который поддерживается функцией mhash, доступен для формирования + кода в режиме HMAC. @@ -65,7 +66,8 @@ &reftitle.returnvalues; - Возвращает строку с результирующим хешем (также называемый дайджестом) или HMAC, или &false; в случае возникновения ошибки. + Функция возвращает строку либо с хешем, или дайджестом, либо с HMAC-кодом. + Функция возвращает &false;, если возникла ошибка. @@ -84,14 +86,15 @@ 8.1.0 - Функция объявлена устаревшей. - Используйте вместо неё функции hash_*(). + Функция устарела. + Вместо неё рекомендуют пользоваться функциями семейства + функции hash_*(). 8.0.0 - key теперь допускает значение null. + Параметр key теперь принимает значение &null;. diff --git a/reference/mysqli/mysqli/get-client-info.xml b/reference/mysqli/mysqli/get-client-info.xml index d896f386e..ee143a4cf 100644 --- a/reference/mysqli/mysqli/get-client-info.xml +++ b/reference/mysqli/mysqli/get-client-info.xml @@ -1,12 +1,12 @@ - + mysqli::$client_info mysqli::get_client_info mysqli_get_client_info - Получает информацию о клиенте MySQL + Получает информацию о MySQL-клиенте @@ -14,6 +14,7 @@ &style.oop; stringmysqli->client_info + #[\Deprecated] public stringmysqli::get_client_info @@ -23,7 +24,7 @@ mysqlinullmysql&null; - Возвращает строку, содержащую версию клиентской библиотеки MySQL. + Функция возвращает строку с версией клиентской MySQL-библиотеки. @@ -35,7 +36,7 @@ &reftitle.returnvalues; - Строка, содержащая версию клиентской библиотеки MySQL. + Функция возвращает строку, которая содержит версию клиентской библиотеки MySQL. @@ -54,7 +55,8 @@ 8.1.0 Вызов функции mysqli_get_client_info с аргументом mysql устарел. - Функция никогда не требовала параметра, но неправильно позволяла его в качестве необязательного параметра. + Функции никогда не требовался этот параметр, но она ошибочно разрешала передавать для него аргумент + и обрабатывала параметр как необязательный. @@ -73,15 +75,16 @@ &reftitle.examples; - mysqli_get_client_info + Пример получения информации о MySQL-клиенте функцией mysqli_get_client_info ]]> diff --git a/reference/mysqli/mysqli/init.xml b/reference/mysqli/mysqli/init.xml index 8fd9d5272..54152558d 100644 --- a/reference/mysqli/mysqli/init.xml +++ b/reference/mysqli/mysqli/init.xml @@ -1,13 +1,12 @@ - + mysqli::init mysqli_init - Инициализирует MySQLi и возвращает объект для использования в функции - mysqli_real_connect() + Инициализирует MySQLi-коннектор и возвращает объект для работы с функцией mysqli_real_connect() @@ -15,6 +14,7 @@ &reftitle.description; &style.oop; + #[\Deprecated] public boolnullmysqli::init @@ -24,14 +24,14 @@ - Выделяет память или инициализирует объект MYSQL, пригодный для использования в - функциях mysqli_options. + Функция выделяет память или инициализирует объект MySQL для работы + с функциями mysqli_options и mysqli_real_connect. - Любые последующие вызовы mysqli-функций с этим ресурсом (кроме - mysqli_options) потерпят неудачу, пока не будет - вызвана функция mysqli_real_connect. + Очередные вызовы функций модуля mysqli, за исключением функции + mysqli_options, завершается ошибкой, + пока не вызовут функцию mysqli_real_connect. @@ -44,8 +44,8 @@ &reftitle.returnvalues; - Метод mysqli::init возвращает &null; в случае успешного выполнения&return.falseforfailure;. - Функция mysqli_init возвращает объект в случае успешного выполнения&return.falseforfailure;. + Метод mysqli::init возвращает значение &null;, если завершился успешно,&return.falseforfailure;. + Функция mysqli_init возвращает объект, если завершилась успешно,&return.falseforfailure;. @@ -64,8 +64,8 @@ 8.1.0 Объектно-ориентированный стиль вызова метода mysqli::init устарел. - Замените вызов метода parent::init с помощью - parent::__construct. + Замените вызов метода parent::init + вызовом метода parent::__construct. @@ -76,7 +76,7 @@ &reftitle.examples; - Смотрите mysqli_real_connect. + Смотрите описание функции mysqli_real_connect. diff --git a/reference/mysqli/mysqli/kill.xml b/reference/mysqli/mysqli/kill.xml index 87a6c6301..b8f2cab7a 100644 --- a/reference/mysqli/mysqli/kill.xml +++ b/reference/mysqli/mysqli/kill.xml @@ -1,12 +1,12 @@ - + mysqli::kill mysqli_kill - Запрос для сервера завершить выполнение процесса MySQL + Просит сервер завершить MySQL-поток @@ -18,24 +18,24 @@ &reftitle.description; &style.oop; + #[\Deprecated] public boolmysqli::kill intprocess_id &style.procedural; + #[\Deprecated] boolmysqli_kill mysqlimysql intprocess_id - Эта функция используется, чтобы отправить на сервер команду завершить MySQL - процесс заданный параметром process_id. Значение этого - параметра должно быть получено с помощью функции - mysqli_thread_id. + Функция отправляет на сервер запрос на завершение MySQL-потока + с идентификатором, который указали в аргументе process_id. + Значение идентификатора получают функцией mysqli_thread_id. - Для завершения работы текущего запроса используйте SQL команду - KILL QUERY processid. + Работу текущего запроса останавливают SQL-командой KILL QUERY processid. @@ -74,9 +74,9 @@ 8.4.0 - Оба метода mysqli::kill и - mysqli_kill устарели. - Вместо них используйте SQL-команды KILL. + Метод mysqli::kill + и функция mysqli_kill устарели. + Вместо них рекомендуют выполнять SQL-команду KILL. @@ -87,33 +87,35 @@ &reftitle.examples; - Пример использования <methodname>mysqli::kill</methodname> + Пример уничтожения потока методом <methodname>mysqli::kill</methodname> &style.oop; thread_id; -/* убиваем соединение */ +/* Убиваем соединение */ $mysqli->kill($thread_id); -/* здесь должна произойти ошибка */ +/* Это вызовет ошибку */ if (!$mysqli->query("CREATE TABLE myCity LIKE City")) { printf("Ошибка: %s\n", $mysqli->error); exit; } -/* закрываем соединение */ +/* Закрываем соединение */ $mysqli->close(); + ?> ]]> @@ -121,28 +123,30 @@ $mysqli->close(); ]]> diff --git a/reference/mysqli/mysqli/ping.xml b/reference/mysqli/mysqli/ping.xml index bf0e2f583..e78fac9dc 100644 --- a/reference/mysqli/mysqli/ping.xml +++ b/reference/mysqli/mysqli/ping.xml @@ -1,13 +1,13 @@ - + mysqli::ping mysqli_ping - Проверяет работоспособность соединения или пытается переподключиться, если - соединение разорвано + Проверяет соединение с сервером или пытается переподключиться, + если соединение прервалось @@ -19,29 +19,32 @@ &reftitle.description; &style.oop; + #[\Deprecated] public boolmysqli::ping &style.procedural; + #[\Deprecated] boolmysqli_ping mysqlimysql - Проверяет работоспособность соединения с сервером. Если соединение разорвано, а - глобальная настройка mysqli.reconnect включена, PHP попытается - автоматически переподключиться. + Функция проверяет соединение с сервером. PHP попытается автоматически переподключиться, + если соединение прервалось и включена глобальная настройка + mysqli.reconnect. - Настройка &php.ini; mysqli.reconnect игнорируется драйвером "mysqlnd", так что - автоматического переподключения не произойдёт. + Драйвер mysqlnd игнорирует директиву + mysqli.reconnect файла &php.ini;, + поэтому не переподключается автоматически. - Эта функция может использоваться клиентами, которые простаивают без дела долгое - время, чтобы проверить, что сервер их не отключил, и переподключиться в - случае необходимости. + Функцией пользуются клиенты, которые долго простаивали, + чтобы проверить, не закрыл ли сервер соединение, + и требуется ли переподключение. @@ -80,10 +83,10 @@ 8.4.0 - Оба метода mysqli::ping и - mysqli_ping устарели. - Функция reconnect была недоступна, - начиная с PHP 8.2.0, что делает эту функцию устаревшей. + Метод mysqli::ping + и функция mysqli_ping устарели. + Функция reconnect была недоступна + с PHP 8.2.0, что делает эту функцию устаревшей. @@ -94,20 +97,21 @@ &reftitle.examples; - Пример использования <methodname>mysqli::ping</methodname> + Пример проверки соединения с сервером методом <methodname>mysqli::ping</methodname> &style.oop; connect_errno) { printf("Не удалось подключиться: %s\n", $mysqli->connect_error); exit(); } -/* проверим, жив ли сервер */ +/* Проверяем, жив ли сервер */ if ($mysqli->ping()) { printf ("Соединение в порядке!\n"); } else { @@ -116,6 +120,7 @@ if ($mysqli->ping()) { /* закрываем соединение */ $mysqli->close(); + ?> ]]> @@ -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); + ?> ]]> diff --git a/reference/mysqli/mysqli/refresh.xml b/reference/mysqli/mysqli/refresh.xml index 3a3c2bdb2..a79de8633 100644 --- a/reference/mysqli/mysqli/refresh.xml +++ b/reference/mysqli/mysqli/refresh.xml @@ -1,11 +1,11 @@ - + mysqli::refresh mysqli_refresh - Обновление + Обновляет таблицы или кеш @@ -16,17 +16,19 @@ &reftitle.description; &style.oop; + #[\Deprecated] public boolmysqli::refresh intflags &style.procedural; + #[\Deprecated] boolmysqli_refresh mysqlimysql intflags - Очищает таблицы или кеш, либо сбрасывает копию серверной информации. + Функция очищает таблицы или кеш, либо сбрасывает информацию сервера репликации. @@ -39,13 +41,12 @@ flags - Настройки обновления задаются константами MYSQLI_REFRESH_*, которые - описаны в разделе документации Константы - MySQLi. + Настройки обновления задаются константами семейства MYSQLI_REFRESH_*, + которые описавает раздел документации «Константы модуля MySQLi». - Смотрите также официальную документацию MySQL Refresh. + Смотрите также официальную документацию + MySQL Refresh. @@ -56,7 +57,7 @@ &reftitle.returnvalues; - &true; в случае успешного выполнения, &false; в противном случае. + Функция возвращает значение &true;, если выполнилась успешно, иначе возвращает значение &false;. @@ -74,9 +75,9 @@ 8.4.0 - Оба метода mysqli::refresh и - mysqli_refresh устарели. - Вместо них используйте SQL-команды FLUSH. + Метод mysqli::refresh + и функция mysqli_refresh устарели. + Вместо них рекомендуют выполнять SQL-команду FLUSH. diff --git a/reference/openssl/functions/openssl-free-key.xml b/reference/openssl/functions/openssl-free-key.xml index 41e570d2b..6144f20e2 100644 --- a/reference/openssl/functions/openssl-free-key.xml +++ b/reference/openssl/functions/openssl-free-key.xml @@ -1,5 +1,5 @@ - + @@ -14,6 +14,7 @@ &reftitle.description; + #[\Deprecated] voidopenssl_free_key OpenSSLAsymmetricKeykey diff --git a/reference/openssl/functions/openssl-pkey-free.xml b/reference/openssl/functions/openssl-pkey-free.xml index 87f394da7..d70788365 100644 --- a/reference/openssl/functions/openssl-pkey-free.xml +++ b/reference/openssl/functions/openssl-pkey-free.xml @@ -1,5 +1,5 @@ - + @@ -14,13 +14,14 @@ &reftitle.description; + #[\Deprecated] voidopenssl_pkey_free OpenSSLAsymmetricKeykey ¬e.resource-migration-8.0-dead-function; - Функция высвобождает ресурс закрытого ключа, созданный - openssl_pkey_new. + Функция высвобождает ресурс закрытого ключа, который создали + функцией openssl_pkey_new. @@ -32,7 +33,7 @@ key - Ресурс, содержащий ключ. + Ресурс, в котором содержится ключ. @@ -61,14 +62,14 @@ 8.0.0 - Функция устарела, так как больше не имеет смысла. + Функция устарела, поскольку больше ни на что не влияет. 8.0.0 - key теперь принимает экземпляр OpenSSLAsymmetricKey; - ранее принимался ресурс (&resource;) типа OpenSSL key. + Параметр key теперь принимает экземпляр класса OpenSSLAsymmetricKey; + раньше принимался ресурс (&resource;), который принадлежит типу OpenSSL key. diff --git a/reference/openssl/functions/openssl-x509-free.xml b/reference/openssl/functions/openssl-x509-free.xml index 2ec6ab8d2..4c2b3625b 100644 --- a/reference/openssl/functions/openssl-x509-free.xml +++ b/reference/openssl/functions/openssl-x509-free.xml @@ -1,5 +1,5 @@ - + @@ -14,12 +14,13 @@ &reftitle.description; + #[\Deprecated] voidopenssl_x509_free OpenSSLCertificatecertificate ¬e.resource-migration-8.0-dead-function; - openssl_x509_free удаляет сертификат с идентификатором + Функция openssl_x509_free удаляет сертификат с идентификатором certificate из памяти. @@ -60,14 +61,14 @@ 8.0.0 - Функция устарела, так как больше не имеет смысла. + Функция устарела, поскольку больше ни на что не влияет. 8.0.0 - certificate теперь принимает экземпляр OpenSSLCertificate; - ранее принимался ресурс (&resource;) типа OpenSSL X.509. + Параметр certificate теперь принимает экземпляр класса OpenSSLCertificate; + раньше принимался ресурс (&resource;), который принадлежит типу OpenSSL X.509. diff --git a/reference/random/functions/lcg-value.xml b/reference/random/functions/lcg-value.xml index 3a81cd719..6aef4471e 100644 --- a/reference/random/functions/lcg-value.xml +++ b/reference/random/functions/lcg-value.xml @@ -1,5 +1,5 @@ - + @@ -14,6 +14,7 @@ &reftitle.description; + #[\Deprecated] floatlcg_value @@ -51,7 +52,7 @@ &reftitle.returnvalues; - Возвращает псевдослучайное число с плавающей точкой в диапазоне от 0.0 до 1.0 включительно. + Функция возвращает псевдослучайное число с плавающей точкой в диапазоне от 0.0 до 1.0 включительно. diff --git a/reference/reflection/reflectionfunction/isdisabled.xml b/reference/reflection/reflectionfunction/isdisabled.xml index 5c2f71416..4452b0aed 100644 --- a/reference/reflection/reflectionfunction/isdisabled.xml +++ b/reference/reflection/reflectionfunction/isdisabled.xml @@ -1,10 +1,10 @@ - + ReflectionFunction::isDisabled - Проверяет, что функция отключена + Проверяет, отключили ли функцию @@ -14,11 +14,12 @@ &reftitle.description; + #[\Deprecated] public boolReflectionFunction::isDisabled - Проверяет, отключена ли функция, с помощью директивы + Метод проверяет, отключили ли функцию через директиву disable_functions. @@ -31,10 +32,33 @@ &reftitle.returnvalues; - &true;, если функция отключена, &false; противном случае. + Функция возвращает значение &true;, если функцию отключили, иначе возвращает значение &false;. + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Функция устарела, поскольку экземпляр класса ReflectionFunction + больше нельзя создавать для отключённых функций. + + + + + + + &reftitle.seealso; diff --git a/reference/reflection/reflectionparameter/getclass.xml b/reference/reflection/reflectionparameter/getclass.xml index 95fe29931..efcd82fac 100644 --- a/reference/reflection/reflectionparameter/getclass.xml +++ b/reference/reflection/reflectionparameter/getclass.xml @@ -1,5 +1,5 @@ - + @@ -14,16 +14,18 @@ &reftitle.description; + #[\Deprecated] public ReflectionClassnullReflectionParameter::getClass - Получает объект ReflectionClass для отражаемого параметра или &null;. + Метод получает объект ReflectionClass для отражаемого параметра или &null;. - Начиная с PHP 8.0.0 эта функция устарела и не рекомендуется. - Вместо неё используйте ReflectionParameter::getType, чтобы получить ReflectionType параметра, - а затем опросите этот объект, чтобы определить тип параметра. + Начиная с PHP 8.0.0 метод устарел и им не рекомендуют пользоваться. + Вместо него лучше вызывать метод ReflectionParameter::getType, + чтобы получить экземпляр отражения параметра — ReflectionType, + а затем опросить этот объект, чтобы определить тип параметра. &warn.undocumented.func; @@ -38,8 +40,8 @@ &reftitle.returnvalues; - Объект класса ReflectionClass или &null;, если тип не объявлен - или если объявленный тип не является классом или интерфейсом. + Метод возвращает объект класса ReflectionClass или &null;, + если тип не объявили или если объявленный тип не принадлежит классу или интерфейсу. @@ -47,17 +49,19 @@ &reftitle.examples; - Пример использования класса <classname>ReflectionParameter</classname> + Пример получения объекта <classname>ReflectionParameter</classname> для отражаемого параметра getParameters(); $aParameter = $parameters[0]; echo $aParameter->getClass()->name; + ?> ]]> @@ -65,6 +69,29 @@ echo $aParameter->getClass()->name; + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Метод устарел в пользу метода + ReflectionParameter::getType. + + + + + + + &reftitle.seealso; diff --git a/reference/reflection/reflectionparameter/isarray.xml b/reference/reflection/reflectionparameter/isarray.xml index e3d4e7565..f80ea5421 100644 --- a/reference/reflection/reflectionparameter/isarray.xml +++ b/reference/reflection/reflectionparameter/isarray.xml @@ -1,25 +1,26 @@ - + ReflectionParameter::isArray - Проверяет, ожидает ли аргумент массив в качестве значения + Проверяет, ожидает ли параметр массив в аргументе &warn.deprecated.function-8-0-0; - В приведённом ниже примере показан альтернативный способ получения этой информации. + Пример на этой странице показыват альтернативный способ, которым получают эту информацию. &reftitle.description; + #[\Deprecated] public boolReflectionParameter::isArray - Проверяет, ожидает ли аргумент массив в качестве значения. + Метод проверяет, ожидает ли параметр массив как значение аргумента. @@ -31,35 +32,69 @@ &reftitle.returnvalues; - &true;, если в качестве значения ожидается массив (array), - &false; в противном случае. + Метод возвращает &true;, если параметр ожидает в аргументе значение с типом array, + иначе возвращает &false;. + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Метод устарел в пользу метода + ReflectionParameter::getType. + + + + + + + &reftitle.examples; Альтернатива в PHP 8.0.0 - Начиная с PHP 8.0.0, следующий код сообщит, поддерживает ли тип вызываемые объекты, + Начиная с PHP 8.0.0 следующий код сообщит, объявляет ли тип массивы, в том числе как часть объединения. 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 + ) + ); } + ?> ]]> diff --git a/reference/reflection/reflectionparameter/iscallable.xml b/reference/reflection/reflectionparameter/iscallable.xml index 2b8b121af..727092580 100644 --- a/reference/reflection/reflectionparameter/iscallable.xml +++ b/reference/reflection/reflectionparameter/iscallable.xml @@ -1,22 +1,23 @@ - + ReflectionParameter::isCallable - Определяет, должен ли параметр принадлежать типу callable + Проверяет, объявили ли тип параметра как callable &warn.deprecated.function-8-0-0; - В приведённом примере показан альтернативный способ, которым получают эту информацию. + Пример на этой странице показывает альтернативный способ, которым получают эту информацию. &reftitle.description; + #[\Deprecated] public boolReflectionParameter::isCallable @@ -36,18 +37,41 @@ &reftitle.returnvalues; - Метод возвращает &true;, если тип параметра callable, иначе &false;. - В случае ошибки метод вернёт &null;. + Метод возвращает &true;, если тип параметра callable, иначе возвращает &false;. + Метод вернёт &null;, если возникла ошибка. + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Метод устарел в пользу метода + ReflectionParameter::getType. + + + + + + + &reftitle.examples; - Альтернатива в PHP 8.0.0 + Пример альтернативного способа получить информацию о принадлежности параметра типу callable для PHP 8.0.0 - С PHP 8.0.0 следующий код сообщит, поддерживает ли тип вызываемые объекты, + Начиная с PHP 8.0.0 следующий код сообщит, поддерживает ли параметр тип callable, в том числе как часть объединения. @@ -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 + ) + ); } ?> diff --git a/reference/shmop/functions/shmop-close.xml b/reference/shmop/functions/shmop-close.xml index 3e79dc16d..ae7ca735a 100644 --- a/reference/shmop/functions/shmop-close.xml +++ b/reference/shmop/functions/shmop-close.xml @@ -1,10 +1,10 @@ - + shmop_close - Закрытие блока разделяемой памяти + Закрывает блок разделяемой памяти @@ -14,13 +14,14 @@ &reftitle.description; + #[\Deprecated] voidshmop_close Shmopshmop ¬e.resource-migration-8.0-dead-function; - shmop_close используется для завершения доступа к - блоку разделяемой памяти. + Функция shmop_close используется закрывает доступа + к блоку разделяемой памяти. @@ -31,7 +32,7 @@ shmop - Ресурс блока памяти, возвращаемый функцией shmop_open + Ресурс блока общей памяти, который создали функцией shmop_open. @@ -59,7 +60,14 @@ 8.0.0 - Параметр shmop ожидает экземпляр Shmop; ранее ожидался ресурс (resource). + Функция устарела, поскольку больше ни на что не влияет. + + + + 8.0.0 + + Параметр shmop ожидает экземпляр класса Shmop; + раньше ожидался ресурс (resource). @@ -71,19 +79,21 @@ &reftitle.examples; - Закрытие блока разделяемой памяти + Пример закрытия блока разделяемой памяти ]]> - В данном примере прекращается доступ к блоку памяти, имеющему - идентификатор $shm_id. + В приведённом примере закрывается доступ к блоку общей памяти + с идентификатором $shm_id. diff --git a/reference/spl/splfixedarray/wakeup.xml b/reference/spl/splfixedarray/wakeup.xml index e7b368bad..96fbaf2b6 100644 --- a/reference/spl/splfixedarray/wakeup.xml +++ b/reference/spl/splfixedarray/wakeup.xml @@ -1,10 +1,10 @@ - + SplFixedArray::__wakeup - Переинициализация массива после десериализации + Переинициализирует массив после десериализации @@ -14,11 +14,12 @@ &reftitle.description; + #[\Deprecated] public voidSplFixedArray::__wakeup - Проинициализирует массив после десериализации. + Функция проинициализирует массив после десериализации. @@ -48,8 +49,8 @@ 8.4.0 - Метод объявлен устаревшим, используйте вместо него - SplFixedArray::__unserialize. + Метод устарел, вместо него рекомендуют пользоваться + методом SplFixedArray::__unserialize. diff --git a/reference/strings/functions/utf8-decode.xml b/reference/strings/functions/utf8-decode.xml index b2cc23948..ee8d3b8ac 100644 --- a/reference/strings/functions/utf8-decode.xml +++ b/reference/strings/functions/utf8-decode.xml @@ -1,10 +1,12 @@ - + - + utf8_decode - Преобразовывает строку из кодировки UTF-8 в кодировку ISO-8859-1, заменяя недопустимые или непредставимые символы + + Преобразовывает строку из кодировки UTF-8 в кодировку ISO-8859-1, заменяя недопустимые или непредставимые символы + @@ -14,29 +16,30 @@ &reftitle.description; + #[\Deprecated] stringutf8_decode stringstring Функция преобразовывает строку string из кодировки UTF-8 в кодировку ISO-8859-1. - Байты в строке, которые не соответствуют корректным символам UTF-8 - и символам UTF-8, которые не существуют в ISO-8859-1 - (то есть кодовые точки выше U+00FF), будут заменены на символ ?. + Байты в строке, которые не соответствуют корректным символам кодировки UTF-8 + и UTF-8-символам, которые не содержатся в кодировке ISO-8859-1 — + кодовые точки выше U+00FF, заменяются на символ ?. - Многие веб-страницы, отмеченные как использующие кодировку - ISO-8859-1, на самом деле используют схожую кодировку - Windows-1252, и веб-браузеры интерпретируют - страницы ISO-8859-1 как Windows-1252. - Однако Windows-1252 содержит дополнительные печатные - символы, такие как знак Евро (€) и фигурные кавычки - (“ ”) вместо управляющих кодов - ISO-8859-1. Эта функция не конвертирует такие символы - Windows-1252 корректно. Используйте другую функцию, - если нужна конвертация в Windows-1252. + Часто веб-страницы, которые отметили как страницы в кодировке + ISO-8859-1, кодируются похожей кодировкой — + Windows-1252, и браузеры интерпретируют + страницы в кодировке ISO-8859-1 как страницы в кодировке Windows-1252. + Однако кодировка Windows-1252 вместо управляющих кодов + кодировки ISO-8859-1 содержит дополнительные печатные + символы наподобие знака евро € и английских двойных кавычек + “ ”. Функция не конвертирует такие символы + кодировки Windows-1252 корректно. Для конвертации в кодировку + Windows-1252 пользуются альтернативными функциями. @@ -49,7 +52,7 @@ string - Строка, закодированная в UTF-8. + Строка в кодировке UTF-8. @@ -60,7 +63,7 @@ &reftitle.returnvalues; - Возвращает данные параметра string, переведённые в кодировку ISO-8859-1. + Функция возвращает данные параметра string, которые преобразовала в кодировку ISO-8859-1. @@ -79,14 +82,14 @@ 8.2.0 - Функция объявлена устаревшей. + Функция устарела. 7.2.0 - Функция была перенесена из модуля XML в ядро PHP. - В предыдущих версиях она была доступна только при установленном модуле XML. + Функцию перенесли из модуля XML в ядро PHP. + В предыдущих версиях функция была доступна только при установленном модуле XML. @@ -98,25 +101,27 @@ &reftitle.examples; - Простой пример + Простой пример преобразования строки из кодировки UTF-8 в кодировку ISO-8859-1 ]]> @@ -136,27 +141,29 @@ string(1) "?" Устаревание и альтернативы - Функция устарела, начиная с PHP 8.2.0 и будет удалена в будущей версии. - Существующие варианты использования должны быть проверены и заменены подходящими альтернативами. + Начиная с PHP 8.2.0 функция устарела и её удалят в будущей версии. + Разработчики языка рекомендуют заменить вызовы функции в коде альтернативами. - Аналогичной функциональности можно достичь с помощью функции mb_convert_encoding, - которая поддерживает ISO-8859-1 и многие другие кодировки символов. + Аналогичную функциональность даёт функция mb_convert_encoding, + которая поддерживает кодировку ISO-8859-1 и набор других кодировок символов. ]]> @@ -171,16 +178,18 @@ eb - Другие опции, которые могут быть доступны в зависимости от установленных модулей: - UConverter::transcode и iconv. + Другие способы, доступность которых зависит от загруженных модулей, — + метод UConverter::transcode и функция iconv. - Все следующие варианты дают один и тот же результат: + Каждый следующий способ даёт один и тот же результат: ]]> @@ -205,19 +215,26 @@ echo bin2hex($iso8859_1_string), "\n"; ]]> - Указание '?' в качестве опции 'to_subst' - в методе UConverter::transcode даёт тот же результат, - что и функция utf8_decode для строк, - которые являются недопустимыми или не могут быть представлены в ISO 8859-1. + Символ '?' как значение элемента 'to_subst' в массиве опций + метода UConverter::transcode даёт тот же результат, + что и функция utf8_decode для недопустимых строк + или строк, которые невозможно представить в кодировке ISO 8859-1. '?'] + $utf8_string, + 'ISO-8859-1', + 'UTF-8', + ['to_subst' => '?'] ); + var_dump($iso8859_1_string); + ?> ]]> diff --git a/reference/strings/functions/utf8-encode.xml b/reference/strings/functions/utf8-encode.xml index b830447db..b075bf8c3 100644 --- a/reference/strings/functions/utf8-encode.xml +++ b/reference/strings/functions/utf8-encode.xml @@ -1,7 +1,7 @@ - + - + utf8_encode Преобразовывает строку из кодировки ISO-8859-1 в кодировку UTF-8 @@ -14,6 +14,7 @@ &reftitle.description; + #[\Deprecated] stringutf8_encode stringstring @@ -31,16 +32,16 @@ если предполагалась другая кодировка. - Многие веб-страницы, отмеченные как использующие кодировку - ISO-8859-1, на самом деле используют схожую кодировку + Часто веб-страницы, которые отметили как страницы в кодировке + ISO-8859-1, кодируются похожей кодировкой — Windows-1252, и браузеры интерпретируют - страницы ISO-8859-1 как Windows-1252. - Однако кодировка Windows-1252 содержит дополнительные печатаемые - символы наподобие знака Евро (€) и фигурные кавычки - (“ ”) вместо управляющих кодов - ISO-8859-1. Эта функция не конвертирует такие - Windows-1252-символы корректно. Если требуется преобразование - из кодировки Windows-1252, пользуются другой функцией. + страницы в кодировке ISO-8859-1 как страницы в кодировке Windows-1252. + Однако кодировка Windows-1252 вместо управляющих кодов + кодировки ISO-8859-1 содержит дополнительные печатные + символы наподобие знака евро € и английских двойных кавычек + “ ”. Функция не конвертирует такие символы + кодировки Windows-1252 корректно. Для конвертации в кодировку + Windows-1252 пользуются альтернативными функциями. @@ -53,7 +54,7 @@ string - Строка ISO-8859-1. + Строка в кодировке ISO-8859-1. @@ -64,7 +65,7 @@ &reftitle.returnvalues; - Функция возвращает строку string, которую она преобразовала в кодировку в UTF-8. + Функция возвращает строку string, которую преобразовала в кодировку в UTF-8. @@ -83,13 +84,13 @@ 8.2.0 - This function has been deprecated. + Функция устарела. 7.2.0 - Функция перенесли из модуля XML в ядро PHP. + Функцию перенесли из модуля XML в ядро PHP. В предыдущих версиях функция была доступна только при установленном модуле XML. @@ -102,12 +103,12 @@ &reftitle.examples; - Простой пример + Простой пример преобразования строки из кодировки ISO-8859-1 в кодировку UTF-8 Устаревание и альтернативы - С PHP 8.2.0 функция устарела и её удалят в будущей версии. - Требуется проверить и заменить вызовы этой функции в коде альтернативынми функциями. + Начиная с PHP 8.2.0 функция устарела и её удалят в будущей версии. + Разработчики языка рекомендуют заменить вызовы функции в коде альтернативами. Аналогичную функциональность даёт функция mb_convert_encoding, - которая поддерживает кодировку ISO-8859-1 и многие другие кодировки символов. + которая поддерживает кодировку ISO-8859-1 и набор других кодировок символов. - Другие опции, которые могут быть доступны в зависимости от установленных модулей: - UConverter::transcode и iconv. + Другие способы, доступность которых зависит от загруженных модулей, — + метод UConverter::transcode и функция iconv. - Каждый следующий вариант даёт одинаковый результат: + Каждый следующий способ даёт один и тот же результат: - + - odbc_result_all @@ -15,19 +14,20 @@ &reftitle.description; + #[\Deprecated] intfalseodbc_result_all resourcestatement stringformat"" - Печатает все строки из идентификатора результата, созданного + Функция печатает все строки из идентификатора результата, который создали функцией odbc_exec. Результат печатается в формате HTML-таблицы. Данные не экранируются. - Функция не предназначена для использования в производственной среде; - она должна использоваться при разработке для быстрого получения - результирующего набора. + Функция не предназначена для производственной среды; + функцией пользуются при разработке, чтобы быстро получить + результирующий набор. @@ -58,8 +58,8 @@ &reftitle.returnvalues; - Возвращает количество строк в результате или &false; в случае возникновения - ошибки. + Функция возвращает количество строк в результате или &false;, + если возникла ошибка. @@ -78,7 +78,7 @@ 8.1.0 - Функция объявлена устаревшей. + Функция устарела. diff --git a/reference/xml/functions/xml-set-object.xml b/reference/xml/functions/xml-set-object.xml index 5f0ef6c80..594f29b2d 100644 --- a/reference/xml/functions/xml-set-object.xml +++ b/reference/xml/functions/xml-set-object.xml @@ -1,10 +1,10 @@ - + xml_set_object - Использование XML-анализатора внутри объекта + Устанавливает XML-парсер внутри объекта @@ -14,15 +14,16 @@ &reftitle.description; + #[\Deprecated] truexml_set_object XMLParserparser objectobject - Эта функция позволяет использовать parser внутри - объекта object. Все callback-функции могут быть - установлены функциями xml_set_element_handler - и т.п. и использоваться как методы объекта object. + Функция разрешает использовать парсер parser внутри + объекта object. Callback-функции + устанавливаются функциями наподобие xml_set_element_handler + и вызываются как методы объекта object. @@ -42,7 +43,7 @@ object - Объект, в котором будет использоваться XML-анализатор. + Объект, в котором будет вызываться XML-анализатор. @@ -71,8 +72,8 @@ 8.4.0 - Функция устарела, вместо неё передавайте соответствующие - значения типа callable в функции xml_set_. + Функция устарела, вместо неё передают правильные + значения с типом callable в функции xml_set_. &xml.changelog.parser-param; @@ -85,10 +86,11 @@ &reftitle.examples; - Пример использования <function>xml_set_object</function> + Пример установки XML-парсера внутри объекта функцией <function>xml_set_object</function> parse("PHP"); + ?> ]]> diff --git a/reference/zip/functions/zip-close.xml b/reference/zip/functions/zip-close.xml index 7711f1a49..2d9517493 100644 --- a/reference/zip/functions/zip-close.xml +++ b/reference/zip/functions/zip-close.xml @@ -1,5 +1,5 @@ - + @@ -14,11 +14,12 @@ &reftitle.description; + #[\Deprecated] voidzip_close resourcezip - Закрывает дескриптор ZIP-архива. + Функция закрывает дескриптор ZIP-архива. @@ -29,7 +30,7 @@ zip - ZIP-файл должен быть открыт с помощью функции zip_open. + ZIP-файл, который прежде открыли функцией zip_open. @@ -58,7 +59,8 @@ 8.0.0 - Функция устарела в пользу Object API, смотрите ZipArchive::close. + Функция устарела в пользу объектно-ориентированного API, + смотрите описание метода ZipArchive::close. diff --git a/reference/zip/functions/zip-entry-close.xml b/reference/zip/functions/zip-entry-close.xml index b538a0937..ba473696e 100644 --- a/reference/zip/functions/zip-entry-close.xml +++ b/reference/zip/functions/zip-entry-close.xml @@ -1,5 +1,5 @@ - + @@ -14,11 +14,12 @@ &reftitle.description; + #[\Deprecated] boolzip_entry_close resourcezip_entry - Закрывает заданный дескриптор директории. + Функция закрывает заданный дескриптор директории. @@ -29,7 +30,7 @@ zip_entry - Дескриптор директории, ранее открытый функцией zip_entry_open. + Дескриптор директории, который прежде открыли функцией zip_entry_open. @@ -58,7 +59,7 @@ 8.0.0 - Функция устарела в пользу Object API. + Функция устарела в пользу объектно-ориентированного API. diff --git a/reference/zip/functions/zip-entry-compressedsize.xml b/reference/zip/functions/zip-entry-compressedsize.xml index bb4876723..5f3200532 100644 --- a/reference/zip/functions/zip-entry-compressedsize.xml +++ b/reference/zip/functions/zip-entry-compressedsize.xml @@ -1,5 +1,5 @@ - + @@ -14,11 +14,12 @@ &reftitle.description; + #[\Deprecated] intfalsezip_entry_compressedsize resourcezip_entry - Возвращает сжатый размер заданного дескриптора директории. + Функция возвращает сжатый размер заданного дескриптора директории. @@ -29,7 +30,7 @@ zip_entry - Дескриптор директории, возвращаемый функцией zip_read. + Дескриптор директории, который возвращает функция zip_read. @@ -39,7 +40,7 @@ &reftitle.returnvalues; - Сжатый размер дескриптора директории&return.falseforfailure;. + Функция возвращает сжатый размер дескриптора директории&return.falseforfailure;. @@ -58,7 +59,8 @@ 8.0.0 - Функция устарела в пользу Object API, смотрите ZipArchive::statIndex. + Функция устарела в пользу объектно-ориентированного API, + смотрите описание метода ZipArchive::statIndex. diff --git a/reference/zip/functions/zip-entry-compressionmethod.xml b/reference/zip/functions/zip-entry-compressionmethod.xml index b76ad86d9..4773b14c8 100644 --- a/reference/zip/functions/zip-entry-compressionmethod.xml +++ b/reference/zip/functions/zip-entry-compressionmethod.xml @@ -1,5 +1,5 @@ - + @@ -14,12 +14,13 @@ &reftitle.description; + #[\Deprecated] stringfalsezip_entry_compressionmethod resourcezip_entry - Возвращает метод сжатия дескриптора директории, - заданного в zip_entry. + Функция возвращает метод сжатия дескриптора директории, + который указали в аргументе zip_entry. @@ -30,7 +31,7 @@ zip_entry - Дескриптор директории, возвращаемый функцией zip_read. + Дескриптор директории, который возвращает функция zip_read. @@ -59,7 +60,8 @@ 8.0.0 - Функция устарела в пользу Object API, смотрите ZipArchive::statIndex. + Функция устарела в пользу объектно-ориентированного API, + смотрите описание метода ZipArchive::statIndex. diff --git a/reference/zip/functions/zip-entry-filesize.xml b/reference/zip/functions/zip-entry-filesize.xml index cae788ae6..f8b20e4e3 100644 --- a/reference/zip/functions/zip-entry-filesize.xml +++ b/reference/zip/functions/zip-entry-filesize.xml @@ -1,5 +1,5 @@ - + @@ -14,11 +14,12 @@ &reftitle.description; + #[\Deprecated] intfalsezip_entry_filesize resourcezip_entry - Возвращает реальный размер заданного дескриптора директории. + Функция возвращает реальный размер заданного дескриптора директории. @@ -29,7 +30,7 @@ zip_entry - Дескриптор директории, возвращаемый функцией zip_read. + Дескриптор директории, который возвращает функция zip_read. @@ -39,7 +40,7 @@ &reftitle.returnvalues; - Реальный размер дескриптора директории&return.falseforfailure;. + Функция возвращает реальный размер дескриптора директории&return.falseforfailure;. @@ -58,7 +59,8 @@ 8.0.0 - Функция устарела в пользу Object API, смотрите ZipArchive::statIndex. + Функция устарела в пользу объектно-ориентированного API, + смотрите описание метода ZipArchive::statIndex. diff --git a/reference/zip/functions/zip-entry-name.xml b/reference/zip/functions/zip-entry-name.xml index dcdfb66e3..a4d9c1718 100644 --- a/reference/zip/functions/zip-entry-name.xml +++ b/reference/zip/functions/zip-entry-name.xml @@ -1,5 +1,5 @@ - + @@ -14,11 +14,12 @@ &reftitle.description; + #[\Deprecated] stringfalsezip_entry_name resourcezip_entry - Возвращает имя заданного дескриптора директории. + Функция возвращает имя заданного дескриптора директории. @@ -29,7 +30,7 @@ zip_entry - Дескриптор директории, возвращаемый функцией zip_read. + Дескриптор директории, который возвращает функция zip_read. @@ -39,7 +40,7 @@ &reftitle.returnvalues; - Имя дескриптора директории&return.falseforfailure;. + Функция возвращает имя дескриптора директории&return.falseforfailure;. @@ -58,7 +59,8 @@ 8.0.0 - Функция устарела в пользу Object API, смотрите ZipArchive::statIndex. + Функция устарела в пользу объектно-ориентированного API, + смотрите описание метода ZipArchive::statIndex. diff --git a/reference/zip/functions/zip-entry-open.xml b/reference/zip/functions/zip-entry-open.xml index 6ccd0a874..c1291c1a3 100644 --- a/reference/zip/functions/zip-entry-open.xml +++ b/reference/zip/functions/zip-entry-open.xml @@ -1,5 +1,5 @@ - + @@ -14,13 +14,14 @@ &reftitle.description; + #[\Deprecated] boolzip_entry_open resourcezip_dp resourcezip_entry stringmode"rb" - Открывает директорию в ZIP-архиве для чтения. + Функция открывает директорию в ZIP-архиве для чтения. @@ -31,7 +32,7 @@ zip_dp - Дескриптор, возвращаемый функцией zip_open. + Дескриптор, который возвращает функция zip_open. @@ -39,7 +40,7 @@ zip_entry - Дескриптор директории, возвращаемый функцией zip_read. + Дескриптор директории, который возвращает функция zip_read. @@ -47,13 +48,13 @@ mode - Доступные режимы приведены в документации к функции + Доступные режимы приводит документация к функции fopen. - В настоящее время параметр mode игнорируется и всегда имеет значение - "rb". Это связано с тем, что ZIP в PHP поддерживается только в режиме чтения. + Функция пока игнорирует параметр mode, а значение параметра + всегда равно "rb". Это связано с тем, что ZIP в PHP поддерживается только в режиме чтения. @@ -69,9 +70,9 @@ В отличие от функции fopen и других подобных функций, значение, - возвращаемое функцией zip_entry_open только информирует нас о - результате выполнения операции и не требуется для последующего чтения или закрытия - дескриптора директории. + которое возвращает функция zip_entry_open, указывает только + результат операции и не требуется для чтения или закрытия + дескриптора каталога. @@ -91,7 +92,7 @@ 8.0.0 - Функция устарела в пользу Object API. + Функция устарела в пользу объектно-ориентированного API. diff --git a/reference/zip/functions/zip-entry-read.xml b/reference/zip/functions/zip-entry-read.xml index aefd52124..319fc5231 100644 --- a/reference/zip/functions/zip-entry-read.xml +++ b/reference/zip/functions/zip-entry-read.xml @@ -1,10 +1,10 @@ - + zip_entry_read - Читает данные из открытого ранее дескриптора директории + Считывает данные из открытого прежде дескриптора каталога @@ -14,12 +14,13 @@ &reftitle.description; + #[\Deprecated] stringfalsezip_entry_read resourcezip_entry intlen1024 - Читает данные из открытого ранее дескриптора директории. + Функция считывает данные из открытого прежде дескриптора каталога. @@ -30,7 +31,7 @@ zip_entry - Дескриптор директории, возвращаемый функцией zip_read. + Дескриптор директории, который возвращает функция zip_read. @@ -38,11 +39,11 @@ len - Число байт, которое нужно считать. + Число байтов, которое требуется считать. - В параметре необходимо указывать объем данных, которые вы хотите считать, + В параметре указывают объём данных, который требуется считать, без учёта сжатия. @@ -54,7 +55,8 @@ &reftitle.returnvalues; - Возвращает считанные данные, пустую строку, если достигнут конец файла, или &false; в случае возникновения ошибки. + Функция возвращает данные, которые считала, пустую строку, + если достигла конца файла, или &false;, если возникла ошибка. @@ -73,7 +75,8 @@ 8.0.0 - Функция устарела в пользу Object API, смотрите ZipArchive::getFromIndex. + Функция устарела в пользу объектно-ориентированного API, + смотрите описание метода ZipArchive::getFromIndex. diff --git a/reference/zip/functions/zip-open.xml b/reference/zip/functions/zip-open.xml index be655758f..30c66dfb5 100644 --- a/reference/zip/functions/zip-open.xml +++ b/reference/zip/functions/zip-open.xml @@ -1,5 +1,5 @@ - + @@ -14,11 +14,12 @@ &reftitle.description; + #[\Deprecated] resourceintfalsezip_open stringfilename - Открывает ZIP-архив для чтения. + Функция открывает ZIP-архив для чтения. @@ -29,7 +30,7 @@ filename - Имя файла ZIP-архива для открытия. + Название файла ZIP-архива, который требуется открыть. @@ -39,10 +40,10 @@ &reftitle.returnvalues; - Возвращает ссылку на ресурс для последующего использования с функциями + Функция возвращает ссылку на ресурс для передачи в функции zip_read и zip_close - либо возвращает номер ошибки, если filename не существует - или в случае другой ошибки. + или возвращает номер ошибки, если файл filename не существует + или возникла ошибка. @@ -61,7 +62,8 @@ 8.0.0 - Функция устарела в пользу Object API, смотрите ZipArchive::open. + Функция устарела в пользу объектно-ориентированного API, + смотрите описание метода ZipArchive::open. diff --git a/reference/zip/functions/zip-read.xml b/reference/zip/functions/zip-read.xml index 079750ccd..2ec4c08cc 100644 --- a/reference/zip/functions/zip-read.xml +++ b/reference/zip/functions/zip-read.xml @@ -1,5 +1,5 @@ - + @@ -14,11 +14,12 @@ &reftitle.description; + #[\Deprecated] resourcefalsezip_read resourcezip - Считывает следующую запись в ZIP-архиве. + Функция считывает следующую запись в ZIP-архиве. @@ -29,7 +30,7 @@ zip - ZIP-файл, предварительно открытый с помощью функции zip_open. + ZIP-файл, который прежде открыли функцией zip_open. @@ -39,9 +40,9 @@ &reftitle.returnvalues; - Возвращает запись каталога для дальнейшего использования с функциями - zip_entry_..., или &false;, если больше нет записей для чтения, - или код ошибки, если она произошла. + Функция возвращает запись каталога для передачи в функции семейства + zip_entry_* или &false;, если записей для чтения не осталось, + или код ошибки, если она возникла. @@ -60,7 +61,8 @@ 8.0.0 - Функция устарела в пользу Object API, смотрите ZipArchive::statIndex. + Функция устарела в пользу объектно-ориентированного API, + смотрите описание метода ZipArchive::statIndex.