com doc/ru: Обновлен ие до англи йской верси и: reference/apcu/book.xml reference/array/functio ns/array-key-exists.xml
reference/array/functions/each.xm l reference/openssl/functions/openssl-encrypt.xml referen ce/openssl/functions/openssl-error-string.xml
reference/ope nssl/functions/openssl-free-key.xml reference/openssl/funct ions/openssl-get-curve-names.xml reference/openssl/function
s/openssl-get-publickey.xml reference/openssl/functions/ope nssl-ope

Commit: c6ea1a5d3a5c1fe4c5530c6421211eed8293bab6 Author: Sergey Panteleev <sergey@php.net> Mon, 15 Feb 2021 09:11:06 +0300 Parents: 4261ad699eb7bae3a77bb7502e21e430778f5f4b Branches: master Link: http://git.php.net/?p=doc/ru.git;a=commitdiff;h=c6ea1a5d3a5c1fe4c5530c6421211eed8293bab6 Log: Обновление до английской версии Changed paths: M reference/apcu/book.xml M reference/array/functions/array-key-exists.xml M reference/array/functions/each.xml M reference/openssl/functions/openssl-encrypt.xml M reference/openssl/functions/openssl-error-string.xml M reference/openssl/functions/openssl-free-key.xml M reference/openssl/functions/openssl-get-curve-names.xml M reference/openssl/functions/openssl-get-publickey.xml M reference/openssl/functions/openssl-open.xml M reference/openssl/functions/openssl-pbkdf2.xml M reference/strings/functions/soundex.xml

diff --git a/reference/apcu/book.xml b/reference/apcu/book.xml index 130667277..6e8048c29 100644 --- a/reference/apcu/book.xml +++ b/reference/apcu/book.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 0970bf6ea3abcd27673fe4632a1ee62eb9f5223e Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: 12932e34aaa450bdec49f11f5d40570cf56482ea Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: sergey --> <!-- $Revision$ --> <book xml:id="book.apcu" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> @@ -9,6 +9,11 @@ <preface xml:id="intro.apcu"> &reftitle.intro; <para> + APCu - это хранилище "ключ-значение" в памяти для PHP. + Ключи являются строками (&string;), а значения могут быть любыми переменными PHP. + APCu поддерживает только кеширование переменных в пользовательском пространстве. + </para> + <para> APCu - это APC без кеширования опкода. </para> <para> diff --git a/reference/array/functions/array-key-exists.xml b/reference/array/functions/array-key-exists.xml index 87c4f45cf..c4ce5d446 100644 --- a/reference/array/functions/array-key-exists.xml +++ b/reference/array/functions/array-key-exists.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: cd943f94a013b74df8765ab8e1a620a916a64a85 Maintainer: shein Status: ready --> +<!-- EN-Revision: a6655e3f9508eee6860b02f55e33560a790f42d1 Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.array-key-exists" xmlns="http://docbook.org/ns/docbook"> @@ -107,9 +107,7 @@ array_key_exists('first', $search_array); По причинам обратной совместимости, <function>array_key_exists</function> возвращает &true;, если <parameter>key</parameter> является свойством объекта (<type>object</type>), переданным в качестве параметра <parameter>array</parameter>. - На это поведение не стоит полагаться, и перед использованием данной функции - необходимо проверять, что параметр <parameter>array</parameter> имеет тип - <type>array</type>. + Поведение устарело в PHP 7.4.0 и удалено в PHP 8.0.0. </para> <para> Чтобы проверить, содержит ли объект какое-либо свойство, используйте функцию diff --git a/reference/array/functions/each.xml b/reference/array/functions/each.xml index bf683489a..e9cc7d7ca 100644 --- a/reference/array/functions/each.xml +++ b/reference/array/functions/each.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: 755faca201b5ba15e23735f21ed056b47d954398 Maintainer: shein Status: ready --> +<!-- EN-Revision: a6655e3f9508eee6860b02f55e33560a790f42d1 Maintainer: shein Status: ready --> <!-- Reviewed: yes --> <!-- $Revision$ --> <refentry xml:id="function.each" xmlns="http://docbook.org/ns/docbook"> @@ -16,7 +16,7 @@ &reftitle.description; <methodsynopsis> <type>array</type><methodname>each</methodname> - <methodparam><type>array</type><parameter role="reference">array</parameter></methodparam> + <methodparam><type class="union"><type>array</type><type>object</type></type><parameter role="reference">array</parameter></methodparam> </methodsynopsis> <para> Возвращает текущую пару ключ/значение из массива и продвигает вперёд его указатель. diff --git a/reference/openssl/functions/openssl-encrypt.xml b/reference/openssl/functions/openssl-encrypt.xml index 3f2cf8095..e30c964fa 100644 --- a/reference/openssl/functions/openssl-encrypt.xml +++ b/reference/openssl/functions/openssl-encrypt.xml @@ -1,8 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: f467e8922859bc0760f1323575b6729fa3e1f4b2 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> - <refentry xml:id="function.openssl-encrypt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>openssl_encrypt</refname> @@ -14,11 +13,11 @@ <methodsynopsis> <type class="union"><type>string</type><type>false</type></type><methodname>openssl_encrypt</methodname> <methodparam><type>string</type><parameter>data</parameter></methodparam> - <methodparam><type>string</type><parameter>method</parameter></methodparam> - <methodparam><type>string</type><parameter>key</parameter></methodparam> + <methodparam><type>string</type><parameter>cipher_algo</parameter></methodparam> + <methodparam><type>string</type><parameter>passphrase</parameter></methodparam> <methodparam choice="opt"><type>int</type><parameter>options</parameter><initializer>0</initializer></methodparam> <methodparam choice="opt"><type>string</type><parameter>iv</parameter><initializer>""</initializer></methodparam> - <methodparam choice="opt"><type>string</type><parameter role="reference">tag</parameter><initializer>NULL</initializer></methodparam> + <methodparam choice="opt"><type>string</type><parameter role="reference">tag</parameter><initializer>&null;</initializer></methodparam> <methodparam choice="opt"><type>string</type><parameter>aad</parameter><initializer>""</initializer></methodparam> <methodparam choice="opt"><type>int</type><parameter>tag_length</parameter><initializer>16</initializer></methodparam> </methodsynopsis> @@ -41,7 +40,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>method</parameter></term> + <term><parameter>cipher_algo</parameter></term> <listitem> <para> Метод шифрования. Список доступных методов можно получить с помощью функции @@ -50,7 +49,7 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>key</parameter></term> + <term><parameter>passphrase</parameter></term> <listitem> <para> Кодовая фраза. Если кодовая фраза укорочена, чем ожидалось, она автоматически дополняется @@ -116,7 +115,7 @@ &reftitle.errors; <para> Выдаёт ошибку уровня <constant>E_WARNING</constant>, если в параметр - <parameter>method</parameter> передан неизвестный алгоритм шифрования. + <parameter>cipher_algo</parameter> передан неизвестный алгоритм шифрования. </para> <para> Выдаёт ошибку уровня <constant>E_WARNING</constant>, если в параметр @@ -216,7 +215,6 @@ if (hash_equals($hmac, $calcmac))// с PHP 5.6+ сравнение, не под </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/openssl/functions/openssl-error-string.xml b/reference/openssl/functions/openssl-error-string.xml index cdd948f12..72225f579 100644 --- a/reference/openssl/functions/openssl-error-string.xml +++ b/reference/openssl/functions/openssl-error-string.xml @@ -1,8 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: db1a1cfda3fd21187e97a2451f9c0f5412694c0e Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-error-string"> +<refentry xml:id="function.openssl-error-string" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>openssl_error_string</refname> <refpurpose>Возвращает сообщение об ошибке openSSL</refpurpose> @@ -11,7 +11,7 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>string</type><methodname>openssl_error_string</methodname> + <type class="union"><type>string</type><type>false</type></type><methodname>openssl_error_string</methodname> <void/> </methodsynopsis> <para> @@ -48,7 +48,6 @@ while ($msg = openssl_error_string()) </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/openssl/functions/openssl-free-key.xml b/reference/openssl/functions/openssl-free-key.xml index ab48212e2..9566e407e 100644 --- a/reference/openssl/functions/openssl-free-key.xml +++ b/reference/openssl/functions/openssl-free-key.xml @@ -1,23 +1,26 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> - -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-free-key"> +<refentry xml:id="function.openssl-free-key" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>openssl_free_key</refname> <refpurpose>Высвобождение ресурса ключа</refpurpose> </refnamediv> + <refsynopsisdiv> + &warn.deprecated.function-8-0-0; + </refsynopsisdiv> + <refsect1 role="description"> &reftitle.description; <methodsynopsis> <type>void</type><methodname>openssl_free_key</methodname> - <methodparam><type>resource</type><parameter>key_identifier</parameter></methodparam> + <methodparam><type>OpenSSLAsymmetricKey</type><parameter>key</parameter></methodparam> </methodsynopsis> <para> <function>openssl_free_key</function> удаляет ключ, связанный с заданным - идентификатором <parameter>key_identifier</parameter> из памяти. + идентификатором <parameter>key</parameter> из памяти. </para> </refsect1> @@ -26,7 +29,7 @@ <para> <variablelist> <varlistentry> - <term><parameter>key_identifier</parameter></term> + <term><parameter>key</parameter></term> <listitem> <para> </para> @@ -43,8 +46,36 @@ </para> </refsect1> -</refentry> + <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> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>key</parameter> теперь принимает <classname>OpenSSLAsymmetricKey</classname>; + ранее принимала ресурс (&resource;) типа <literal>OpenSSL key</literal>. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> +</refentry> <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/openssl/functions/openssl-get-curve-names.xml b/reference/openssl/functions/openssl-get-curve-names.xml index d7b1391af..b1ba6c18e 100644 --- a/reference/openssl/functions/openssl-get-curve-names.xml +++ b/reference/openssl/functions/openssl-get-curve-names.xml @@ -1,8 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 0dad2268d5adb19f77270aa2a9515a4bfbca9b22 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> - <refentry xml:id="function.openssl-get-curve-names" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>openssl_get_curve_names</refname> @@ -12,8 +11,8 @@ <refsect1 role="description"> &reftitle.description; <methodsynopsis> - <type>array</type><methodname>openssl_get_curve_names</methodname> - <void /> + <type class="union"><type>array</type><type>false</type></type><methodname>openssl_get_curve_names</methodname> + <void/> </methodsynopsis> <para> Возвращает список доступных имён кривых для для использования @@ -73,7 +72,7 @@ <refsect1 role="returnvalues"> &reftitle.returnvalues; <para> - Массив с доступными именами кривых. + Массив с доступными именами кривых, &return.falseforfailure;. </para> </refsect1> @@ -184,7 +183,6 @@ Array </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/openssl/functions/openssl-get-publickey.xml b/reference/openssl/functions/openssl-get-publickey.xml index 364dc049b..5315a2591 100644 --- a/reference/openssl/functions/openssl-get-publickey.xml +++ b/reference/openssl/functions/openssl-get-publickey.xml @@ -1,6 +1,6 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: 96c9d88bad9a7d7d44bfb7f26c226df7ee9ddf26 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-get-publickey"> @@ -18,7 +18,6 @@ </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/openssl/functions/openssl-open.xml b/reference/openssl/functions/openssl-open.xml index 49146b13e..f86258a61 100644 --- a/reference/openssl/functions/openssl-open.xml +++ b/reference/openssl/functions/openssl-open.xml @@ -1,9 +1,8 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: fd9ba9ab70580571a97ea33dfa07e4c4dd0f724b Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> - -<refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.openssl-open"> +<refentry xml:id="function.openssl-open" xmlns="http://docbook.org/ns/docbook"> <refnamediv> <refname>openssl_open</refname> <refpurpose>Открыть запечатанные данные</refpurpose> @@ -13,19 +12,19 @@ &reftitle.description; <methodsynopsis> <type>bool</type><methodname>openssl_open</methodname> - <methodparam><type>string</type><parameter>sealed_data</parameter></methodparam> - <methodparam><type>string</type><parameter role="reference">open_data</parameter></methodparam> - <methodparam><type>string</type><parameter>env_key</parameter></methodparam> - <methodparam><type>mixed</type><parameter>priv_key_id</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>method</parameter><initializer>"RC4"</initializer></methodparam> - <methodparam choice="opt"><type>string</type><parameter>iv</parameter></methodparam> + <methodparam><type>string</type><parameter>data</parameter></methodparam> + <methodparam><type>string</type><parameter role="reference">output</parameter></methodparam> + <methodparam><type>string</type><parameter>encrypted_key</parameter></methodparam> + <methodparam><type class="union"><type>OpenSSLAsymmetricKey</type><type>OpenSSLCertificate</type><type>array</type><type>string</type></type><parameter>private_key</parameter></methodparam> + <methodparam><type>string</type><parameter>cipher_algo</parameter></methodparam> + <methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>iv</parameter><initializer>&null;</initializer></methodparam> </methodsynopsis> <para> <function>openssl_open</function> открывает (дешифрует) - <parameter>sealed_data</parameter>, используя секретный ключ, связанный - с идентификатором <parameter>priv_key_id</parameter> и ключ обёртки - <parameter>env_key</parameter>, и заполняет - <parameter>open_data</parameter> расшифрованными данными. + <parameter>data</parameter>, используя секретный ключ, связанный + с идентификатором <parameter>private_key</parameter> и ключ обёртки + <parameter>encrypted_key</parameter>, и заполняет + <parameter>output</parameter> расшифрованными данными. Ключ обёртки создаётся при запечатывании данных и может использоваться только с одним единственным секретным ключом. Более подробно можно прочитать на странице описания функции <function>openssl_seal</function>. @@ -37,14 +36,14 @@ <para> <variablelist> <varlistentry> - <term><parameter>sealed_data</parameter></term> + <term><parameter>data</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>open_data</parameter></term> + <term><parameter>output</parameter></term> <listitem> <para> При удачном завершении, переменная переданная в этом параметре @@ -53,21 +52,21 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>env_key</parameter></term> + <term><parameter>encrypted_key</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>priv_key_id</parameter></term> + <term><parameter>private_key</parameter></term> <listitem> <para> </para> </listitem> </varlistentry> <varlistentry> - <term><parameter>method</parameter></term> + <term><parameter>cipher_algo</parameter></term> <listitem> <para> Метод шифрования. @@ -99,6 +98,36 @@ </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> + <parameter>private_key</parameter> теперь принимает экземпляр <classname>OpenSSLAsymmetricKey</classname> + или <classname>OpenSSLCertificate</classname>; + ранее принимался ресурс (&resource;) типа <literal>OpenSSL key</literal> или <literal>OpenSSL X.509 CSR</literal>. + </entry> + </row> + <row> + <entry>8.0.0</entry> + <entry> + <parameter>cipher_algo</parameter> больше не является необязательным параметром. + </entry> + </row> + </tbody> + </tgroup> + </informaltable> + </refsect1> + <refsect1 role="examples"> &reftitle.examples; <para> @@ -142,7 +171,6 @@ openssl_free_key($pkeyid); </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/openssl/functions/openssl-pbkdf2.xml b/reference/openssl/functions/openssl-pbkdf2.xml index 3912611de..29e042466 100644 --- a/reference/openssl/functions/openssl-pbkdf2.xml +++ b/reference/openssl/functions/openssl-pbkdf2.xml @@ -1,8 +1,7 @@ <?xml version="1.0" encoding="utf-8"?> <!-- $Revision$ --> -<!-- EN-Revision: b95d28e6ec86e4a71e012737d36ebdc1cf009180 Maintainer: rjhdby Status: ready --> +<!-- EN-Revision: d1e3ea622e5d4f542cd36eca59a9f22aa0142633 Maintainer: rjhdby Status: ready --> <!-- Reviewed: yes Maintainer: lex --> - <refentry xml:id="function.openssl-pbkdf2" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink"> <refnamediv> <refname>openssl_pbkdf2</refname> @@ -17,7 +16,7 @@ <methodparam><type>string</type><parameter>salt</parameter></methodparam> <methodparam><type>int</type><parameter>key_length</parameter></methodparam> <methodparam><type>int</type><parameter>iterations</parameter></methodparam> - <methodparam choice="opt"><type>string</type><parameter>digest_algorithm</parameter><initializer>"sha1"</initializer></methodparam> + <methodparam choice="opt"><type>string</type><parameter>digest_algo</parameter><initializer>"sha1"</initializer></methodparam> </methodsynopsis> <para> <function>openssl_pbkdf2</function> вычисляет PBKDF2 (Password-Based Key Derivation @@ -64,11 +63,11 @@ </listitem> </varlistentry> <varlistentry> - <term><parameter>digest_algorithm</parameter></term> + <term><parameter>digest_algo</parameter></term> <listitem> <para> Опциональный алгоритм хеширования полученный из - <function>openssl_get_md_methods</function>. По умолчанию SHA-1. + <function>openssl_get_md_methods</function>. По умолчанию SHA-1. </para> </listitem> </varlistentry> @@ -116,7 +115,6 @@ echo base64_encode($generated_key)."\n"; </refsect1> </refentry> - <!-- Keep this comment at the end of the file Local variables: mode: sgml diff --git a/reference/strings/functions/soundex.xml b/reference/strings/functions/soundex.xml index 0ae8dc431..03fda97bf 100644 --- a/reference/strings/functions/soundex.xml +++ b/reference/strings/functions/soundex.xml @@ -1,5 +1,5 @@ <?xml version="1.0" encoding="utf-8"?> -<!-- EN-Revision: e095023e408c8cb6378ae16bb6870343a3946919 Maintainer: shein Status: ready --> +<!-- EN-Revision: 230b56bf45d3871657573097a2be90d77ed2bfc8 Maintainer: shein Status: ready --> <!-- Reviewed: yes Maintainer: sergey --> <!-- $Revision$ --> <refentry xml:id="function.soundex" xmlns="http://docbook.org/ns/docbook"> @@ -21,8 +21,7 @@ Двум словам, имеющим схожее произношение, соответствует один и тот же ключ soundex. Это свойство может быть использовано, например, при поиске по базе данных, когда известно произношение слова и неизвестно - его написание. Данная функция возвращает строку из 4 символов, - начинающуюся с буквы. + его написание. </para> <para> Данная реализация функции soundex описана Дональдом Кнутом (Donald @@ -51,6 +50,9 @@ &reftitle.returnvalues; <para> Возвращает ключ soundex в виде строки (&string;). + Возвращает ключ soundex в виде строки (&string;) с четырьмя символами. + Если в <parameter>string</parameter> содержится хотя бы одна буква, + возвращаемая строка начинается с буквы. В противном случае возвращается <literal>"0000"</literal>. </para> </refsect1>