mirror of
https://github.com/php/doc-ru.git
synced 2025-07-28 06:39:58 +00:00
Update Password to En (#1031)
* Update constants.xml to En + Infostyle * Update constants.xml * Update setup.xml to En
This commit is contained in:
@ -1,5 +1,5 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: c6532951edb85836f2d49a3c81f8f5e1e41d3554 Maintainer: rjhdby Status: ready -->
|
||||
<!-- EN-Revision: 3010cc4a09e572e8a378934843af1aabeb6273b2 Maintainer: rjhdby Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<appendix xml:id="password.constants" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
&reftitle.constants;
|
||||
@ -14,39 +14,38 @@
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
<constant>PASSWORD_BCRYPT</constant> используется для создания новых
|
||||
хешей паролей используя алгоритм <constant>CRYPT_BLOWFISH</constant>.
|
||||
Константа <constant>PASSWORD_BCRYPT</constant> помогает создавать новые
|
||||
хеши паролей по алгоритму <constant>CRYPT_BLOWFISH</constant>.
|
||||
</para>
|
||||
<para>
|
||||
Результат всегда представляет из себя хеш формата "$2y$" длиной 60 символов.
|
||||
Константа выдаёт хеши в формате шифрования "$2y$" длиной 60 символов.
|
||||
</para>
|
||||
<para>
|
||||
Поддерживаемые опции:
|
||||
Константа поддерживает следующие опции:
|
||||
</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
<literal>salt</literal> (<type>string</type>) - соль для использования при создании хеша пароля.
|
||||
Обратите внимание, что задание этой опции предотвращает автоматическую
|
||||
<literal>salt</literal> (<type>string</type>) — ручное значение соли для хеширования пароля.
|
||||
Обратите внимание, значение переопределит и предотвратит автоматическую
|
||||
генерацию соли.
|
||||
</para>
|
||||
<para>
|
||||
Если не задано, то для каждого хешируемого пароля будет создана случайная соль
|
||||
с помощью функции <function>password_hash</function>. Это является
|
||||
предпочтительным способом, а с PHP 7.0.0 опция salt объявлена
|
||||
устаревшей.
|
||||
При пропуске параметра функция <function>password_hash</function> сгенерирует случайную соль
|
||||
для каждого пароля. Это предпочтительный способ,
|
||||
а с PHP 7.0.0 опцию salt объявили устаревшей.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
<literal>cost</literal> (<type>int</type>) - алгоритмическая стоимость, которую следует использовать.
|
||||
Примеры использования этого значения смотрите на странице описания
|
||||
<literal>cost</literal> (<type>int</type>) — алгоритмическая стоимость генерации хеша.
|
||||
Примеры этих значений приводит страница с описанием
|
||||
функции <function>crypt</function>.
|
||||
</para>
|
||||
<para>
|
||||
Если не задано, то будет использовано значение <literal>10</literal>.
|
||||
Это хорошая базовая стоимость, но вы всегда можете её увеличить в зависимости от
|
||||
имеющихся в вашем распоряжении вычислительных ресурсов.
|
||||
При пропуске параметра функция возьмёт значение по умолчанию — <literal>10</literal>.
|
||||
Это безопасная базовая стоимость, но её часто увеличивают
|
||||
на производительном оборудовании.
|
||||
</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
@ -71,38 +70,38 @@
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
<constant>PASSWORD_ARGON2I</constant> используется для создания новых хешей
|
||||
паролей с помощью алгоритма Argon2i.
|
||||
Константа <constant>PASSWORD_ARGON2I</constant> помогает создавать новые хеши
|
||||
паролей по алгоритму Argon2i.
|
||||
</para>
|
||||
<para>
|
||||
Поддерживаемые опции:
|
||||
Константа поддерживает следующие опции:
|
||||
</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>
|
||||
<literal>memory_cost</literal> (<type>int</type>) - Максимальный размер
|
||||
памяти (в кибибайтах), которую можно использовать для вычисления хеша Argon2.
|
||||
По умолчанию <constant>PASSWORD_ARGON2_DEFAULT_MEMORY_COST</constant>.
|
||||
<literal>memory_cost</literal> (<type>int</type>) - максимальный размер
|
||||
памяти в кибибайтах для вычисления хеша Argon2.
|
||||
Значение по умолчанию равняется <constant>PASSWORD_ARGON2_DEFAULT_MEMORY_COST</constant>.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
<literal>time_cost</literal> (<type>int</type>) - Максимально возможное время
|
||||
которое можно потратить для вычисления хеша Argon2.
|
||||
По умолчанию <constant>PASSWORD_ARGON2_DEFAULT_TIME_COST</constant>.
|
||||
<literal>time_cost</literal> (<type>int</type>) — максимальное время,
|
||||
которое функции разрешается потратить на вычисление хеша Argon2.
|
||||
Значение по умолчанию равняется <constant>PASSWORD_ARGON2_DEFAULT_TIME_COST</constant>.
|
||||
</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>
|
||||
<literal>threads</literal> (<type>int</type>) - Количество потоков, которые
|
||||
можно использовать для вычисления хеша Argon2.
|
||||
По умолчанию <constant>PASSWORD_ARGON2_DEFAULT_THREADS</constant>.
|
||||
Доступно только с libargon2, но не с реализацией libsodium.
|
||||
<literal>threads</literal> (<type>int</type>) — количество потоков
|
||||
для вычисления хеша Argon2.
|
||||
Значение по умолчанию равняется <constant>PASSWORD_ARGON2_DEFAULT_THREADS</constant>.
|
||||
Константа доступна только с модулем libargon2, но не с реализацией через библиотеку libsodium.
|
||||
</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
<para>
|
||||
Доступно с PHP 7.2.0.
|
||||
Константа доступна с PHP 7.2.0.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
@ -113,12 +112,12 @@
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
<constant>PASSWORD_ARGON2ID</constant> используется для создания хешей паролей
|
||||
с помощью алгоритма Argon2id. Поддерживаются те же опции, что и для
|
||||
<link linkend="constant.password-argon2i"><constant>PASSWORD_ARGON2I</constant></link>.
|
||||
Константа <constant>PASSWORD_ARGON2ID</constant> помогает создавать хеши паролей
|
||||
по алгоритму Argon2id. Поддерживаются те же опции,
|
||||
что и для константы <link linkend="constant.password-argon2i"><constant>PASSWORD_ARGON2I</constant></link>.
|
||||
</para>
|
||||
<para>
|
||||
Доступно с PHP 7.3.0.
|
||||
Константа доступна с PHP 7.3.0.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
@ -129,11 +128,11 @@
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Объем памяти в байтах по умолчанию, который будет использоваться при попытке
|
||||
Объем памяти по умолчанию в байтах, который функция использует при попытке
|
||||
вычислить хеш.
|
||||
</para>
|
||||
<para>
|
||||
Доступно с PHP 7.2.0.
|
||||
Константа доступна с PHP 7.2.0.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
@ -147,7 +146,7 @@
|
||||
Ограничение времени по умолчанию на вычисление хеша.
|
||||
</para>
|
||||
<para>
|
||||
Доступно с PHP 7.2.0.
|
||||
Константа доступна с PHP 7.2.0.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
@ -159,7 +158,7 @@
|
||||
<listitem>
|
||||
<para>
|
||||
Количество потоков по умолчанию для библиотеки Argon2lib.
|
||||
Недоступно с реализацией libsodium.
|
||||
Константа недоступна с реализацией через библиотеку libsodium.
|
||||
</para>
|
||||
<para>
|
||||
Доступно с PHP 7.2.0.
|
||||
@ -175,36 +174,31 @@
|
||||
<para>
|
||||
</para>
|
||||
<para>
|
||||
Доступна с PHP 7.4.0.
|
||||
Константа доступна с PHP 7.4.0.
|
||||
</para>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
<varlistentry xml:id="constant.password-default">
|
||||
<term>
|
||||
<constant>PASSWORD_DEFAULT</constant>
|
||||
(<type>mixed</type>)
|
||||
(<type>string</type>)
|
||||
</term>
|
||||
<listitem>
|
||||
<para>
|
||||
Алгоритм хеширования по умолчанию, если не задан принудительно.
|
||||
Может быть изменён в более новых версиях PHP на более надёжный алгоритм.
|
||||
Алгоритм хеширования по умолчанию, если другой алгоритм не указали принудительно.
|
||||
Стандартный алгоритм изменится в новых выпусках PHP, когда в язык включат поддержку
|
||||
новых усиленных алгоритмов хеширования.
|
||||
</para>
|
||||
<para>
|
||||
Стоит отметить, что со временем эта константа может (и, вероятно, так и будет)
|
||||
измениться. Так что имейте в виду, что длина полученного хеша может измениться.
|
||||
Помните, что если вы используете <constant>PASSWORD_DEFAULT</constant>,
|
||||
то предусмотрите для хранения хешей больше чем 60 символов (рекомендуется 255).
|
||||
Из-за вероятного изменения значения константы в будущем
|
||||
изменится и длина результирующего хеша.
|
||||
Поэтому хеши, которые получили через константу <constant>PASSWORD_DEFAULT</constant>,
|
||||
лучше хранить так, чтобы сохранялись хеши произвольной длины.
|
||||
Ширину поля для хранения хешей рекомендуют устанавливать равной <literal>255</literal> байтам.
|
||||
</para>
|
||||
<para>
|
||||
Значения для этой константы:
|
||||
</para>
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<simpara>
|
||||
PHP 5.5.0 - <constant>PASSWORD_BCRYPT</constant>
|
||||
</simpara>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
<simpara>
|
||||
Эта константа — псевдоним константы <constant>PASSWORD_BCRYPT</constant>.
|
||||
</simpara>
|
||||
</listitem>
|
||||
</varlistentry>
|
||||
</variablelist>
|
||||
@ -225,9 +219,9 @@
|
||||
<row>
|
||||
<entry>7.4.0</entry>
|
||||
<entry>
|
||||
Значения идентификаторов алгоритма пароля (<constant>PASSWORD_BCRYPT</constant>, <constant>PASSWORD_ARGON2I</constant>,
|
||||
<constant>PASSWORD_ARGON2ID</constant> и <constant>PASSWORD_DEFAULT</constant>) теперь являются строками (&string;).
|
||||
Ранее они были числами (&integer;).
|
||||
Значения идентификаторов алгоритма пароля — <constant>PASSWORD_BCRYPT</constant>, <constant>PASSWORD_ARGON2I</constant>,
|
||||
<constant>PASSWORD_ARGON2ID</constant> и <constant>PASSWORD_DEFAULT</constant> — стали значениями с типом &string;.
|
||||
Раньше значения принадлежали типу &integer;.
|
||||
</entry>
|
||||
</row>
|
||||
</tbody>
|
||||
|
@ -1,5 +1,5 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<!-- EN-Revision: 48ce43fe79fa0c9f31f187ea8ec995b4cb13037e Maintainer: rjhdby Status: ready -->
|
||||
<!-- EN-Revision: 39b10b2e994f5a39f5face56c5e86ea8507a45a3 Maintainer: rjhdby Status: ready -->
|
||||
<!-- Reviewed: no -->
|
||||
<chapter xml:id="password.setup" xmlns:xlink="http://www.w3.org/1999/xlink">
|
||||
&reftitle.setup;
|
||||
@ -8,9 +8,10 @@
|
||||
&reftitle.required;
|
||||
&no.requirement;
|
||||
<para>
|
||||
Для хеширования паролей через алгоритм Argon2 требуется
|
||||
модуль <link xlink:href="&url.libargon2;">libargon2</link>. Начиная с PHP 7.3.0 требуется
|
||||
модуль libargon2 версии 20161029 или выше.
|
||||
Для хеширования паролей алгоритмом Argon2 требуется
|
||||
библиотека <link xlink:href="&url.libargon2;">libargon2</link> или начиная с PHP 8.4.0
|
||||
библиотека OpenSSL версии 3.2 или новее. Начиная с PHP 7.3.0 требуется
|
||||
библиотека libargon2 версии 20161029 или выше.
|
||||
</para>
|
||||
</section>
|
||||
|
||||
@ -18,11 +19,13 @@
|
||||
&reftitle.install;
|
||||
&no.install;
|
||||
<para>
|
||||
Однако, чтобы включить хеширование паролей алгоритмом Argon2, требуется собрать PHP с поддержкой модуля libargon2
|
||||
через опцию конфигурации <option role="configure">--with-password-argon2</option>.
|
||||
Но чтобы включить хеширование паролей алгоритмом Argon2, потребуется собрать PHP
|
||||
с параметром конфигурации <option role="configure">--with-password-argon2</option> для поддержки модуля libargon2
|
||||
или начиная с PHP 8.4.0 с параметром <option role="configure">--with-openssl</option>
|
||||
для поддержки модуля OpenSSL.
|
||||
</para>
|
||||
<para>
|
||||
До PHP 8.1.0 разрешалось указывать каталог argon2 командой
|
||||
До PHP 8.1.0 разрешали указывать каталог argon2 командой
|
||||
<option role="configure">--with-password-argon2[=DIR]</option>.
|
||||
</para>
|
||||
</section>
|
||||
|
Reference in New Issue
Block a user