☰
WORDPRESS / PRACTICE

Как найти, что изменяет опцию WordPress

Как найти, что изменяет опцию WordPress

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

Проверка таблицы wp_options покажет только текущее значение, но не объяснит, кто его перезаписал. Для этого можно временно подключить MU-плагин с фильтром pre_update_option_имя_опции. Он запишет момент изменения и цепочку вызовов PHP, по которой обычно удается найти источник проблемы.

Почему опции WordPress изменяются без очевидной причины

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

Плагин может не просто один раз записать значение при активации. Он способен проверять опцию при каждом запросе и исправлять ее, если считает текущее значение неправильным. Другой распространенный сценарий — страница настроек передает неполный массив, а код плагина сохраняет его поверх предыдущего, теряя часть параметров.

Наиболее частые источники таких изменений:

  • плагин с собственной страницей настроек;
  • дочерняя или кастомная тема;
  • WP-Cron, Action Scheduler или другой планировщик;
  • импорт или миграция сайта;
  • REST API, AJAX-запрос или CLI-команда;
  • callback, подключенный через update_option или другой фильтр;
  • код, который напрямую изменяет таблицу базы данных.

Что проверить до установки трассировки

Сначала убедитесь, что изменяется именно та опция, которую вы отслеживаете. Название в таблице wp_options может отличаться от названия поля в форме настроек. Для массивов также важно различать всю опцию и отдельный ключ внутри нее: WordPress сохраняет массив как одно значение.

Сопоставьте время изменения с событиями на сайте. Если значение изменяется только в определенное время, подозревайте cron или внешнюю интеграцию. Если это происходит сразу после открытия страницы настроек, вероятен код самой страницы или автоматическая проверка конфигурации.

Полезно временно зафиксировать:

  • точное название опции;
  • старое и ожидаемое значения;
  • URL или действие, после которого происходит изменение;
  • повторяется ли проблема в административной части, на фронтенде или только в cron;
  • какие плагины или тему недавно обновляли либо настраивали.

Как подключить MU-плагин для трассировки

Создайте файл trace-option.php в каталоге wp-content/mu-plugins/. MU-плагины загружаются автоматически и не требуют активации через административную панель. Если каталога mu-plugins нет, его можно создать вручную.

В примере ниже замените my_option на фактическое название опции. Приоритет 999 нужен для того, чтобы увидеть значение после большинства других фильтров. Трассировщик не изменяет данные — он лишь передает новое значение дальше по цепочке.

Код намеренно не записывает старое и новое значения. Опция может содержать пароли, токены, API-ключи или персональные данные, поэтому для первичной диагностики достаточно названия опции и backtrace.

Убедитесь, что журнал ошибок PHP или WordPress включен в контролируемой среде. Если error_log() не записывает сообщения, проверьте настройки логирования хостинга и WP_DEBUG_LOG.

<?php

$trace_option = 'my_option';

add_filter(
    'pre_update_option_' . $trace_option,
    function ($new_value, $old_value, $option_name) {
        if ($new_value === $old_value) {
            return $new_value;
        }

        $request_uri = isset($_SERVER['REQUEST_URI'])
            ? $_SERVER['REQUEST_URI']
            : 'CLI/cron';

        error_log(sprintf(
            '[option-trace] Changed %s; request=%s; backtrace=%s',
            $option_name,
            $request_uri,
            wp_debug_backtrace_summary()
        ));

        return $new_value;
    },
    999,
    3
);

Как читать запись в журнале

После установки трассировщика повторите действие, которое вызывает проблему: откройте нужную страницу, сохраните настройки или дождитесь выполнения запланированной задачи. Затем найдите в журнале строку с меткой [option-trace].

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

Backtrace не всегда напрямую показывает строку кода, которая записала значение. Он может отображать только путь к update_option(), особенно если изменение произошло через абстракцию настроек. В таком случае:

  • найдите в коде плагина все вызовы update_option() и delete_option();
  • выполните поиск названия опции во всем каталоге плагина;
  • проверьте callback-обработчики на admin_init, init, rest_api_init, wp_ajax_* и cron-хуках;
  • посмотрите, не вызывается ли сохранение в обработчике страницы настроек;
  • сравните приоритеты callback-обработчиков, если опцию изменяют несколько компонентов.

Что делать, если трассировщик ничего не показывает

Фильтр pre_update_option_имя_опции срабатывает при обновлении уже существующей опции через стандартный Options API. Он не охватывает все возможные способы изменения данных, поэтому отсутствие записи не означает, что проблема исчезла.

Проверьте следующие варианты:

  • значение добавляется впервые через add_option(), а не обновляется через update_option();
  • изменяется site option в сетевой установке, для которой нужны фильтры pre_update_site_option_*;
  • код выполняет прямой SQL-запрос к wp_options;
  • вы отслеживаете неправильное название опции;
  • изменяется не сама опция, а кеш, transient или значение в другом хранилище;
  • запись попадает в другой файл, например в лог PHP-FPM, веб-сервера или CLI-процесса.

Типичные ошибки при диагностике

Не стоит сразу запрещать изменение, возвращая из фильтра старое значение. Такой подход может скрыть проблему, нарушить сохранение корректных настроек или вызвать повторные попытки записи. Сначала установите источник, а блокировку используйте только как кратковременную аварийную меру.

Также не следует записывать в журнал полные значения опции без маскировки. Большие сериализованные массивы быстро увеличивают объем логов, а их содержимое может включать секреты. Если сравнение значений необходимо, записывайте только тип, размер массива, хеш или отдельные безопасные ключи.

Еще одна ошибка — оставить MU-плагин на production после завершения проверки. Backtrace создается при каждом изменении, а интенсивное логирование может увеличить нагрузку и размер файлов. После получения доказательств удалите файл или отключите код и очистите временные журналы в соответствии с политикой безопасности.

Как исправить первопричину

Когда виновный компонент найден, проверьте логику, которая формирует новое значение. Часто проблема заключается не в самом update_option(), а в том, что код передает неполный массив, применяет значения по умолчанию при каждом запросе или считает пустое значение признаком поврежденной конфигурации.

Для настроек-массивов безопаснее сначала получить текущую опцию, изменить только нужный ключ и сохранить результат. При обработке форм проверяйте разрешенные поля, типы данных и права пользователя. Не запускайте запись при каждом запросе без необходимости — обновляйте опцию только тогда, когда значение действительно изменилось.

Если причиной является сторонний плагин, проверьте его обновления, известные ошибки и совместимость. В staging-среде можно временно отключить подозрительный компонент и повторить сценарий. Если проблема исчезает, исправление лучше внести в плагин, его конфигурацию или собственный интеграционный код, а не маскировать симптом фильтром.

Частые вопросы

Можно ли трассировать все изменения опций сразу?

Технически можно подключить общий фильтр pre_update_option, но на активном сайте это создаст много лишних записей и шума в журнале. Лучше начать с конкретной опции, которая изменяется неожиданно.

Покажет ли backtrace точный плагин, изменивший опцию?

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

Почему значение изменяется, но фильтр не срабатывает?

Возможно, используется add_option(), update_site_option(), прямой SQL-запрос или изменяется другое хранилище. Также проверьте название опции, процесс cron и файл, в который записываются сообщения.

Безопасно ли оставлять этот MU-плагин на production?

Только на короткое время и при ограниченном логировании. Backtrace может содержать внутренние названия классов, пути и контекст запроса, а частые записи увеличивают нагрузку. После диагностики трассировщик нужно удалить.

Вывод

Для поиска неожиданных изменений опций не обязательно сразу анализировать всю базу данных. Временный фильтр pre_update_option_имя_опции позволяет увидеть момент записи и контекст, в котором она произошла.

Используйте трассировку как диагностический инструмент: найдите компонент, проверьте его логику, исправьте формирование значения и удалите MU-плагин после завершения проверки. Это надежнее, чем безусловно блокировать обновление опции и оставлять настоящую причину неисправности скрытой.

← Все материалы WordPress