wp_create_nonce()

Примеры использования

Создание токена безопасности

/**
 * Создание токена безопасности.
 *
 * @param string|int $action Optional. Скалярное значение для добавления контекста к токену. По умолчанию: -1.
 * @return string Токен.
 */
function create_security_token($action = -1) {
    $token = wp_create_nonce($action);
    return $token;
}
// Пример использования
$security_token = create_security_token();

Функция wp_create_nonce() используется для создания криптографического токена, связанного с определенным действием, пользователем, пользовательской сессией и временным окном.

В данном примере кода функция create_security_token() принимает опциональный параметр $action, который добавляет контекст к токену. По умолчанию, если параметр не указан, используется значение -1.

Результатом выполнения функции является строковое значение токена безопасности, которое может быть использовано в дальнейшем.

Проверка токена на подлинность

/**
 * Проверка токена на подлинность.
 *
 * @param string $token Токен для проверки.
 * @param string|int $action Optional. Скалярное значение, связанное с токеном. По умолчанию: -1.
 * @return bool True, если токен подлинный. False, если токен недействительный.
 */
function verify_security_token($token, $action = -1) {
    $result = wp_verify_nonce($token, $action);
    return $result;
}
// Пример использования
$is_valid = verify_security_token($security_token);

Функция wp_verify_nonce() используется для проверки подлинности токена безопасности.

В данном примере кода функция verify_security_token() принимает два параметра: $token — токен, который требуется проверить, и $action — опциональный параметр, связанный с токеном. По умолчанию, если параметр не указан, используется значение -1.

Результатом выполнения функции является логическое значение: true, если токен подлинный, и false, если токен недействительный.

Передача токена в URL-адресе

/**
 * Передача токена в URL-адресе.
 *
 * @param string $url URL-адрес, к которому добавляется токен.
 * @param string|int $action Optional. Скалярное значение, связанное с токеном. По умолчанию: -1.
 * @return string URL-адрес с добавленным токеном.
 */
function add_security_token_to_url($url, $action = -1) {
    $url_with_token = wp_nonce_url($url, $action);
    return $url_with_token;
}
// Пример использования
$secure_url = add_security_token_to_url('https://example.com/my-page');

Функция wp_nonce_url() используется для добавления токена безопасности к URL-адресу.

В данном примере кода функция add_security_token_to_url() принимает два параметра: $url — URL-адрес, к которому требуется добавить токен, и $action — опциональный параметр, связанный с токеном. По умолчанию, если параметр не указан, используется значение -1.

Результатом выполнения функции является URL-адрес с добавленным токеном безопасности.

Использование токена в AJAX-запросе

// JavaScript
var securityToken = '<?php echo wp_create_nonce('my_ajax_action'); ?>';
$.ajax({
    url: ajaxurl,
    type: 'POST',
    data: {
        action: 'my_ajax_action',
        security: securityToken,
        // Дополнительные данные для запроса
    },
    success: function(response) {
        // Обработка успешного ответа
    },
    error: function(xhr, status, error) {
        // Обработка ошибки
    }
});

В данном примере кода токен безопасности создается с помощью функции wp_create_nonce() и передается в AJAX-запросе в качестве значения параметра security.

На сервере WordPress можно проверить подлинность токена с помощью функции wp_verify_nonce() и выполнить необходимые действия в зависимости от результата проверки.

Генерация токена для определенного действия

/**
 * Генерация токена для определенного действия.
 *
 * @param string $action Действие, для которого генерируется токен.
 * @return string Токен.
 */
function generate_token_for_action($action) {
    $token = wp_create_nonce($action);
    return $token;
}
// Пример использования
$action_token = generate_token_for_action('my_custom_action');

Функция generate_token_for_action() используется для генерации токена безопасности для определенного действия.

В данном примере кода функция принимает параметр $action, который указывает на конкретное действие, для которого требуется сгенерировать токен.

Результатом выполнения функции является строковое значение токена безопасности, связанное с указанным действием.