Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Модуль Xpass Infostyle #1025

Merged
merged 4 commits into from
Dec 23, 2024
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 4 additions & 4 deletions reference/xpass/book.xml
Original file line number Diff line number Diff line change
Expand Up @@ -9,12 +9,12 @@
<preface xml:id="intro.xpass">
&reftitle.intro;
<simpara>
Модуль предоставляет алгоритмы хеширования паролей,
используемые в дистрибутивах Linux, с помощью расширенной библиотеки crypt.
Модуль работает на основе расширенной библиотеки crypt и предоставляет алгоритмы хеширования паролей,
которые используются в дистрибутивах Linux.
</simpara>
<simpara>
Он также предоставляет дополнительные функции библиотеки libxcrypt,
отсутствующие в ядре PHP.
Модуль также поддерживает дополнительные функции библиотеки libxcrypt,
которых нет в ядре PHP.
</simpara>
</preface>

Expand Down
25 changes: 14 additions & 11 deletions reference/xpass/functions/crypt-checksalt.xml
Original file line number Diff line number Diff line change
Expand Up @@ -14,10 +14,10 @@
<methodparam><type>string</type><parameter>salt</parameter></methodparam>
</methodsynopsis>
<simpara>
Проверяет строку соли на соответствие конфигурации системы и сообщает,
допустимы ли указанные в ней метод и параметры хеширования.
Используется для определения необходимости повторного хеширования пароля пользователя
с использованием предпочтительного метода хеширования.
Функция проверяет, соответствует ли строка соли конфигурации системы, и сообщает,
допустимы ли метод хеширования и параметры, которые содержатся в соли.
Соль определяет, требуется ли повторное хеширование парольной фразы пользователя
текущим предпочтительным методом хеширования.
</simpara>
</refsect1>

Expand All @@ -28,7 +28,7 @@
<term><parameter>salt</parameter></term>
<listitem>
<simpara>
Строка с солью для проверки.
Строка с солью, которую требуется проверить.
</simpara>
</listitem>
</varlistentry>
Expand All @@ -38,30 +38,33 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Функция возвращает целое число (<type>int</type>),
одну из констант CRYPT_SALT_*,
смотрите страницу с <link linkend="xpass.constants">константами Xpass</link>.
Функция возвращает значение с типом <type>int</type> в виде константы
семейства <constant>CRYPT_SALT_<replaceable>*</replaceable></constant>.
</simpara>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример использования функции <function>crypt_checksalt</function></title>
<title>Пример проверки соли функцией <function>crypt_checksalt</function></title>
<programlisting role="php">
<![CDATA[
<?php
// Создание соли для устаревшего метода

// Генерация соли для устаревшего метода
$salt = crypt_gensalt(CRYPT_PREFIX_STD_DES);

// Проверка соли
$test = crypt_checksalt($salt);
var_dump($test === CRYPT_SALT_METHOD_LEGACY);

// Создание соли для метода по умолчанию
// Генерация соли для метода по умолчанию
$salt = crypt_gensalt();

// Проверка соли
$test = crypt_checksalt($salt);
var_dump($test === CRYPT_SALT_OK);

?>
]]>
</programlisting>
Expand Down
29 changes: 16 additions & 13 deletions reference/xpass/functions/crypt-gensalt.xml
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@
<refentry xml:id="function.crypt-gensalt" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>crypt_gensalt</refname>
<refpurpose>Компилирует строку для использования в качестве аргумента salt в crypt</refpurpose>
<refpurpose>Компилирует соль для функции crypt</refpurpose>
</refnamediv>

<refsect1 role="description">
Expand All @@ -15,7 +15,7 @@
<methodparam choice="opt"><type>int</type><parameter>count</parameter><initializer>0</initializer></methodparam>
</methodsynopsis>
<simpara>
Компилирует строку для использования в качестве аргумента salt функции <function>crypt</function>.
Функция компилирует строку, которую передают в функцию <function>crypt</function> как аргумент соли.
</simpara>
</refsect1>

Expand All @@ -26,21 +26,19 @@
<term><parameter>prefix</parameter></term>
<listitem>
<simpara>
Метод хеширования.
Одна из констант CRYPT_PREFIX_*, смотрите страницу с константами <constant>CRYPT_PREFIX_<replaceable>*</replaceable></constant>.
Если указано значение &null;, будет выбран наилучший из доступных методов хеширования.
Метод хеширования в виде константы семейства <constant>CRYPT_PREFIX_<replaceable>*</replaceable></constant>.
При передаче значения &null; функция выберет наилучший из доступных метод хеширования.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>count</parameter></term>
<listitem>
<simpara>
Управляет стоимостью обработки хеша; допустимый диапазон и точное значение параметра count
Управляет ценой обработки хеша; допустимый диапазон и точное значение цены
зависят от метода хеширования, но большие числа соответствуют более дорогим хешам
с точки зрения процессорного времени и, возможно, использования памяти.
Если значение параметра count равно <literal>0</literal>,
будет выбрана низкая стоимость по умолчанию.
с точки зрения процессорного времени и, возможно, выделения памяти.
При передаче в параметр count значения <literal>0</literal> функция выберет низкую цену по умолчанию.
</simpara>
</listitem>
</varlistentry>
Expand All @@ -50,24 +48,29 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Функция возвращает строку с настройками или &null; в случае возникновения ошибки.
Функция возвращает строку с настройками или &null;, если возникла ошибка.
</simpara>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример использования функции <function>crypt_gensalt</function></title>
<title>Пример компиляции соли функцией <function>crypt_gensalt</function></title>
<programlisting role="php">
<![CDATA[
<?php
// Создание соли

// Генерация соли
$salt = crypt_gensalt(CRYPT_PREFIX_BLOWFISH);

// Хеширование пароля
$hash = crypt("secret", $salt);
// Проверка соли

// Проверка хеша
$test = hash_equals(crypt("secret", $hash), $hash);

var_dump($salt, $hash, $test);

?>
]]>
</programlisting>
Expand Down
8 changes: 5 additions & 3 deletions reference/xpass/functions/crypt-preferred-method.xml
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@
<void/>
</methodsynopsis>
<simpara>
Получает префикс предпочтительного метода хеширования.
Функция получает префикс предпочтительного метода хеширования.
</simpara>
</refsect1>

Expand All @@ -26,18 +26,20 @@
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<simpara>
Функция возвращает строку с префиксом или &null; в случае возникновения ошибки.
Функция возвращает строку с префиксом или &null;, если возникла ошибка.
</simpara>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example>
<title>Пример использования функции <function>crypt_preferred_method</function></title>
<title>Пример получения префикса предпочтительного метода хеширования функцией <function>crypt_preferred_method</function></title>
<programlisting role="php">
<![CDATA[
<?php

var_dump(crypt_preferred_method());

?>
]]>
</programlisting>
Expand Down
Loading