# wp_redirect()

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

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

## Сигнатура

```php
wp_redirect( string $location, int $status = 302, string|false $x_redirect_by = 'WordPress' ): bool
```

## Описание

Примечание: wp_redirect() не завершает выполнение автоматически, и почти всегда после него должен следовать вызов exit;:
wp_redirect( $url );
exit;Завершением можно также выборочно управлять, используя wp_redirect() в качестве условия совместно с фильтрами 'wp_redirect' и 'wp_redirect_status':
if ( wp_redirect( $url ) ) {
exit;
}

## Параметры

- `$location` `string` — обязательный. Путь или URL, на который выполняется перенаправление.
- `$status` `int` — необязательный, по умолчанию `302`. Код статуса HTTP-ответа для использования. Значение по умолчанию '302' (Moved Temporarily).
- `$x_redirect_by` `string|false` — необязательный, по умолчанию `'WordPress'`. Приложение, выполняющее перенаправление, или false, чтобы не указывать. Значение по умолчанию 'WordPress'.

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

`bool`

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

Файл: `wp-includes/pluggable.php:1485`

```php
function wp_redirect( $location, $status = 302, $x_redirect_by = 'WordPress' ) {
	global $is_IIS;

	/**
	 * Filters the redirect location.
	 *
	 * @since 2.1.0
	 *
	 * @param string $location The path or URL to redirect to.
	 * @param int    $status   The HTTP response status code to use.
	 */
	$location = apply_filters( 'wp_redirect', $location, $status );

	/**
	 * Filters the redirect HTTP response status code to use.
	 *
	 * @since 2.3.0
	 *
	 * @param int    $status   The HTTP response status code to use.
	 * @param string $location The path or URL to redirect to.
	 */
	$status = apply_filters( 'wp_redirect_status', $status, $location );

	if ( ! $location ) {
		return false;
	}

	if ( $status < 300 || 399 < $status ) {
		wp_die( __( 'HTTP redirect status code must be a redirection code, 3xx.' ) );
	}

	$location = wp_sanitize_redirect( $location );

	if ( ! $is_IIS && 'cgi-fcgi' !== PHP_SAPI ) {
		status_header( $status ); // This causes problems on IIS and some FastCGI setups.
	}

	/**
	 * Filters the value of the `X-Redirect-By` HTTP header.
	 *
	 * Allows applications to identify themselves when they're doing a redirect.
	 *
	 * @since 5.1.0
	 *
	 * @param string|false $x_redirect_by The application doing the redirect or false to omit the header.
	 * @param int          $status        Status code to use.
	 * @param string       $location      The path to redirect to.
	 */
	$x_redirect_by = apply_filters( 'x_redirect_by', $x_redirect_by, $status, $location );
	if ( is_string( $x_redirect_by ) ) {
		header( "X-Redirect-By: $x_redirect_by" );
	}

	header( "Location: $location", true, $status );

	return true;
}
```

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

- 5.4.0 — On invalid status codes, wp_die() is called.
- 5.1.0 — The $x_redirect_by parameter was added.
- 1.5.1 — Introduced.

## Связанные

Использует: [`wp_sanitize_redirect`](https://chugunov.pro/api-wordpress/functions/wp_sanitize_redirect/), [`status_header`](https://chugunov.pro/api-wordpress/functions/status_header/), [`__`](https://chugunov.pro/api-wordpress/functions/__/), [`wp_die`](https://chugunov.pro/api-wordpress/functions/wp_die/), [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: [`do_favicon`](https://chugunov.pro/api-wordpress/functions/do_favicon/), `WP_Recovery_Mode_Link_Service::handle_begin_link`, [`resume_theme`](https://chugunov.pro/api-wordpress/functions/resume_theme/), [`resume_plugin`](https://chugunov.pro/api-wordpress/functions/resume_plugin/), [`wp_media_attach_action`](https://chugunov.pro/api-wordpress/functions/wp_media_attach_action/), `WP_List_Table::set_pagination_args`, [`wp_dashboard_setup`](https://chugunov.pro/api-wordpress/functions/wp_dashboard_setup/), [`activate_plugin`](https://chugunov.pro/api-wordpress/functions/activate_plugin/), [`redirect_post`](https://chugunov.pro/api-wordpress/functions/redirect_post/), [`do_dismiss_core_update`](https://chugunov.pro/api-wordpress/functions/do_dismiss_core_update/), [`do_undismiss_core_update`](https://chugunov.pro/api-wordpress/functions/do_undismiss_core_update/), `WP_Customize_Manager::after_setup_theme`, [`spawn_cron`](https://chugunov.pro/api-wordpress/functions/spawn_cron/), [`wp_safe_redirect`](https://chugunov.pro/api-wordpress/functions/wp_safe_redirect/), [`wp_redirect`](https://chugunov.pro/api-wordpress/functions/wp_redirect/), [`auth_redirect`](https://chugunov.pro/api-wordpress/functions/auth_redirect/), [`wp_old_slug_redirect`](https://chugunov.pro/api-wordpress/functions/wp_old_slug_redirect/), [`wp_not_installed`](https://chugunov.pro/api-wordpress/functions/wp_not_installed/), [`wp_redirect_admin_locations`](https://chugunov.pro/api-wordpress/functions/wp_redirect_admin_locations/), [`redirect_canonical`](https://chugunov.pro/api-wordpress/functions/redirect_canonical/), [`maybe_redirect_404`](https://chugunov.pro/api-wordpress/functions/maybe_redirect_404/), [`wpmu_admin_do_redirect`](https://chugunov.pro/api-wordpress/functions/wpmu_admin_do_redirect/).

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