Функция SITE_URL() в WordPress

Функция site_url() возвращает URL текущего сайта, где доступны файлы приложения WordPress (например, wp-blog-header.php или папка wp-admin). Она используется для получения правильного адреса сайта с учетом протокола: 'https', если сайт защищен, и 'http' в противном случае.

Возвращаемое значение

Функция возвращает строку с URL сайта, к которому можно добавлять дополнительный путь.

Использование

Функция вызывается следующим образом:

site_url( $path, $scheme );

Параметры

• $path (строка) — Путь относительно URL сайта. По умолчанию: ''.
• $scheme (строка или null) — Протокол для определения контекста URL сайта. Смотрите функцию set_url_scheme(). По умолчанию: null.

Примеры использования

Пример 1: Основное использование функции

$url = site_url();
echo $url;

Вывод:

http://www.example.com или http://www.example.com/wordpress

Это зависит от настроек сайта: Настройки > Основные > URL адрес WordPress.

Пример 2: Все варианты

echo site_url();                     // http://example.com
echo site_url('/');                  // http://example.com/
echo site_url('blog', 'relative');   // /blog
echo site_url('blog');               // https://example.com/blog
echo site_url('/blog', 'https');     // https://example.com/blog
echo site_url('#hash', 'https');     // https://example.com/#hash
echo site_url('//foo.bar/foo');      // http://example.com/foo.bar/foo
echo site_url('http://foo.bar/foo'); // http://example.com/http://foo.bar/foo
echo site_url('/mypage?id=123');     // https://example.com/mypage?id=123

Пример 3: Установка WordPress в подкаталог

Если WordPress установлен в подкаталог, URL будет выглядеть следующим образом:

echo home_url();  // https://example.com
echo site_url();  // https://example.com/wp

Пример 4: Указание первого параметра

$url = site_url('/secrets/', 'https');
echo $url;

Возвращает:

https://example.com/secrets/

Если WordPress установлен в подкаталог, результат будет:

https://example.com/wp/secrets/

Код функции

Функция site_url() реализована в файле wp-includes/link-template.php:

function site_url( $path = '', $scheme = null ) {
    return get_site_url( null, $path, $scheme );
}

Связанные функции

• admin_url()
• home_url()
• get_site_url()
• get_permalink()

Эти функции помогают в работе с URL и могут быть полезны при разработке и настройке сайта на WordPress.

С помощью описанных примеров и объяснений, даже начинающий пользователь сможет понять, как использовать функцию site_url() и конструировать URL для своего сайта.