Описание функции get_site_url()
Функция get_site_url() возвращает URL главного сайта в сети WordPress (Multisite) или URL текущего сайта. Она полезна для получения базового адреса сайта, используемого для формирования ссылок и перенаправлений.
Функция может использоваться в любых местах, где необходимо получить основной URL сайта, включая темы и плагины.
Параметры
$blog_id
Тип: int
Обязательный: Нет
По умолчанию: get_current_blog_id()
Описание: ID сайта в сети, для которого нужно получить URL
Возможные значения:
Возвращаемое значение
Тип: string
Описание: URL основного сайта или текущего сайта в сети WordPress
Возможные значения:
• Строка с URL сайта при успешном выполнении
• false в случае ошибки
Примеры использования
Базовый пример получения URL текущего сайта
$site_url = get_site_url();
// Вывод: https://example.com
Получение URL сайта с ID 2
$site_url = get_site_url(2);
// Вывод: https://example.com/site2
Проверка на наличие ошибки при получении URL несуществующего сайта
$site_url = get_site_url(999);
if ($site_url === false) {
echo 'Ошибка: сайт не найден';
}
Пример использования в теме для создания ссылки на главную страницу
<?php $site_url = get_site_url();
echo '<a href="' . esc_url($site_url) . '">Главная</a>';
?>
Безопасность
Валидация входных данных: Параметры проходят валидацию внутри функции
Санитизация: Выходные данные автоматически очищаются функцией
Рекомендации: При выводе данных используйте esc_url() для URL
— Связанные функции
Возвращает URL главной страницы сайта
Возвращает URL директории WordPress
— Хуки
Фильтрует URL сайта перед его возвратом
— Примечания
– Ограничения
Функция работает только в контексте WordPress и может вернуть false при некорректном ID сайта
– Частые проблемы
- Возвращение false при неправильном ID сайта
- Ошибки в конфигурации сети могут повлиять на результат
