Функция wp_generate_password() в WordPress с примерами

Функция wp_generate_password() используется для генерации случайных паролей, которые могут содержать буквы, цифры, специальные и дополнительные символы. Эта функция основывается на wp_rand(), что делает её более предсказуемой и безопасной по сравнению с встроенными PHP функциями, такими как rand() или mt_rand().

wp_generate_password( int $length = 12, bool $special_chars = true, bool $extra_special_chars = false ): string

Параметры

• $length (int) (опционально):
  Длина создаваемого пароля.
  По умолчанию: 12
• $special_chars (bool) (опционально):
  Включать ли стандартные специальные символы !@#$%^&*().
  По умолчанию: true
• $extra_special_chars (bool) (опционально):
  Включать ли дополнительные специальные символы -_ []{}<>~+=,.;:/?|. **По умолчанию**: false`

Возвращаемое значение

• string: Возвращает случайно сгенерированный пароль.

Описание

Функция wp_generate_password() генерирует случайный пароль, используя следующие наборы символов:

• Обычные символы: abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789
• Специальные символы: !@#$%^&*()
• Дополнительные специальные символы: -_ []{}<>~+=,.;:/?|`

Эта функция также вызывает фильтр random_password, который позволяет изменять поведение функции через хуки.

Пример 1: Генерация 8-символьного пароля, содержащего только буквы и цифры

<?php echo __( 'Новый пароль: ', 'textdomain' ) . wp_generate_password( 8, false ); ?>

Результат: Пароль, состоящий из букв и цифр длиной 8 символов, например: a8Fd9UiE.

Пример 2: Генерация 10-символьного пароля с буквами, цифрами, специальными и дополнительными символами

<?php echo __( 'Новый пароль: ', 'textdomain' ) . wp_generate_password( 10, true, true ); ?>

Результат: Пароль длиной 10 символов с использованием всех типов символов, например: W$G6@z2~Qk.

Пример 3: Генерация 12-символьного пароля по умолчанию

<?php echo __( 'Новый пароль: ', 'textdomain' ) . wp_generate_password(); ?>

Результат: Пароль длиной 12 символов, содержащий буквы, цифры и специальные символы, например: !fD7UzV8@PaB.

Пример 4: Использование функции для генерации уникального хэша в URL

Вы можете использовать функцию wp_generate_password() для создания уникального хэша, который можно использовать, например, для кеш-бастинга или генерации уникальных реферальных ссылок.

$url = home_url( '/some-location' ); // Получаем URL вашего сайта
$url = add_query_arg( array(
    '_some_param' => wp_generate_password( 32, false, false ) // Генерация уникального хэша
), $url );

wp_safe_redirect( $url ); // Безопасный редирект на новый URL

Особенности функции

• Pluggable функция: Функция wp_generate_password() является pluggable, что означает, что она может быть переопределена из плагина. Однако нужно убедиться, что эта функция вызывается только после подключения всех плагинов (например, через хук plugins_loaded или позднее).
• Хуки:
  • random_password: Позволяет изменять сгенерированный пароль через фильтры.

Заключение

Функция wp_generate_password() предоставляет гибкие возможности для генерации случайных паролей с различными наборами символов и длиной. Её легко использовать как для создания паролей для пользователей, так и для других целей, например, генерации уникальных токенов в URL или секретных ключей.