set_url_scheme() WP 3.4.0

Устанавливает протокол http(s) для указного URL и выбранного типа URL. Если в тип указать 'relative', то получит относительную ссылку.

Хуки из функции:

Возвращает

Строку. Измененный URL под выбранную схему.

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

set_url_scheme( $url, $scheme );

$url(строка) (обязательный)

URL содержащий протокол http(s).

$scheme(строка/null)

Схема в соответствии с которой нужно изменять URL. Может быть: http, https, relative, login, login_post, admin, rest, rpc, или null.

Типы: вроде login устанавливают протокол в соответствии с тем, который должен использоваться на странице данного типа.
По умолчанию: null

Примеры

#1 Подправим URL под нужный протокол.

Демонстрация изменения протокола в URL в зависимости от установленной схемы.

echo set_url_scheme( 'http://site.ru/foo', 'https' );    //> https://site.ru/foo
echo set_url_scheme( 'http://site.ru/foo', 'relative' ); //> /foo
echo set_url_scheme( '//site.ru/foo', 'relative' );      //> /foo
echo set_url_scheme( 'https://site.ru/foo', 'http' );    //> http://site.ru/foo

Не работает с относительными URL

echo set_url_scheme( '/foo', 'https' );          //> /foo
echo set_url_scheme( '//site.ru/foo', 'https' ); //> /foohttps://site.ru/foo

Код set_url_scheme: wp-includes/link-template.php ^{VER 4.9.8}

<?php
function set_url_scheme( $url, $scheme = null ) {
	$orig_scheme = $scheme;

	if ( ! $scheme ) {
		$scheme = is_ssl() ? 'https' : 'http';
	} elseif ( $scheme === 'admin' || $scheme === 'login' || $scheme === 'login_post' || $scheme === 'rpc' ) {
		$scheme = is_ssl() || force_ssl_admin() ? 'https' : 'http';
	} elseif ( $scheme !== 'http' && $scheme !== 'https' && $scheme !== 'relative' ) {
		$scheme = is_ssl() ? 'https' : 'http';
	}

	$url = trim( $url );
	if ( substr( $url, 0, 2 ) === '//' )
		$url = 'http:' . $url;

	if ( 'relative' == $scheme ) {
		$url = ltrim( preg_replace( '#^\w+://[^/]*#', '', $url ) );
		if ( $url !== '' && $url[0] === '/' )
			$url = '/' . ltrim($url , "/ \t\n\r\0\x0B" );
	} else {
		$url = preg_replace( '#^\w+://#', $scheme . '://', $url );
	}

	/**
	 * Filters the resulting URL after setting the scheme.
	 *
	 * @since 3.4.0
	 *
	 * @param string      $url         The complete URL including scheme and path.
	 * @param string      $scheme      Scheme applied to the URL. One of 'http', 'https', or 'relative'.
	 * @param string|null $orig_scheme Scheme requested for the URL. One of 'http', 'https', 'login',
	 *                                 'login_post', 'admin', 'relative', 'rest', 'rpc', or null.
	 */
	return apply_filters( 'set_url_scheme', $url, $scheme, $orig_scheme );
}

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

Из метки: ssl

Еще из раздела: Форматирование