get_page_by_title() │ WP 2.1.0

С версии WP 6.2 функция get_page_by_title() была упразднена!

Теперь рекомендуется использовать WP_Query (#57041) или get_posts().

Зачем это нужно? Из-за ограничений, связанных с запросом к БД get_page_by_title() может возвращать разные результаты в зависимости от версии базы данных и/или используемого движка. Переход на WP_Query обеспечит получение одинаковых результатов независимо от настроек вашего сервера.

Однако, надо иметь ввиду, что в отличие от get_page_by_title(), WP_Query может быть использован только во время события plugins_loaded или позже.

Чтобы получить эквивалентный запрос к базе данных через WP_Query, можно использовать следующие аргументы.

$query = new WP_Query(
	[
		'post_type'              => 'page',
		'title'                  => 'Sample Page',
		'post_status'            => 'all',
		'posts_per_page'         => 1,
		'update_post_term_cache' => false,
		'update_post_meta_cache' => false,
		'orderby'                => 'post_date ID',
		'order'                  => 'ASC',
		// get_post like
		'no_found_rows'          => true,
		'ignore_sticky_posts'    => true,
	]
);

if ( $query->post ) {
	$page_got_by_title = $query->post;
}
else {
	$page_got_by_title = null;
}

Того же результата можно добиться и с помощью get_posts(). В этом случае вы можете заменить код на следующий:

$posts = get_posts(
	[
		'post_type'              => 'page',
		'title'                  => 'Sample Page',
		'post_status'            => 'all',
		'posts_per_page'         => 1,
		'update_post_term_cache' => false,
		'update_post_meta_cache' => false,
		'orderby'                => 'post_date ID',
		'order'                  => 'ASC',
	]
);

if ( $posts ) {
	$page_got_by_title = $posts[0];
}
else {
	$page_got_by_title = null;
}

Обеспечение доступности страницы

Из-за прямого запроса к БД, который делается в get_page_by_title(), может получится так, что страница найдена, но юзер не имеет доступа к этой странице и ссылка страницу будет показывать страницу 404 Page Not Found.

Приведенный выше код воспроизводит такое поведение. Если вы хотите избежать этой проблемы, то не указывайте параметр post_status=all в приведенном выше коде.

Подробнее: https://make.wordpress.org/core/2023/03/06/get_page_by_title-deprecated/