функция since 6.6.0

wp_determine_option_autoload_value()

Проверено на WordPress 6.9, обновлено Источник: WordPress Developer Resources.

Сигнатура

wp_determine_option_autoload_value( string $option, mixed $value, mixed $serialized_value, bool|null $autoload ): string

Описание

Проверяет переданное значение автозагрузки и возвращает стандартизированное значение ('on', 'off', 'auto-on', 'auto-off' или 'auto') в зависимости от определённых условий.
Если явное значение автозагрузки не передано, функция применяет некоторые эвристики к данной опции.
Она возвращает auto-on для указания автозагрузки, auto-off для указания отсутствия автозагрузки или auto, если однозначное решение принять не удалось.

Оригинал (английский)

This function checks the provided autoload value and returns a standardized value (‘on’, ‘off’, ‘auto-on’, ‘auto-off’, or ‘auto’) based on specific conditions.

If no explicit autoload value is provided, the function will check for certain heuristics around the given option.
It will return auto-on to indicate autoloading, auto-off to indicate not autoloading, or auto if no clear decision could be made.

Параметры

$option string обязательный
Имя опции.
$value mixed обязательный
Значение опции, для которой проверяется значение автозагрузки.
$serialized_value mixed обязательный
Сериализованное значение опции, для которой проверяется значение автозагрузки.
$autoload bool|null обязательный
Проверяемое значение автозагрузки. Принимает 'on'|true для включения или 'off'|false для отключения, либо 'auto-on', 'auto-off' или 'auto' для внутренних нужд. Любое другое значение автозагрузки будет приведено к 'auto-on', 'auto-off' или 'auto'. 'yes' и 'no' поддерживаются для обратной совместимости.

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

string

'auto-on' 'auto-off' 'auto'

Исходный код

wp-includes/option.php:1304

function wp_determine_option_autoload_value( $option, $value, $serialized_value, $autoload ) {

	// Check if autoload is a boolean.
	if ( is_bool( $autoload ) ) {
		return $autoload ? 'on' : 'off';
	}

	switch ( $autoload ) {
		case 'on':
		case 'yes':
			return 'on';
		case 'off':
		case 'no':
			return 'off';
	}

	/**
	 * Allows to determine the default autoload value for an option where no explicit value is passed.
	 *
	 * @since 6.6.0
	 *
	 * @param bool|null $autoload         The default autoload value to set. Returning true will be set as 'auto-on' in the
	 *                                    database, false will be set as 'auto-off', and null will be set as 'auto'.
	 * @param string    $option           The passed option name.
	 * @param mixed     $value            The passed option value to be saved.
	 * @param mixed     $serialized_value The passed option value to be saved, in serialized form.
	 */
	$autoload = apply_filters( 'wp_default_autoload_value', null, $option, $value, $serialized_value );
	if ( is_bool( $autoload ) ) {
		return $autoload ? 'auto-on' : 'auto-off';
	}

	return 'auto';
}

История изменений

ВерсияОписание
6.6.0 Introduced.

Что будем искать? Например,Продвижение

Этот сайт использует куки-файлы. Оставаясь на сайте, Вы соглашаетесь на их использование. Для получения дополнительной информации, пожалуйста, ознакомьтесь с политикой в отношении персональных данных.