Как создать автоматический кеш для REST API WordPress с примерами кода

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

Зачем нужен кеш для REST API WordPress

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

Кеширование позволяет сохранить результат API-запроса на определённый промежуток времени и возвращать его без повторных вычислений. Это значительно снижает нагрузку на сервер и ускоряет работу сайта.

Основные преимущества кеширования REST API:

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

Выбор способа кеширования

Для кеширования в WordPress можно использовать различные подходы:

Транзиенты (transients) — встроенный в WordPress механизм временного хранения данных в базе или в объектном кеше.
Объектный кеш (Object Cache) — быстрый кеш в памяти, например Redis или Memcached, если они настроены на сервере.
Файловый кеш — сохранение данных в файлах, но менее эффективно и редко используется.

В этом примере мы остановимся на транзиентах, так как это самый простой и универсальный способ, не требующий дополнительной настройки сервера.

Пример создания кеша для кастомного REST API маршрута

Допустим, у нас есть кастомный REST API маршрут, который возвращает список последних постов. Мы хотим кешировать результат этого запроса на 10 минут.

Добавим следующий код в файл плагина или functions.php вашей темы:

function wpplugins_register_cached_route() {
    register_rest_route('wpplugins/v1', '/latest-posts', array(
        'methods' => 'GET',
        'callback' => 'wpplugins_get_cached_latest_posts',
        'permission_callback' => '__return_true',
    ));
}
add_action('rest_api_init', 'wpplugins_register_cached_route');

function wpplugins_get_cached_latest_posts(WP_REST_Request $request) {
    $cache_key = 'wpplugins_latest_posts_cache';
    $cached = get_transient($cache_key);

    if ($cached !== false) {
        return rest_ensure_response($cached);
    }

    // Если кеша нет, получаем данные
    $args = array(
        'numberposts' => 5,
        'post_status' => 'publish',
    );
    $posts = get_posts($args);
    $data = array();

    foreach ($posts as $post) {
        $data[] = array(
            'id' => $post->ID,
            'title' => get_the_title($post),
            'date' => get_the_date('', $post),
            'link' => get_permalink($post),
        );
    }

    // Сохраняем в кеш на 10 минут
    set_transient($cache_key, $data, 10 * MINUTE_IN_SECONDS);

    return rest_ensure_response($data);
}

В этом коде мы создаем маршрут /wpplugins/v1/latest-posts, который возвращает кешированные данные. При первом запросе данные берутся из базы и сохраняются в транзиент, при последующих — возвращаются из кеша.

Пояснения к коду

Функция get_transient пытается получить кеш. Если кеш отсутствует или истек, возвращается false. Тогда мы формируем ответ, сохраняем его через set_transient и возвращаем.

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

Автоматическая очистка кеша при обновлении контента

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

Добавим следующий код, который сбрасывает кеш при соответствующих действиях:

function wpplugins_clear_latest_posts_cache() {
    delete_transient('wpplugins_latest_posts_cache');
}
add_action('save_post', 'wpplugins_clear_latest_posts_cache');
add_action('delete_post', 'wpplugins_clear_latest_posts_cache');
add_action('wp_trash_post', 'wpplugins_clear_latest_posts_cache');

Теперь при любом изменении постов кеш автоматически удаляется, и при следующем запросе к API данные обновятся.

Использование кеша для стандартных маршрутов REST API

Кешировать можно не только кастомные маршруты, но и стандартные, например, /wp/v2/posts. Однако, для этого потребуется фильтрация запросов и создание промежуточного слоя кеширования.

Один из способов — использовать хук rest_pre_dispatch, который позволяет перехватывать запрос к API и возвращать кеш, если он есть.

Пример простого кеширования для стандартного маршрута:

function wpplugins_cache_rest_response($response, $server, $request) {
    $route = $request->get_route();
    $method = $request->get_method();

    if ($route === '/wp/v2/posts' && $method === 'GET') {
        $cache_key = 'wpplugins_rest_posts_' . md5(serialize($request->get_params()));
        $cached = get_transient($cache_key);

        if ($cached !== false) {
            return rest_ensure_response($cached);
        }

        // Если кеша нет, после формирования ответа сохраним его
        $response_data = $response->get_data();
        set_transient($cache_key, $response_data, 5 * MINUTE_IN_SECONDS);
    }

    return $response;
}
add_filter('rest_post_dispatch', 'wpplugins_cache_rest_response', 10, 3);

Этот код кеширует ответ на запрос постов с параметрами на 5 минут. Ключ кеша формируется с учётом параметров запроса, чтобы кешировать разные варианты отдельно.

Особенности и рекомендации

Для сложных API запросов с большим количеством параметров важно правильно формировать ключ кеша, чтобы избежать конфликтов.
Не все данные хорошо подходят для кеширования — например, данные, зависящие от текущего пользователя или времени, кешировать нужно с осторожностью.
Для мощных проектов лучше использовать внешний объектный кеш (Redis, Memcached) для более быстрой работы.
Обязательно реализуйте очистку кеша при изменении данных, чтобы не показывать пользователям устаревшую информацию.

Плагины для кеширования REST API WordPress

Если вы не хотите писать кеширование самостоятельно, можно использовать готовые решения:

WP REST Cache — простой плагин для кеширования ответов REST API с возможностью настройки времени жизни кеша.
Clearfy Pro — универсальный плагин оптимизации, который содержит функции кеширования и управления API.

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

Выводы и практические советы

Создание автоматического кеша для REST API WordPress значительно повышает производительность сайта, особенно при высокой нагрузке и частых запросах. Использование транзиентов — простой и эффективный способ реализовать кеширование без дополнительного сервера.

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

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