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