IndexNow в WordPress: решение проблем с отправкой URL при использовании PHP-FPM

Диагностика проблем с отправкой URL в IndexNow на PHP-FPM

При использовании PHP-FPM в связке с WordPress некоторые разработчики сталкиваются с проблемами отправки URL в IndexNow. Чаще всего это проявляется в виде отсутствия уведомлений поисковым системам о новых или обновленных страницах, а также ошибках в логах сервера, связанных с таймаутами или некорректной работой HTTP-запросов.

Основные симптомы:

• Отсутствие подтверждений успешной отправки URL в IndexNow.
• Ошибки 502 Bad Gateway или 504 Gateway Timeout в логах PHP-FPM.
• Длительное выполнение функций, связанных с отправкой URL.

Для диагностики проблем используйте следующие инструменты:

• error_log и логи PHP-FPM (sudo tail -f /var/log/php7.4-fpm.log или аналогичный для вашей версии PHP).
• WP_DEBUG и плагин Query Monitor для отслеживания ошибок и длительных запросов.
• Проверка сетевых запросов с помощью curl или Postman, чтобы убедиться, что запросы к IndexNow API проходят корректно.

Пошаговое решение: настройка и оптимизация отправки URL через PHP-FPM

1. Увеличение таймаутов PHP-FPM и веб-сервера

В конфигурации PHP-FPM увеличьте значения параметров request_terminate_timeout и max_execution_time в php.ini или www.conf:

request_terminate_timeout = 30s
max_execution_time = 30

Также проверьте настройки таймаутов веб-сервера (например, Nginx):

proxy_read_timeout 30s;
fastcgi_read_timeout 30s;

2. Использование неблокирующих асинхронных запросов для отправки URL

Отправка URL в IndexNow должна быть максимально быстрой, чтобы не блокировать выполнение PHP. Для этого используйте функцию wp_remote_post с параметром blocking => false:

function send_url_to_indexnow_async( $url ) {
    $api_key = 'ВАШ_КЛЮЧ_API';
    $endpoint = 'https://api.indexnow.org/indexnow';

    $body = [
        'host' => parse_url( home_url(), PHP_URL_HOST ),
        'key' => $api_key,
        'keyLocation' => home_url( 'indexnow-key.txt' ),
        'urlList' => [ $url ],
    ];

    $args = [
        'headers' => [ 'Content-Type' => 'application/json' ],
        'body' => wp_json_encode( $body ),
        'timeout' => 5,
        'blocking' => false,
    ];

    wp_remote_post( $endpoint, $args );
}

3. Регистрация хука для отправки URL при сохранении поста

Используйте хук save_post, чтобы отправлять URL асинхронно:

add_action( 'save_post', function( $post_id ) {
    if ( wp_is_post_revision( $post_id ) ) return;

    $url = get_permalink( $post_id );
    send_url_to_indexnow_async( $url );
});

4. Мониторинг очереди отправки URL (при большом объеме)

Если сайт большой, рекомендуется организовать очередь URL для пакетной отправки. Для этого можно использовать WP Cron и сохранять URL в транзиенты или таблицу базы данных. При обработке очереди отправлять URL партиями по 10-20 штук.

Проверка результата после внедрения

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

• Измените или создайте новый пост, проверьте, что функция send_url_to_indexnow_async вызывается (например, добавьте error_log в тело функции).
• Просмотрите логи PHP-FPM и веб-сервера на предмет ошибок.
• С помощью curl проверьте доступность IndexNow API.
• Используйте инструменты поисковых систем (например, Bing Webmaster Tools) для мониторинга статуса отправленных URL.

Частые ошибки и способы их исправления

• Таймауты PHP-FPM — увеличьте request_terminate_timeout и max_execution_time.
• Блокирующие запросы — всегда используйте blocking => false в wp_remote_post, чтобы избежать задержек.
• Неверный API-ключ — проверьте, что key и keyLocation настроены правильно и доступны извне.
• Ошибки 502/504 — проверьте настройки веб-сервера и PHP-FPM, особенно лимиты по памяти и таймауты.
• Проблемы с SSL — убедитесь, что сертификаты корректны, и в PHP установлено актуальное CA.

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

• Храните ключ IndexNow вне публичного доступа, например, в wp-config.php или через константы.
• Используйте transient API для кэширования URL, которые нужно отправить, чтобы избежать повторов.
• Не отправляйте URL при каждом сохранении, если изменений в контенте нет (сравнивайте хеши).
• Регулярно проверяйте логи и настраивайте мониторинг, чтобы своевременно выявлять проблемы с отправкой.
• Оптимизируйте очередь URL и избегайте массовых отправок в пиковые часы нагрузки сервера.

Сравнение методов отправки URL в IndexNow при использовании PHP-FPM