set_url_scheme() WP 3.4.0
Устанавливает протокол для указного URL. Если в $scheme указать relative, то получит относительную ссылку.
Работает на основе: is_ssl(), force_ssl_admin()
1 раз — 0.000017 сек (очень быстро) | 50000 раз — 0.07 сек (скорость света) | PHP 7.0.2, WP 4.4.1
Хуки из функции
Возвращает
Строку. Измененный URL под выбранную схему.
Использование
set_url_scheme( $url, $scheme );
- $url(строка) (обязательный)
- URL содержащий протокол http(s).
- $scheme(строка/null)
Схема в соответствии с которой нужно изменять URL. Может быть:
http https relative — вернет относительный URL (без домена). login — протокол страницы авторизации login_post admin rest rpc null — текущий протокол сайта is_ssl()
По умолчанию: null
Примеры
#1 Подправим URL под нужный протокол.
Демонстрация изменения протокола в URL в зависимости от установленной схемы.
echo set_url_scheme( 'http://example.com/foo', 'https' ); //> https://example.com/foo echo set_url_scheme( 'http://example.com/foo', 'relative' ); //> /foo echo set_url_scheme( '//site.ru/foo', 'relative' ); //> /foo echo set_url_scheme( 'http://example.com/foo', 'http' ); //> http://example.com/foo
Не работает с относительными URL
echo set_url_scheme( '/foo', 'https' ); //> /foo echo set_url_scheme( '//site.ru/foo', 'https' ); //> /foohttp://example.com/foo
Список изменений
С версии 3.4.0 | Введена. |
С версии 4.4.0 | The 'rest' scheme was added. |