Функция home_url() в WordPress позволяет получить URL главной страницы сайта, которая доступна для пользователей. Это полезный инструмент для создания ссылок на главную страницу и управления маршрутизацией.
home_url( string $path = '', string|null $scheme = null ): string
Параметры:
- $path:
string(необязательный) — Путь, который будет добавлен к URL. По умолчанию''. - $scheme:
string|null(необязательный) — Схема, определяющая протокол URL. Принимает значения'http','https','relative', илиnull. По умолчанию определяется черезis_ssl().
Возвращаемое значение: строка с URL главной страницы с добавленным необязательным путем.
Пример 1: Получение основного URL сайта
Чтобы получить основной URL главной страницы, используйте следующую команду:
$url = home_url();
echo $url;
// http://www.example.comОбратите внимание, что в результате отсутствует слэш на конце.
Пример 2: Получение URL с добавлением слэша
Если вы хотите добавить слэш в конец URL, вы можете указать путь как '/:
$url = home_url('/');
echo $url;
// http://www.example.com/Пример 3: Принудительное указание протокола
Можно также принудительно указать протокол, например, https:
$url = home_url('/', 'https');
echo $url;
// https://www.example.com/Пример 4: Получение относительного URL
Если вам нужно получить относительный путь, это можно сделать следующим образом:
$url = home_url('example', 'relative');
echo $url;
// /exampleПример 5: Использование параметров в URL
Вы также можете добавлять параметры к URL:
$url = esc_url(home_url('/mypage?id=456'));
echo $url;
// https://www.example.com/mypage?id=456Используйте esc_url() для обеспечения чистоты URL и избежания возможных уязвимостей.
Дополнительные сведения
- Функция
home_url()возвращает значение опцииhome, которую можно установить в настройках WordPress. Протокол будет'https', если выполняется условиеis_ssl(), иначе используется'http'. - Если вам нужно получить значение из файла
wp-config.php, можно определить константуWP_HOME, и тогда функция будет использовать её значение вместо значения из базы данных. - В случае мультисайтовой установки используйте
get_home_url(), чтобы получить ссылку на другой сайт в сети сайтов, а не на текущий.
Заключение
Функция home_url() — это мощный инструмент для получения URL главной страницы сайта в WordPress. Она позволяет гибко настраивать путь и протокол, что делает её незаменимой для создания ссылок и навигации по сайту.