VladPolskiy/php-doc-ru
1
0
Fork 0
mirror of https://github.com/php/doc-ru.git synced 2025-08-16 18:22:04 +00:00
Code Issues Packages Projects Releases Wiki Activity

upd

Browse Source 
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@343537 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Andrey Gromov
2017-11-30 16:26:58 +00:00
parent 52b5f01658
commit 684e662d98
7 changed files with 275 additions and 37 deletions
Download Patch File Download Diff File Expand all files Collapse all files

85
reference/ldap/constants.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: a05b9183bec9b2d9778065820745f292d552cb09 Maintainer: mch Status: ready -->
<!-- EN-Revision: a791c271a68ac290d318294fe791ac3117e5e695 Maintainer: mch Status: ready -->
<!-- Reviewed: no -->
<!-- $Revision$ -->
@ -14,7 +14,7 @@
</term>
<listitem>
<simpara>
Правило разыменования псевдонимов - Never.
</simpara>
</listitem>
</varlistentry>
@ -25,7 +25,7 @@
</term>
<listitem>
<simpara>
Правило разыменования псевдонимов - Searching.
</simpara>
</listitem>
</varlistentry>
@ -36,7 +36,7 @@
</term>
<listitem>
<simpara>
Правило разыменования псевдонимов - Finding.
</simpara>
</listitem>
</varlistentry>
@ -47,7 +47,7 @@
</term>
<listitem>
<simpara>
Правило разыменования псевдонимов - Always.
</simpara>
</listitem>
</varlistentry>
@ -129,7 +129,7 @@
</term>
<listitem>
<simpara>
Последний код ошибки сессии.
</simpara>
</listitem>
</varlistentry>
@ -151,7 +151,7 @@
</term>
<listitem>
<simpara>
Определяет, следует ли неявно перезапустить соединение.
</simpara>
</listitem>
</varlistentry>
@ -162,7 +162,7 @@
</term>
<listitem>
<simpara>
Устанавливает/получает разделенные пробелами хосты при попытке подключения.
</simpara>
</listitem>
</varlistentry>
@ -173,7 +173,7 @@
</term>
<listitem>
<simpara>
Псевдоним для <constant>LDAP_OPT_DIAGNOSTIC_MESSAGE</constant>.
</simpara>
</listitem>
</varlistentry>
@ -184,7 +184,7 @@
</term>
<listitem>
<simpara>
Последнее сообщение об ошибке в сессии.
</simpara>
</listitem>
</varlistentry>
@ -195,7 +195,7 @@
</term>
<listitem>
<simpara>
Устанавливает/получает проверяемые DN связанные с соединением.
</simpara>
</listitem>
</varlistentry>
@ -395,7 +395,7 @@
</term>
<listitem>
<simpara>
Устанавливает/получает случайный файл когда один из системных файлов по умолчанию не доступен.
</simpara>
</listitem>
</varlistentry>
@ -423,7 +423,7 @@
</term>
<listitem>
<simpara>
Режим аутентификации SSL - аутентификация не требуется (Только для Oracle LDAP)
</simpara>
</listitem>
</varlistentry>
@ -434,7 +434,7 @@
</term>
<listitem>
<simpara>
Режим аутентификации SSL - требуется только серверная аутентификация (Только для Oracle LDAP)
</simpara>
</listitem>
</varlistentry>
@ -445,7 +445,62 @@
</term>
<listitem>
<simpara>
Режим аутентификации SSL - требуется как серверная, так и клиентская аутентификация (Только для Oracle LDAP)
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ldap-exop-start-tls">
<term>
<constant>LDAP_EXOP_START_TLS</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Константа расширенной операции - Start TLS (RFC 4511).
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ldap-exop-modify-passwd">
<term>
<constant>LDAP_EXOP_MODIFY_PASSWD</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Константа расширенной операции - Modify password (RFC 3062).
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ldap-exop-refresh">
<term>
<constant>LDAP_EXOP_REFRESH</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Константа расширенной операции - Refresh (RFC 2589).
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ldap-exop-who-am-i">
<term>
<constant>LDAP_EXOP_WHO_AM_I</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Константа расширенной операции - WHOAMI (RFC 4532).
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.ldap-exop-turn">
<term>
<constant>LDAP_EXOP_TURN</constant>
(<type>integer</type>)
</term>
<listitem>
<simpara>
Константа расширенной операции - Turn (RFC 4531).
</simpara>
</listitem>
</varlistentry>

21
reference/math/functions/mt-rand.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 797064ec67c2c264693b5792fc86fca7b290c7e2 Maintainer: das Status: ready -->
<!-- EN-Revision: adc322146749f7869f4a94d24a98049302f0a6d5 Maintainer: das Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xml:id="function.mt-rand" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -80,6 +80,14 @@
</row>
</thead>
<tbody>
<row>
<entry>7.2.0</entry>
<entry>
Для <function>mt_rand</function> <link linkend="migration72.incompatible.rand-mt_rand-output">произведено исправление бага</link> смещения по модулю. Это означает, что
последовательности сгенерированные с конкретным начальным значением могут
отличаться от сгенерированных в PHP 7.1 для 64-битных машин.
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>
@ -89,11 +97,12 @@
<row>
<entry>7.1.0</entry>
<entry>
<link linkend="migration71.incompatible.fixes-to-mt_rand-algorithm">Функция
<function>mt_rand</function> была обновлена и теперь использует коректную версию
генератора случайных чисел не основе Вихря Мерсена. Для использования
старого поведения, используйте <function>mt_srand</function> со вторым
параметром, установленным в <constant>MT_RAND_PHP</constant>.</link>
Функция <function>mt_rand</function>
<link linkend="migration71.incompatible.fixes-to-mt_rand-algorithm">была обновлена</link>
и теперь использует коректную версию генератора случайных чисел не основе
Вихря Мерсена. Для использования
старого поведения, используйте <function>mt_srand</function> со вторым
параметром, установленным в <constant>MT_RAND_PHP</constant>.
</entry>
</row>
<row>

10
reference/math/functions/rand.xml
View File

@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: ad195a6577da479b6f7d65335a0353ba76a5bf4f Maintainer: shein Status: ready -->
<!-- EN-Revision: adc322146749f7869f4a94d24a98049302f0a6d5 Maintainer: shein Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<refentry xml:id="function.rand" xmlns="http://docbook.org/ns/docbook">
@ -84,6 +84,14 @@
</row>
</thead>
<tbody>
<row>
<entry>7.2.0</entry>
<entry>
Для <function>rand</function> <link linkend="migration72.incompatible.rand-mt_rand-output">произведено исправление бага</link> смещения по модулю. Это означает, что
последовательности сгенерированные с конкретным начальным значением могут
отличаться от сгенерированных в PHP 7.1 для 64-битных машин.
</entry>
</row>
<row>
<entry>7.1.0</entry>
<entry>

9
reference/mcrypt/book.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 1c08f29ab72ea86f07334ce4483e78c3f72a6291 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: bd9add30afc7ba7013cc222ca397cba114a554eb Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
@ -11,6 +11,13 @@
<!-- {{{ preface -->
<preface xml:id="intro.mcrypt">
&reftitle.intro;
<warning>
<simpara>
Это расширение использует старую, неподдерживаемую библиотеку. Вместо него
используйте расширения <link linkend="book.sodium">Libsodium</link>
(доступно с PHP 7.2.0) или <link linkend="book.openssl">OpenSSL</link>.
</simpara>
</warning>
<warning>
<simpara>
Это расширение объявлено устаревшим в PHP 7.1.0 и

14
reference/mcrypt/setup.xml
View File

@ -1,11 +1,11 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8b67dabb5fd5ae6f8b600ea1a7399c297c1cb7ca Maintainer: aur Status: ready -->
<!-- EN-Revision: bd9add30afc7ba7013cc222ca397cba114a554eb Maintainer: aur Status: ready -->
<!-- Reviewed: yes -->
<!-- $Revision$ -->
<chapter xml:id="mcrypt.setup" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.setup;
<!-- {{{ Requirements -->
<section xml:id="mcrypt.requirements">
&reftitle.required;
@ -15,7 +15,7 @@
из <link xlink:href="&url.mcrypt;">&url.mcrypt;</link> и следуйте инструкциям по установке.
</para>
<simpara>
Начиная с PHP 5.0.0 вам понадобится libmcrypt версии 2.5.6 или выше.
Вам понадобится libmcrypt версии 2.5.6 или выше.
</simpara>
<para>
Пользователи Windows могут найти библиотеку в бинарном релизе PHP 5.2 для Windows.
@ -30,15 +30,15 @@
</para>
</section>
<!-- }}} -->
<!-- {{{ Installation -->
&reference.mcrypt.configure;
<!-- }}} -->
<!-- {{{ Configuration -->
&reference.mcrypt.ini;
<!-- }}} -->
<!-- {{{ Resources -->
<section xml:id="mcrypt.resources">
&reftitle.resources;
@ -47,7 +47,7 @@
</para>
</section>
<!-- }}} -->
</chapter>
<!-- Keep this comment at the end of the file

90
reference/password/constants.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 3327d57392eb68a819dc75f4f465f7016908eb37 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 0ed97654e12abc312a191267d58d9ed3284ab008 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<appendix xml:id="password.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -28,7 +28,7 @@
<itemizedlist>
<listitem>
<para>
<literal>salt</literal> - соль для использования при создании хеша пароля.
<literal>salt</literal> (тип <type>string</type>) - соль для использования при создании хеша пароля.
Обратите внимание, что задание этой опции предотвращает автоматическую
генерацию соли.
</para>
@ -41,7 +41,7 @@
</listitem>
<listitem>
<para>
<literal>cost</literal> - алгоритмическая стоимость, которую следует использовать.
<literal>cost</literal> (тип <type>integer</type>) - алгоритмическая стоимость, которую следует использовать.
Примеры использования этого значения смотрите на странице описания
функции <function>crypt</function>.
</para>
@ -54,6 +54,90 @@
</itemizedlist>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.password-argon2i">
<term>
<constant>PASSWORD_ARGON2I</constant>
(<type>integer</type>)
</term>
<listitem>
<para>
<constant>PASSWORD_ARGON2I</constant> используется для создания новых хешей
паролей с помощью алгоритма Argon2.
</para>
<para>
Поддерживаемые опции:
</para>
<itemizedlist>
<listitem>
<para>
<literal>memory_cost</literal> (тип <type>integer</type>) - Максимальный размер
памяти (в байтах), которую можно использовать для вычисления хеша Argon2.
По умолчанию <constant>PASSWORD_ARGON2_DEFAULT_MEMORY_COST</constant>.
</para>
</listitem>
<listitem>
<para>
<literal>time_cost</literal> (тип <type>integer</type>) - Максимально возможное время
которое можно потратить для вычисления хеша Argon2.
По умолчанию <constant>PASSWORD_ARGON2_DEFAULT_TIME_COST</constant>.
</para>
</listitem>
<listitem>
<para>
<literal>threads</literal> (тип <type>integer</type>) - Количество потоков, которые
можно использовать для вычисления хеша Argon2.
По умолчанию <constant>PASSWORD_ARGON2_DEFAULT_THREADS</constant>.
</para>
</listitem>
</itemizedlist>
<para>
Доступно с PHP 7.2.0.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.password-argon2-default-memory-cost">
<term>
<constant>PASSWORD_ARGON2_DEFAULT_MEMORY_COST</constant>
(тип <type>integer</type>)
</term>
<listitem>
<para>
Количество памяти по умолчанию (в байтах), которую может использовать
библиотека Argon2lib для вычисления хеша.
</para>
<para>
Доступно с PHP 7.2.0.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.password-argon2-default-time-cost">
<term>
<constant>PASSWORD_ARGON2_DEFAULT_TIME_COST</constant>
(<type>integer</type>)
</term>
<listitem>
<para>
Ограничение времени по умолчанию на генерацию хеша библиотекой Argon2lib.
</para>
<para>
Доступно с PHP 7.2.0.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.password-argon2-default-threads">
<term>
<constant>PASSWORD_ARGON2_DEFAULT_THREADS</constant>
(<type>integer</type>)
</term>
<listitem>
<para>
Количество потоков по умолчанию для библиотеки Argon2lib.
</para>
<para>
Доступно с PHP 7.2.0.
</para>
</listitem>
</varlistentry>
<varlistentry xml:id="constant.password-default">
<term>
<constant>PASSWORD_DEFAULT</constant>

83
reference/password/functions/password-hash.xml
View File

@ -1,6 +1,6 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 119fb4697ca0ec16858330154a3fdb24e7b22723 Maintainer: rjhdby Status: ready -->
<!-- EN-Revision: 0ed97654e12abc312a191267d58d9ed3284ab008 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: yes -->
<refentry xml:id="function.password-hash" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@ -47,16 +47,21 @@
идентификатора "$2y$". В результате будет сгенерирована строка длиной 60 символов, &return.falseforfailure;.
</simpara>
</listitem>
<listitem>
<simpara>
<constant>PASSWORD_ARGON2I</constant> - Использовать алгоритм хеширования Argon2.
</simpara>
</listitem>
</itemizedlist>
</para>
<simpara>
Поддерживаемые опции:
Поддерживаемые опции для <constant>PASSWORD_BCRYPT</constant>:
</simpara>
<para>
<itemizedlist>
<listitem>
<para>
<literal>salt</literal> - для самостоятельного задания соли для хеширования.
<literal>salt</literal> (<type>string</type>) - для самостоятельного задания соли для хеширования.
Обратите внимание, что это приведет к переопределению и предотвращению
автоматического создания соли.
</para>
@ -74,7 +79,7 @@
</listitem>
<listitem>
<para>
<literal>cost</literal> - задает необходимую алгоритмическую сложность.
<literal>cost</literal> (<type>integer</type>) - задает необходимую алгоритмическую сложность.
Пример использования этого значения можно посмотреть на странице посвященной
функции <function>crypt</function>.
</para>
@ -86,6 +91,34 @@
</listitem>
</itemizedlist>
</para>
<simpara>
Поддерживаемые опции для <constant>PASSWORD_ARGON2I</constant>:
</simpara>
<para>
<itemizedlist>
<listitem>
<para>
<literal>memory_cost</literal> (тип <type>integer</type>) - Максимальный размер
памяти (в байтах), которую можно использовать для вычисления хеша Argon2.
По умолчанию <constant>PASSWORD_ARGON2_DEFAULT_MEMORY_COST</constant>.
</para>
</listitem>
<listitem>
<para>
<literal>time_cost</literal> (тип <type>integer</type>) - Максимально возможное время
которое можно потратить для вычисления хеша Argon2.
По умолчанию <constant>PASSWORD_ARGON2_DEFAULT_TIME_COST</constant>.
</para>
</listitem>
<listitem>
<para>
<literal>threads</literal> (тип <type>integer</type>) - Количество потоков, которые
можно использовать для вычисления хеша Argon2.
По умолчанию <constant>PASSWORD_ARGON2_DEFAULT_THREADS</constant>.
</para>
</listitem>
</itemizedlist>
</para>
</refsect1>
<refsect1 role="parameters">
@ -256,6 +289,24 @@ echo "Оптимальная стоимость: " . $cost;
<screen>
<![CDATA[
Appropriate Cost Found: 10
]]>
</screen>
</example>
</para>
<para>
<example>
<title>Пример использования <function>password_hash</function> с Argon2</title>
<programlisting role="php">
<![CDATA[
<?php
echo 'Argon2 hash: ' . password_hash('rasmuslerdorf', PASSWORD_ARGON2I);
?>
]]>
</programlisting>
&example.outputs.similar;
<screen>
<![CDATA[
Argon2 hash: $argon2i$v=19$m=1024,t=2,p=2$YzJBSzV4TUhkMzc3d3laeg$zqU/1IN0/AogfP4cmSJI1vc8lpXRW9/S0sYY2i2jHT0
]]>
</screen>
</example>
@ -314,6 +365,30 @@ Appropriate Cost Found: 10
</note>
</refsect1>
<refsect1 role="changelog">
&reftitle.changelog;
<para>
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>7.2.0</entry>
<entry>
Добавлена поддержка хеширующего алгоритма Argon2 с помощью <constant>PASSWORD_ARGON2I</constant>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>