# wp_determine_option_autoload_value()

URL: https://chugunov.pro/api-wordpress/functions/wp_determine_option_autoload_value/
Проверено на WordPress 6.9, обновлено 06.08.2026.
Источник: независимый русскоязычный справочник chugunov.pro. Не является официальной документацией WordPress.

Тип: функция.
Появился в версии: 6.6.0.

## Сигнатура

```php
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, если однозначное решение принять не удалось.

## Параметры

- `$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`

```php
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.

## Связанные

Использует: [`apply_filters`](https://chugunov.pro/api-wordpress/functions/apply_filters/).
Используется в: [`update_option`](https://chugunov.pro/api-wordpress/functions/update_option/), [`add_option`](https://chugunov.pro/api-wordpress/functions/add_option/).

Оригинал в официальной документации: https://developer.wordpress.org/reference/functions/wp_determine_option_autoload_value/