Функция status_header() устанавливает указанный HTTP статус в заголовок ответа сервера. Это может быть полезно для указания состояния страницы, например, 200 (OK) или 404 (Not Found).
В WordPress заголовки HTTP устанавливаются автоматически для всех страниц: 200 для существующих страниц, 404 для несуществующих и так далее. Однако в некоторых случаях может понадобиться переопределить установленный статус. Для этого функцию status_header() следует вызывать во время события wp или позже, например, в событиях template_redirect или template_include.
Эта функция используется в классе WP при установке среды запроса перед событием wp в методах WP::send_headers() и WP::handle_404().
Важные моменты
- До вывода контента:
status_header()должна быть вызвана до вывода любой информации на экран. Иначе возникнет PHP ошибка, так как заголовки должны устанавливаться до вывода контента. - PHP обертка: Эта функция является оберткой для PHP функции
header(). - Описание статусов: Работает на основе функции
get_status_header_desc().
status_header( $header, $description = '' );- $header (число): Код состояния HTTP. Обязательный параметр.
- $description (строка): Описание для заголовка. По умолчанию: ».
Пример 1: Закрытие сайта от индексации
Предположим, вы хотите изменить код статуса для всех страниц и закрыть сайт от индексации. Для этого добавьте следующий код в functions.php:
add_action( 'wp', function() {
status_header( 503 );
} );Пример 2: Установка заголовка состояния 403 (доступ запрещен)
Этот пример показывает, как отправить заголовок состояния 403, если пользователь пытается получить доступ к защищенной странице.
function restrict_access_to_page() {
if ( is_page( 'protected-page' ) && ! current_user_can( 'manage_options' ) ) {
status_header( 403 );
wp_die( 'Доступ запрещен. У вас нет прав для просмотра этой страницы.' );
}
}
add_action( 'template_redirect', 'restrict_access_to_page' );В этом примере функция проверяет, является ли текущая страница защищенной (protected-page) и имеет ли текущий пользователь право доступа (manage_options). Если пользователь не имеет права доступа, отправляется заголовок 403 и выводится сообщение об ошибке.
Пример 3: Установка статуса 404 для неактивных событий
Если нужно установить статус 404 для всех типов записей event, когда событие не активно, используйте следующий код:
add_action( 'template_redirect', 'genius_404_my_event', 1 );
function genius_404_my_event() {
global $post, $wp_query;
// Проверяем, является ли текущая запись записью типа 'event'
if ( is_singular( 'event' ) && ! genius_event_should_be_available( $post->ID ) ) {
// Устанавливаем статус 404
$wp_query->set_404();
status_header(404);
// Выводим шаблон 404
include( get_query_template( '404' ) );
exit;
}
}
// Функция для проверки доступности события
function genius_event_should_be_available($post_id) {
// Здесь реализуется логика проверки, активно ли событие
// Например, проверка мета-поля 'active'
$is_active = get_post_meta( $post_id, 'active', true );
return $is_active === 'yes';
}
Заключение
Функция status_header() полезна для управления заголовками состояния HTTP в WordPress. Она позволяет легко отправлять различные коды состояния в зависимости от ситуации, обеспечивая правильную обработку запросов на сервере. Используя эту функцию, вы можете улучшить управление доступом и обработку ошибок на вашем сайте.