mirror of
https://github.com/php/doc-ru.git
synced 2025-08-16 18:22:04 +00:00
upd
git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@343537 c90b9560-bf6c-de11-be94-00142212c4b1
This commit is contained in:
Andrey Gromov
@ -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>
|
||||
|
||||
@ -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>
|
||||
|
||||
Reference in New Issue
Block a user