Описание функции site_url()
Функция site_url() возвращает URL-адрес сайта, основанный на настройках WordPress. Она используется для получения базового адреса сайта, что удобно для формирования ссылок на ресурсы и страницы. Функция может принимать дополнительный параметр для указания относительного пути к определенному ресурсу на сайте
Возвращаемый URL может быть как с www, так и без, в зависимости от настроек сайта.
Параметры
$path
Тип: string
Обязательный: Нет
По умолчанию: »
Описание: Относительный путь, который будет добавлен к базовому URL сайта
Возможные значения:
Возвращаемое значение
Тип: string
Описание: Возвращает полный URL сайта с добавленным относительным путем
Возможные значения:
• Полный URL сайта, например, ‘https://example.com/’
• URL с указанным путем, например, ‘https://example.com/wp-content/uploads/’
Примеры использования
Базовый пример получения URL сайта
$site_url = site_url();
// Вывод: https://example.com/
Замените example.com на ваш домен
Получение URL для директории загрузок
$uploads_url = site_url('wp-content/uploads/');
// Вывод: https://example.com/wp-content/uploads/
Полезно для построения ссылок на загруженные файлы
Безопасность
Валидация входных данных: Параметр path проходит валидацию внутри функции
Санитизация: Функция автоматически очищает путь
Рекомендации: Избегайте использования пользовательских входных данных без проверки
— Связанные функции
Возвращает URL главной страницы сайта
Возвращает URL админ-панели сайта
— Хуки
Фильтрует возвращаемый URL сайта перед выводом
— Примечания
– Ограничения
Возвращает только корректные URL-адреса, основанные на настройках сайта
– Частые проблемы
- Некорректный URL, если настройки сайта неправильные
- Проблемы с относительными путями, если они не существуют
