UPDATE_OPTION() │ WP 1.0.0

Функция update_option() используется для обновления значения опции, которая уже была добавлена в WordPress. Если опция не существует, то функция создаст её автоматически. Рассмотрим подробнее как это работает.

Основные моменты

• Вам не нужно сериализовать значения (преобразовывать их в специальный формат). Если значение требует сериализации, это будет сделано автоматически перед вставкой в базу данных.
• Ресурсы (например, подключения к базе данных или файлы) не могут быть сериализованы и добавлены в качестве опций.
• Рекомендуется проверять права пользователя перед обновлением опций для обеспечения безопасности.

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

Функция возвращает true, если значение было обновлено, и false, если обновление не удалось.

Пример использования

Функция вызывается с тремя параметрами:

update_option( $option, $value, $autoload );

• $option (строка, обязательный) — имя опции для обновления. Не должно быть экранировано.
• $value (разное, обязательный) — значение опции. Должно быть сериализуемым, если не является скалярным (числом или строкой).
• $autoload (логическое или null, необязательный) — нужно ли загружать опцию при старте WordPress. Может быть true, false, или null для автоматического определения.

Пример 1: Обновление опции с многомерным массивом

// Сохраним многомерный массив в одной переменной
$multidimensional_options = array(
  'inner_array' => array(
       'foo'   => 'bar',
       'hello' => 'world',
   ),
);

// Обновляем опцию с массивом
update_option( 'my_multi_options', $multidimensional_options );

// Получаем опцию
$my_multi_options = get_option( 'my_multi_options' );

Пример 2: Обновление существующей опции

// Устанавливаем новое значение для опции "my_option"
update_option('my_option', 'new value' );

Пример 3: Обновление опции с автозагрузкой

$newvalue = '255';
update_option( 'extract_length', $newvalue, 'no' );

Если опция не существует, она будет создана автоматически. С версии 4.2 вы можете указать параметр автозагрузки.

Примечание о производительности

Использование слишком большого количества автозагружаемых опций может вызвать проблемы с производительностью, особенно если опции не используются часто. Если опция используется в разных местах на сайте, рекомендуется установить её автозагрузку, используя true. Если опция нужна только на некоторых страницах, лучше установить её без автозагрузки (false).

Примеры обеспечения работоспособности

Если вы хотите убедиться, что опция обновляется только если она не существует или её значение изменилось:

if ( get_option( 'my_option' ) !== $new_value ) {
    update_option( 'my_option', $new_value );
}

Также можно использовать закешированные значения для оптимизации обновлений.

Заключение

Функция update_option() полезна для управления настроенными параметрами вашего сайта на WordPress. Она позволяет легко добавлять и обновлять опции, что делает управление конфигурацией вашего сайта более удобным. Не забудьте проверять и тестировать все изменения, чтобы избежать ненужных ошибок.

Обратите внимание

• Избегайт�� передачи null в качестве значения ($value). Лучше использовать 0, false или пустую строку.
• Опции хранятся в кэше, поэтому всегда очищайте кэш перед обновлением при необходимости.

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

• add_option() — добавляет новую опцию.
• delete_option() — удаляет опцию.
• get_option() — получает значение опции.
• update_site_option() — обновляет опцию для сайта, если используется мультисайт.

Теперь вы знакомы с функцией update_option() в WordPress. Надеюсь, это руководство поможет вам лучше управлять опциями вашего сайта!