Что нового в WordPress для разработчиков?

Что меняется

В WordPress 6.9.4 внесены существенные изменения в обработку хуков REST API. Благодаря новой функции группировки хуки теперь можно объявлять более эффективно. Это в первую очередь касается разработчиков плагинов и тем, которые активно используют REST API в своих приложениях.

Проконсультируйтесь билет Trac Для получения подробного технического обзора этого обновления.

Краткое резюме

Введение групповых хуков для REST API.
Улучшена производительность при выполнении хуков.
Снижение потенциальных конфликтов между плагинами.
Обратная совместимость гарантирована, но остерегайтесь устаревших хуков.
Возможное влияние на необновленные плагины.

До/После в коде

До версии WordPress 6.9.4 хуки REST API объявлялись по отдельности:


// Ancienne méthode
add_action('rest_api_init', function() {
    register_rest_route('myplugin/v1', '/endpoint', array(
        'methods' => 'GET',
        'callback' => 'my_callback_function',
    ));
});

В WordPress 6.9.4 появилась возможность группировать хуки для повышения эффективности:


// Nouvelle méthode
add_action_group('rest_api_init', function() {
    register_rest_route('myplugin/v1', '/endpoint', array(
        'methods' => 'GET',
        'callback' => 'my_callback_function',
    ));
    register_rest_route('myplugin/v1', '/another-endpoint', array(
        'methods' => 'POST',
        'callback' => 'another_callback_function',
    ));
});

Группировка позволяет объявлять несколько маршрутов в одном и том же обработчике обратного вызова, что снижает накладные расходы и упрощает обслуживание.

Чтобы проиллюстрировать эффективность этого метода, приведем пример, в котором мы добавляем проверку параметров для каждого маршрута:


// Validation avec hooks groupés
add_action_group('rest_api_init', function() {
    register_rest_route('myplugin/v1', '/endpoint', array(
        'methods' => 'GET',
        'callback' => 'my_callback_function',
        'args' => array(
            'param1' => array(
                'required' => true,
                'validate_callback' => function($param) {
                    return is_string($param);
                }
            )
        )
    ));
    register_rest_route('myplugin/v1', '/another-endpoint', array(
        'methods' => 'POST',
        'callback' => 'another_callback_function',
        'args' => array(
            'param2' => array(
                'required' => true,
                'validate_callback' => function($param) {
                    return is_numeric($param);
                }
            )
        )
    ));
});

Эта централизованная модель проверки повышает читаемость кода и уменьшает его дублирование.

Конкретное воздействие

Это изменение значительно упрощает работу разработчиков, уменьшая сложность объявлений маршрутов. Для агентств и разработчиков тем это означает, что интеграция сложных функций с использованием REST API может осуществляться с меньшим количеством кода и меньшим риском конфликтов.

Существующие плагины могут продолжать работать без немедленных изменений, но разработчикам следует рассмотреть возможность пересмотра своего кода, чтобы воспользоваться преимуществами повышения производительности. Пользователям Divi 5, Elementor и Avada разработчикам пользовательских модулей необходимо будет убедиться, что их расширения адаптированы к этим новым методам для оптимизации производительности.

Риски, совместимость и моменты, требующие особого внимания

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

Изменения в хуках также могут повлиять на настройки REST API, которые не соответствуют новым соглашениям об именовании или группировке. Обратите особое внимание на версии PHP, используемые в вашей среде разработки и производственной среде.

Ещё один важный момент касается локальных сред разработки. Убедитесь, что ваша локальная конфигурация обновлена, чтобы избежать непредвиденных ситуаций во время развертывания.

Как осуществить миграцию

Найдите точки подключения REST API в вашем существующем коде.
Проверьте объявления хуков, чтобы использовать группировки там, где это применимо.
Протестируйте свои плагины и темы в тестовой среде.
Убедитесь, что все зависимости плагина обновлены.
советоваться официальная документация для деталей.
Разработайте поэтапный план развертывания, чтобы минимизировать перебои в работе сервиса.

Действовать сейчас или подождать?

Рекомендуется начать действовать сейчас, чтобы воспользоваться преимуществами повышения производительности и избежать неожиданностей во время будущих обновлений. Однако, если ваша текущая инфраструктура стабильна и не требует новых функций, вы можете запланировать поэтапное обновление.

По моему опыту, слишком долгое ожидание может привести к накоплению технического долга, которым трудно управлять. Если вы используете расширенные возможности REST API, не откладывайте их внедрение.

Советы по техническому обслуживанию

Рекомендуется создать автоматизированную систему тестирования для проверки совместимости ваших плагинов с каждым обновлением WordPress. Регулярно тестируйте свои тестовые сайты перед развертыванием на рабочем сервере и следите за изменениями в примечаниях для разработчиков.

Я часто видел, как веб-сайты ломаются после обновлений из-за некачественного тестирования. Используйте такие инструменты, как PHPUnit, для тестирования функциональности PHP и убедитесь, что все критически важные функции охвачены.

Распространенные ошибки

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

Не пренебрегайте нагрузочным тестированием. Внедрение новых группированных хуков может негативно сказаться на производительности, если они реализованы неправильно. Убедитесь, что ваш сайт сможет выдержать нагрузку после обновления.

Ресурсы

FAQ

Зачем использовать сгруппированные хуки? Для повышения эффективности работы и снижения конфликтности.
Что произойдёт, если я не обновлю свой плагин? В будущем могут возникнуть проблемы с совместимостью.
Следует ли мне обновить систему немедленно? Да, чтобы воспользоваться преимуществами повышения производительности.
Какие инструменты я могу использовать для тестирования своего веб-сайта? Используйте тестовые среды и автоматизированное тестирование.
Это касается всех крючков? Нет, только те, которые связаны с REST API.
Влияет ли группировка хуков на производительность? Да, безусловно, за счет снижения накладных расходов при выполнении нескольких хуков.