# wp_validate_user_request_key()

URL: https://chugunov.pro/api-wordpress/functions/wp_validate_user_request_key/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 4.9.6.

## Сигнатура

```php
wp_validate_user_request_key( int $request_id, string $key ): true|WP_Error
```

## Описание

Проверяет пользовательский запрос, сравнивая ключ с ключом запроса.

## Параметры

- `$request_id` `int` — обязательный. Идентификатор подтверждаемого запроса.
- `$key` `string` — обязательный. Предоставленный ключ для проверки.

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

`true|WP_Error` — WP_Error

## Исходный код

Файл: `wp-includes/user.php:5054`

```php
function wp_validate_user_request_key(
	$request_id,
	#[\SensitiveParameter]
	$key
) {
	$request_id       = absint( $request_id );
	$request          = wp_get_user_request( $request_id );
	$saved_key        = $request->confirm_key;
	$key_request_time = $request->modified_timestamp;

	if ( ! $request || ! $saved_key || ! $key_request_time ) {
		return new WP_Error( 'invalid_request', __( 'Invalid personal data request.' ) );
	}

	if ( ! in_array( $request->status, array( 'request-pending', 'request-failed' ), true ) ) {
		return new WP_Error( 'expired_request', __( 'This personal data request has expired.' ) );
	}

	if ( empty( $key ) ) {
		return new WP_Error( 'missing_key', __( 'The confirmation key is missing from this personal data request.' ) );
	}

	/**
	 * Filters the expiration time of confirm keys.
	 *
	 * @since 4.9.6
	 *
	 * @param int $expiration The expiration time in seconds.
	 */
	$expiration_duration = (int) apply_filters( 'user_request_key_expiration', DAY_IN_SECONDS );
	$expiration_time     = $key_request_time + $expiration_duration;

	if ( ! wp_verify_fast_hash( $key, $saved_key ) ) {
		return new WP_Error( 'invalid_key', __( 'The confirmation key is invalid for this personal data request.' ) );
	}

	if ( ! $expiration_time || time() > $expiration_time ) {
		return new WP_Error( 'expired_key', __( 'The confirmation key has expired for this personal data request.' ) );
	}

	return true;
}
```

## История изменений

- 4.9.6 — Introduced.

## Связанные

Использует: [`wp_verify_fast_hash`](https://chugunov.pro/api-wordpress/functions/wp_verify_fast_hash/), [`wp_fast_hash`](https://chugunov.pro/api-wordpress/functions/wp_fast_hash/), [`wp_get_user_request`](https://chugunov.pro/api-wordpress/functions/wp_get_user_request/), [`__`](https://chugunov.pro/api-wordpress/functions/__/), [`absint`](https://chugunov.pro/api-wordpress/functions/absint/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/), `WP_Error::__construct`.

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_validate_user_request_key/