wp_redirect()

Перенаправляет на другую страницу
Функция WordPress
INT 1.5.1
WordPress Icon
Содержание
  1. Описание функции
  2. Примеры использования
  3. Перенаправление на главную страницу сайта
  4. Перенаправление на внутреннюю страницу сайта
  5. Перенаправление на внешний URL
  6. Перенаправление с указанием статуса ответа
  7. Перенаправление с указанием приложения-источника
  8. Перенаправление с отменой
  9. Вопросы и ответы
  10. Как использовать функцию wp_redirect() для перенаправления на другую страницу?
  11. Как изменить HTTP статус код при использовании функции wp_redirect()?
  12. Как использовать функцию wp_redirect() для перенаправления на внешний URL?
  13. Как изменить приложение, выполняющее перенаправление при использовании функции wp_redirect()?
  14. Как отменить перенаправление, выполненное с помощью функции wp_redirect()?
  15. Как использовать функцию wp_redirect() для перенаправления на страницу с HTTPS протоколом?
  16. Как использовать функцию wp_redirect() для перенаправления на страницу с HTTP протоколом?
  17. Как использовать функцию wp_redirect() для перенаправления на страницу с определенным HTTP статус кодом?
  18. Как использовать функцию wp_redirect() для перенаправления на страницу с определенным приложением, выполняющим перенаправление?
  19. Связанные элементы

Описание функции

Функция wp_redirect() используется для перенаправления пользователя на другую страницу или URL. Она отправляет соответствующий HTTP-заголовок и перенаправляет пользователя на указанную страницу или URL.

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

Использование

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

Функция wp_redirect() принимает три параметра: $location, $status и $x_redirect_by.

$location (обязательный) — путь или URL для перенаправления.

$status (необязательный) — код HTTP-ответа, который будет использоваться. По умолчанию установлено значение 302 (Moved Temporarily).

$x_redirect_by (необязательный) — приложение, выполняющее перенаправление. По умолчанию установлено значение ‘WordPress’.

Функция wp_redirect() возвращает значение true, если перенаправление было выполнено успешно, и значение false, если перенаправление было отменено.

<?php
// Перенаправление на главную страницу сайта
wp_redirect( home_url() );
exit;
?>

В этом примере мы используем функцию wp_redirect() для перенаправления пользователя на главную страницу сайта. Функция home_url() возвращает URL главной страницы сайта. Затем мы вызываем функцию exit, чтобы прекратить выполнение скрипта после перенаправления.

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

Перенаправление на главную страницу сайта


/**
 * Redirect to the home page of the site.
 */
wp_redirect( home_url() );
exit;

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

Перенаправление на внутреннюю страницу сайта


/**
 * Redirect to a specific internal page.
 */
wp_redirect( get_permalink( $post_id ) );
exit;

В данном примере используется функция get_permalink() для получения URL указанной страницы по ее идентификатору $post_id. Функция wp_redirect() перенаправляет пользователя на указанный URL, а затем вызывается функция exit для прекращения выполнения текущего скрипта.

Перенаправление на внешний URL


/**
 * Redirect to an external URL.
 */
wp_redirect( 'https://example.com' );
exit;

В данном примере указывается прямой URL адрес внешнего сайта. Функция wp_redirect() перенаправляет пользователя на указанный URL, а затем вызывается функция exit для прекращения выполнения текущего скрипта.

Перенаправление с указанием статуса ответа


/**
 * Redirect with a custom HTTP response status code.
 */
wp_redirect( 'https://example.com', 301 );
exit;

В данном примере указывается URL адрес внешнего сайта и код состояния HTTP-ответа 301 (Moved Permanently). Функция wp_redirect() перенаправляет пользователя на указанный URL с указанным кодом состояния, а затем вызывается функция exit для прекращения выполнения текущего скрипта.

Перенаправление с указанием приложения-источника


/**
 * Redirect with a custom application source.
 */
wp_redirect( 'https://example.com', 302, 'MyApp' );
exit;

В данном примере указывается URL адрес внешнего сайта, код состояния HTTP-ответа 302 (Moved Temporarily) и приложение-источник MyApp. Функция wp_redirect() перенаправляет пользователя на указанный URL с указанным кодом состояния и приложением-источником, а затем вызывается функция exit для прекращения выполнения текущего скрипта.

Перенаправление с отменой


/**
 * Redirect with cancellation.
 */
if ( ! is_user_logged_in() ) {
    wp_redirect( 'https://example.com' );
    exit;
}

В данном примере проверяется, авторизован ли пользователь. Если пользователь не авторизован, то происходит перенаправление на указанный URL. Если пользователь авторизован, то перенаправление не выполняется. Функция wp_redirect() возвращает значение false, если перенаправление было отменено, и значение true в противном случае.

Вопросы и ответы

Как использовать функцию wp_redirect() для перенаправления на другую страницу?

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

Для использования функции необходимо передать два обязательных параметра:

  • $location — путь или URL для перенаправления
  • $status — необязательный параметр, указывающий HTTP-код ответа. По умолчанию установлено значение 302 (Moved Temporarily)

Пример использования функции:


  wp_redirect( '/новая-страница' );
  exit;

Как изменить HTTP статус код при использовании функции wp_redirect()?

При использовании функции wp_redirect() можно изменить HTTP статус код ответа.

Для этого необходимо передать вторым параметром нужное значение кода.

Пример использования функции с изменением HTTP статус кода:


  wp_redirect( '/новая-страница', 301 );
  exit;

Как использовать функцию wp_redirect() для перенаправления на внешний URL?

Функция wp_redirect() также может быть использована для перенаправления на внешний URL.

Для этого необходимо передать полный URL в качестве значения параметра $location.

Пример использования функции для перенаправления на внешний URL:


  wp_redirect( 'https://example.com', 302 );
  exit;

Как изменить приложение, выполняющее перенаправление при использовании функции wp_redirect()?

При использовании функции wp_redirect() в WordPress, по умолчанию перенаправление выполняется приложением «WordPress». В некоторых случаях может возникнуть необходимость изменить приложение, выполняющее перенаправление. Для этого можно использовать параметр $x_redirect_by.

Параметр $x_redirect_by принимает строковое значение и позволяет указать другое приложение, которое будет выполнять перенаправление. Например, можно указать свое собственное приложение или плагин, которое будет обрабатывать перенаправление.

Пример использования параметра $x_redirect_by:


wp_redirect( $location, $status, 'MyCustomApp' );

Как отменить перенаправление, выполненное с помощью функции wp_redirect()?

В случае, если необходимо отменить перенаправление, выполненное с помощью функции wp_redirect(), можно использовать возвращаемое значение функции. Функция возвращает значение типа boolean, где true указывает на успешное выполнение перенаправления, а false — на отмену перенаправления.

Пример использования возвращаемого значения:


if ( ! wp_redirect( $location ) ) {
    // Отмена перенаправления
    echo 'Перенаправление отменено!';
    exit;
}

Как использовать функцию wp_redirect() для перенаправления на страницу с HTTPS протоколом?

Для перенаправления на страницу с HTTPS протоколом с использованием функции wp_redirect(), необходимо указать полный URL с протоколом HTTPS в параметре $location.

Пример использования функции wp_redirect() для перенаправления на страницу с HTTPS протоколом:


wp_redirect( 'https://example.com/page' );
exit;

Как использовать функцию wp_redirect() для перенаправления на страницу с HTTP протоколом?

Функция wp_redirect() используется для перенаправления пользователя на другую страницу. Она принимает следующие параметры:

  • $location (обязательный) — путь или URL для перенаправления.
  • $status (необязательный) — HTTP код ответа, который будет использоваться. По умолчанию установлен код 302 (Moved Temporarily).
  • $x_redirect_by (необязательный) — приложение, выполняющее перенаправление. По умолчанию указано ‘WordPress’.

Функция возвращает true, если перенаправление выполнено успешно, и false, если перенаправление было отменено.

Пример использования функции wp_redirect() для перенаправления на страницу с HTTP протоколом:


  $url = 'http://example.com/new-page';
  wp_redirect( $url );
  exit;

Как использовать функцию wp_redirect() для перенаправления на страницу с определенным HTTP статус кодом?

Функция wp_redirect() также позволяет указать определенный HTTP статус код для перенаправления. Для этого нужно передать второй параметр — $status.

Пример использования функции wp_redirect() для перенаправления на страницу с определенным HTTP статус кодом:


  $url = 'http://example.com/new-page';
  $status = 301; // Moved Permanently
  wp_redirect( $url, $status );
  exit;

Как использовать функцию wp_redirect() для перенаправления на страницу с определенным приложением, выполняющим перенаправление?

Параметр $x_redirect_by позволяет указать приложение, которое выполняет перенаправление. По умолчанию указано ‘WordPress’.

Пример использования функции wp_redirect() для перенаправления на страницу с определенным приложением:


  $url = 'http://example.com/new-page';
  $x_redirect_by = 'My Plugin';
  wp_redirect( $url, 302, $x_redirect_by );
  exit;

Функция wp_redirect() позволяет перенаправить пользователя на другую страницу. Она принимает путь или URL для перенаправления, а также опциональные параметры для указания HTTP статус кода и приложения, выполняющего перенаправление. Функция возвращает true, если перенаправление выполнено успешно, и false, если перенаправление было отменено.

Связанные элементы

  • Функция add_action(): регистрирует функцию, которая будет выполнена при возникновении определенного события.
  • Функция add_filter(): регистрирует функцию, которая будет использоваться для изменения значения определенного фильтра.
  • Функция do_action(): вызывает все функции, связанные с определенным событием.
  • Функция apply_filters(): применяет все функции, связанные с определенным фильтром, к указанному значению.
  • Хук init: вызывается при инициализации WordPress и позволяет зарегистрировать функции и фильтры.
  • Хук wp_head: вызывается перед выводом содержимого в секции <head> шаблона WordPress.
  • Хук wp_footer: вызывается перед закрытием тега </body> шаблона WordPress и позволяет добавить дополнительный контент.
  • Класс WP_Query: используется для выполнения запросов к базе данных WordPress и получения соответствующих записей.
  • Класс WP_Post: представляет отдельную запись в WordPress и предоставляет методы для работы с ней.
  • Класс WP_User: представляет пользователя WordPress и предоставляет методы для работы с его данными.
Обсуждение