PHP на сервере LinuxWindows

PHP: изменения в коде не применяются из-за OPcache

  • Обновлено
  • Чтение ≈ 2 минуты

Краткий ответ

OPcache кэширует скомпилированный код. После деплоя сбросьте кэш или настройте validate_timestamps и revalidate_freq.

В этой статье
  1. Что означает ошибка
  2. Причины и признаки
  3. Пошаговое решение
  4. Проверка результата

#Что означает ошибка

Сообщение
Изменения не видны

OPcache кэширует скомпилированный код. После деплоя сбросьте кэш или настройте validate_timestamps и revalidate_freq.

#Причины и признаки

Возможная причинаКак узнатьЧто делать
Включён OPcachePHP обслуживает старую версию кодаСверить активный файл и кэш
validate_timestamps=0validate_timestamps выключенСбросить OPcache при публикации
Кэш браузераHTTP обновляется только после очистки браузераПроверить браузер и CDN
Несколько FPMНа разных узлах разные версии кодаОбновить каждый PHP-FPM-пул/узел

#Пошаговое решение

  1. Установите, действительно ли виноват OPcacheОткройте конкретную страницу и проверьте, что редактируемый файл находится в активном DOCUMENT_ROOT, а запрос обслуживает ожидаемый пул PHP-FPM. Через временную закрытую диагностическую страницу прочитайте php_ini_loaded_file(), opcache_get_status(false) и opcache_get_configuration(); для CLI результаты могут отличаться. Если файл на сервер вообще не загрузился, сброс кэша ничего не исправит — сначала проверьте развертывание.
  2. Проверьте параметры проверки измененийВ настройках активного веб-PHP найдите opcache.enable, opcache.validate_timestamps, opcache.revalidate_freq. При validate_timestamps=0 PHP не будет самостоятельно проверять изменения файлов после развертывания; это допустимо только при процедуре сброса. При validate_timestamps=1 OPcache проверяет файлы с заданной периодичностью. Не правьте все php.ini подряд: на сервере могут одновременно работать несколько версий и пулов PHP.
  3. Сбросьте кэш только нужного веб-процессаСогласуйте окно обслуживания: перезапуск нужного PHP-FPM-пула обычно очищает его OPcache, но прервёт активные запросы этого пула. Вызов opcache_reset() из CLI по умолчанию не сбрасывает OPcache веб-FPM; если используете временный веб-обработчик для сброса, защитите его от постороннего доступа и сразу удалите. Если применяется несколько узлов за балансировщиком, нужно обновить каждый, а не только один.
  4. Проверьте свежую версию страницы и журналОбновите страницу без браузерного кэша, проверьте выполняемый участок кода и отсутствие старого поведения; отдельно учтите кэш приложения, шаблонов, CDN и браузера. Если новый код виден на одном узле, но не на другом, сопоставьте пул PHP, путь релиза и данные OPcache на каждом узле. Верните временно изменённые параметры к эксплуатационным значениям и удалите страницу диагностики.

#Проверка результата

Для «PHP: изменения в коде не применяются из-за OPcache» выполните штатную проверку конфигурации, затем один контрольный запрос к сервису. Сверьте его результат с журналом и убедитесь, что пользователи не получили новых ответов 4xx или 5xx после изменения.

Так эту ошибку тоже называют

PHP Parse error: syntax error, unexpected T_STRING — причины и решение Найдите пропущенную точку с запятой, скобку или кавычку в указанной строке. Сайты, серверы и хостинг PHP на сервере Linux Allowed memory size PHP Fatal error: Allowed memory size exhausted — причины и решение `Fatal error: Allowed memory size of N bytes exhausted (tried to allocate M bytes)` означает, что PHP-скрипт превысил лимит памяти, заданный `memory_limit`. Причина — ли… Сайты, серверы и хостинг PHP на сервере PHPWordPressLinux PHP: Warning: Undefined variable / Undefined array key — причины и решение Предупреждения возникают при обращении к необъявленной переменной или несуществующему ключу массива. Проверяйте isset(), ?? и инициализируйте переменные. Сайты, серверы и хостинг PHP на сервере LinuxWindows PHP: Call to undefined function mb_strlen() — не установлено расширение mbstring — причины и решение «Call to undefined function mb_strlen()» в PHP означает, что не установлено или не включено расширение mbstring. Установите пакет phpX.Y-mbstring, раскомментируйте exten… Сайты, серверы и хостинг PHP на сервере LinuxWindows PHP: Cannot modify header information — headers already sent — причины и решение «Cannot modify header information — headers already sent» в PHP возникает, когда вывод начался раньше вызова header(), setcookie() или session_start(). Найдите место выв… Сайты, серверы и хостинг PHP на сервере LinuxWindows

Источники и обновления

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