force_ssl_admin() │ WP 2.6.0

Визначає чи примусове використання SSL (https) протоколу для адмін-панелі. Дозволяє увімкнути/вимкнути SSL.

Також функція дозволяє увімкнути/вимкнути примусове використання SSL для адмін частини WordPress. Наприклад, якщо викликати функцію з аргументом: force_ssl_admin(false) , цей виклик запам’ятовується і при наступному зверненні до неї вона поверне false .

У функцію ранньому етапі передається значення константи FORCE_SSL_ADMIN, яка встановлюється в wp-config.php . На основі цієї константи функція встановлює, чи потрібно примусово використовувати протокол HTTPS в адмінці.

Використовується в інших функціях для перевірки SSL в адмінці.

Основа для:
set_url_scheme()

Хуків немає.

Повертає

true|false. True, якщо встановлено примусове використання SSL в адмінці. false інакше.

Використання

force_ssl_admin($force);

$force (рядок/логічний): Чи потрібно примусово встановити SSL в адмінці.

Типово: null

Приклади

#1 Зміна значення, що повертається

force_ssl_admin(true);
if ( force_ssl_admin() )
	echo 'Адмінка повинна використовувати SSL';
else
	echo 'Цей код ніколи не виконатися';

force_ssl_admin(false);
if ( force_ssl_admin() )
	echo 'Цей код ніколи не виконатися';
else
	echo 'Адмінка НЕ повинна використовувати SSL';

#2 Примусове перенаправлення на https

Редирект поточної сторінки на https, якщо поточний протокол дорівнює http:

if ( force_ssl_admin() && ! is_ssl() ) {

	if ( 0 === strpos($_SERVER['REQUEST_URI'], 'http') ) {
		wp_redirect( set_url_scheme( $_SERVER['REQUEST_URI'], 'https' ) );
		exit;
	}
	else {
		wp_redirect( 'https://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'] );
		exit;
	}
}

#3 Скидання установок на дефолтні

force_ssl_admin(FORCE_SSL_ADMIN);

список змін

З версії 2.6.0

Введено.

Код `force_ssl_admin() force ssl admin` ^{WP 6.0.2}

wp-includes/functions.php

function force_ssl_admin( $force = null ) {
	static $forced = false;

	if ( ! is_null( $force ) ) {
		$old_forced = $forced;
		$forced = $force;
		return $old_forced;
	}

	return $forced;
}