From 5d7fd9f5ad14fd4c2bb5211f95c79f41d28d1e44 Mon Sep 17 00:00:00 2001 From: Alexey Pyltsyn Date: Sat, 24 Feb 2018 13:54:33 +0000 Subject: [PATCH] Password hashing: improvements git-svn-id: https://svn.php.net/repository/phpdoc/ru/trunk@344344 c90b9560-bf6c-de11-be94-00142212c4b1 --- language-snippets.ent | 2 +- reference/password/constants.xml | 16 +++++++-------- .../password/functions/password-hash.xml | 20 +++++++++---------- 3 files changed, 19 insertions(+), 19 deletions(-) diff --git a/language-snippets.ent b/language-snippets.ent index 109109f0c..2cc978f61 100644 --- a/language-snippets.ent +++ b/language-snippets.ent @@ -670,7 +670,7 @@ linkend="memcached.expiration" xmlns="http://docbook.org/ns/docbook">Время password_hash.'> -Константы алгоритмов хеширования паролей".'> +Константы алгоритмов хеширования паролей.'> diff --git a/reference/password/constants.xml b/reference/password/constants.xml index be92e685a..f9df6761b 100644 --- a/reference/password/constants.xml +++ b/reference/password/constants.xml @@ -28,20 +28,20 @@ - salt (тип string) - соль для использования при создании хеша пароля. + salt (string) - соль для использования при создании хеша пароля. Обратите внимание, что задание этой опции предотвращает автоматическую генерацию соли. Если не задано, то для каждого хешируемого пароля будет создана случайная соль - с помощью функции password_hash. Является - предпочтительным способом, кроме того, с PHP 7.0.0, опция salt объявлена + с помощью функции password_hash. Это является + предпочтительным способом, а с PHP 7.0.0 опция salt объявлена устаревшей. - cost (тип integer) - алгоритмическая стоимость, которую следует использовать. + cost (integer) - алгоритмическая стоимость, которую следует использовать. Примеры использования этого значения смотрите на странице описания функции crypt. @@ -70,21 +70,21 @@ - memory_cost (тип integer) - Максимальный размер + memory_cost (integer) - Максимальный размер памяти (в байтах), которую можно использовать для вычисления хеша Argon2. По умолчанию PASSWORD_ARGON2_DEFAULT_MEMORY_COST. - time_cost (тип integer) - Максимально возможное время + time_cost (integer) - Максимально возможное время которое можно потратить для вычисления хеша Argon2. По умолчанию PASSWORD_ARGON2_DEFAULT_TIME_COST. - threads (тип integer) - Количество потоков, которые + threads (integer) - Количество потоков, которые можно использовать для вычисления хеша Argon2. По умолчанию PASSWORD_ARGON2_DEFAULT_THREADS. @@ -99,7 +99,7 @@ PASSWORD_ARGON2_DEFAULT_MEMORY_COST (тип integer) - + ы Количество памяти по умолчанию (в байтах), которую может использовать diff --git a/reference/password/functions/password-hash.xml b/reference/password/functions/password-hash.xml index 9393fc1ed..56d414dc1 100644 --- a/reference/password/functions/password-hash.xml +++ b/reference/password/functions/password-hash.xml @@ -98,21 +98,21 @@ - memory_cost (тип integer) - Максимальный размер + memory_cost (integer) - Максимальный размер памяти (в байтах), которую можно использовать для вычисления хеша Argon2. По умолчанию PASSWORD_ARGON2_DEFAULT_MEMORY_COST. - time_cost (тип integer) - Максимально возможное время + time_cost (integer) - Максимально возможное время^ которое можно потратить для вычисления хеша Argon2. По умолчанию PASSWORD_ARGON2_DEFAULT_TIME_COST. - threads (тип integer) - Количество потоков, которые + threads (integer) - Количество потоков, которые можно использовать для вычисления хеша Argon2. По умолчанию PASSWORD_ARGON2_DEFAULT_THREADS. @@ -134,7 +134,7 @@ Использование алгоритма PASSWORD_BCRYPT приведёт к обрезанию поля password до максимальной длины - в 72 символа. + 72 символа. @@ -165,11 +165,11 @@ &reftitle.returnvalues; - Возвращает хешированный пароль, &return.falseforfailure;. + Возвращает хешированный пароль &return.falseforfailure;. Использованный алгоритм, стоимость и соль будут возвращены как часть хеша. - Таким образом, информация необходимая для проверки хеша будет в него + Таким образом, информация, ынеобходимая для проверки хеша будет в него включена. Это позволит функции password_verify проверять хеш без необходимости отдельного хранения информации о соли и алгоритме. @@ -299,14 +299,14 @@ echo "Оптимальная стоимость: " . $cost; ]]> &example.outputs.similar; @@ -346,7 +346,7 @@ Argon2 hash: $argon2i$v=19$m=1024,t=2,p=2$YzJBSzV4TUhkMzc3d3laeg$zqU/1IN0/AogfP4 Любой новый алгоритм должен присутствовать в ядре как минимум 1 полный релиз PHP для того, чтобы его можно было установить по умолчанию. - Таким образом если, к примеру, новый алгоритм был добавлен в + Таким образом, если, к примеру, новый алгоритм был добавлен в 7.5.5, то задать по умолчанию его можно будет только в 7.7 (7.6 будет тем самым полным релизом, в течение которого он должен присутствовать, от 7.6.0 до 7.7.0). Но если новый алгоритм добавлен в 7.6.0, то его также можно будет задать по умолчанию @@ -395,7 +395,7 @@ Argon2 hash: $argon2i$v=19$m=1024,t=2,p=2$YzJBSzV4TUhkMzc3d3laeg$zqU/1IN0/AogfP4 password_verify crypt - пользовательская реализация + Пользовательская реализация