# add_blog_option()

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

Тип: функция.
Появился в версии: MU (3.0.0).

## Сигнатура

```php
add_blog_option( int $id, string $option, mixed $value ): bool
```

## Описание

Сериализовать значения не требуется. Если значение нужно сериализовать, оно будет сериализовано перед вставкой в базу данных. Помните, что ресурсы нельзя сериализовать или добавить в качестве опции.
Можно создавать опции без значений, а затем обновлять значения позже.
Существующие опции не обновляются, и выполняются проверки, чтобы вы не добавили защищённую опцию WordPress. Следует избегать имён опций, совпадающих с защищёнными.

## Параметры

- `$id` `int` — обязательный. ID блога. Может быть null для указания на текущий блог.
- `$option` `string` — обязательный. Имя добавляемой опции. Не должно быть экранировано для SQL.
- `$value` `mixed` — обязательный. Значение опции, может быть любым. Не должно быть экранировано для SQL.

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

`bool`

## Исходный код

Файл: `wp-includes/ms-blogs.php:404`

```php
function add_blog_option( $id, $option, $value ) {
	$id = (int) $id;

	if ( empty( $id ) ) {
		$id = get_current_blog_id();
	}

	if ( get_current_blog_id() === $id ) {
		return add_option( $option, $value );
	}

	switch_to_blog( $id );
	$return = add_option( $option, $value );
	restore_current_blog();

	return $return;
}
```

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

- MU (3.0.0) — Introduced.

## Связанные

Использует: [`add_option`](https://chugunov.pro/api-wordpress/functions/add_option/), [`switch_to_blog`](https://chugunov.pro/api-wordpress/functions/switch_to_blog/), [`restore_current_blog`](https://chugunov.pro/api-wordpress/functions/restore_current_blog/), [`get_current_blog_id`](https://chugunov.pro/api-wordpress/functions/get_current_blog_id/).

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