Краткое разъяснение конфигурационных
директив.
-
opcache.enable
bool
-
Включает кеш опкодов. Код не оптимизируется и не кешируется,
если опцию отключили. Опцию opcache.enable
нельзя включить
во время выполнения функцией ini_set(), но можно отключить.
Попытка включить опцию в скрипте выдаст предупреждение.
-
opcache.enable_cli
bool
-
Включает кеш опкодов для CLI-версии PHP.
-
opcache.memory_consumption
int
-
Размер разделяемой памяти в мегабайтах для OPcache.
Минимально допустимое значение — 8
,
которое кеш опкодов займёт, если установили значение меньше.
-
opcache.interned_strings_buffer
int
-
Количество памяти в мегабайтах для хранения интернированных строк.
-
opcache.max_accelerated_files
int
-
Максимальное количество ключей (и, соответственно, скриптов) в хеш-таблице
OPcache. Значение, которое кеш опкодов будет использовать в итоге, будет первым числом из набора
{ 223, 463, 983, 1979, 3907, 7963, 16229, 32531, 65407, 130987, 262237, 524521, 1048793 }
,
которое больше или равно значению, которое установили для этого параметра.
Минимальное значение составляет 200, а максимальное — 1 000 000.
Значения за пределами этого диапазона ограничиваются допустимым диапазоном.
-
opcache.max_wasted_percentage
int
-
Максимальный процент неиспользуемой памяти, при достижении которого модуль
запланирует перезапуск, если свободной памяти недостаточно.
Максимально допустимое значение: 50
,
которое кеш опкодов займёт, если установили значение больше.
-
opcache.use_cwd
bool
-
При включении опции OPcache добавляет текущую рабочую директорию к ключу
скрипта, чем устраняет возможность коллизий для файлов с одинаковым
основным именем. Отключение этой директивы повышает производительность, но иногда
приводит к сбоям приложений.
-
opcache.validate_timestamps
bool
-
При включении опции OPcache будет проверять актуальность закешированных скриптов каждые
opcache.revalidate_freq
секунд. При отключении директивы требуется сбросить OPcache вручную функциями
opcache_reset()
и opcache_invalidate() или перезапустить веб-сервер, чтобы
изменения в файловой системе вступили в силу.
Замечание:
OPcache по-прежнему может проверять метку времени файла во время компиляции, если для
опций opcache.file_update_protection
или opcache.max_file_size установили ненулевые значения.
-
opcache.revalidate_freq
int
-
Как часто в секундах проверять обновления меток времени скрипта.
При значении 0
OPcache будет проверять обновления
при каждом запросе.
Модуль игнорирует эту директиву конфигурации, если опцию
opcache.validate_timestamps отключили.
-
opcache.revalidate_path
bool
-
При отключении опции модуль переиспользует файлы кеша,
пути которых содержат путь из списка include_path.
Поэтому модуль не будет искать файл с таким же именем по другим путям
списка include_path.
-
При отключении опции модуль отбрасывает комментарии для документации из кеша опкодов,
чтобы уменьшить размер оптимизированного кода. Отключение этой директивы конфигурации может спровоцировать
сбой в работе приложений и фреймворков, которые полагаются на аннотации в комментариях,
включая Doctrine, Zend Framework 2 и PHPUnit.
-
opcache.fast_shutdown
bool
-
При включении опции используется последовательность быстрого завершения работы,
которая не освобождает каждый выделенный блок памяти, а полагается
на менеджер памяти движка Zend Engine для массового освобождения всего набора переменных запроса.
Эту директиву удалили в PHP 7.2.0. Вариант последовательности
быстрого завершения работы интегрировали в PHP и кеш опкодов по возможности
будет использовать вариант автоматически.
-
opcache.enable_file_override
bool
-
При включении опции и вызове функций file_exists(),
is_file() и is_readable()
модуль будет проверять, содержит ли уже кеш опкодов файл.
Опция может повысить производительность приложений, которые проверяют наличие
и доступность для чтения PHP-скриптов, но рискует вернуть устаревшие
данные, если опцию
opcache.validate_timestamps отключили.
-
opcache.optimization_level
int
-
Битовая маска, которая контролирует, какие шаги оптимизации выполняются.
По умолчанию применяются все безопасные оптимизации.
Изменение значения по умолчанию в основном полезно для отладки или разработки оптимизатора
(смотрите также описание директивы opcache.opt_debug_level).
-
opcache.inherited_hack
bool
-
Эта директива конфигурации игнорируется.
-
opcache.dups_fix
bool
-
Этот хак требуется только для обхода ошибок «Невозможно повторно объявить класс» (Cannot redeclare class).
-
opcache.blacklist_filename
string
-
Расположение файла чёрного списка OPcache. Файл чёрного списка — текстовый файл,
который содержит имена файлов, которые не нужно ускорять, по одной записи на строку.
Допускаются подстановочные знаки, также можно указывать префиксы. Строки, которые
начинаются с точки с запятой, игнорируются как комментарии.
Пример простого чёрного списка:
-
opcache.max_file_size
int
-
Максимальный размер файла для кеширования в байтах.
Модуль будет кешировать все файлы, если значение равно 0
.
-
opcache.consistency_checks
int
-
Если значение ненулевое, OPcache будет сверять контрольную сумму кеша каждые N запросов,
где N — значение этой директивы конфигурации. Рекомендуется включать директиву только
при отладке, поскольку опция снижает производительность.
Замечание:
Опцию отключили с PHP 8.1.18 и 8.2.5 и удалили в PHP 8.3.0.
-
opcache.force_restart_timeout
int
-
Время ожидания начала запланированного перезапуска в секундах при неактивном кеше.
Если время ожидания истекло,
OPcache решает, что что-то не так, и чтобы разрешить перезапуск, завершит процессы,
которые удерживают блокировки в кеше.
Если для параметра
opcache.log_verbosity_level
установили значение 2 или больше, то когда возникнет ситуации с превышением времени ожидания,
модуль запишет в лог ошибок предупреждение.
Директива не поддерживается в ОС Windows.
-
opcache.error_log
string
-
Путь к логу ошибок OPcache. Пустая строка обрабатывается как stderr
,
и приведёт к отправке логов в стандартный поток ошибок (обычно это лог
ошибок веб-сервера).
-
opcache.log_verbosity_level
int
-
Уровень детализации лога ошибок. По умолчанию регистрируются только
фатальные ошибки (уровень 0) и ошибки (уровень 1).
Другие доступные уровни: предупреждения (уровень 2), информационные
сообщения (уровень 3) и сообщения отладки (уровень 4).
-
opcache.record_warnings
bool
-
При включении опции OPcache будет записывать предупреждения, которые возникают во время компиляции,
и повторять их при следующем включении файла, даже если файл обслуживается из кеша.
-
opcache.preferred_memory_model
string
-
Предпочитаемая модель памяти для OPcache. Если оставить значение пустым,
OPcache сам выберет наиболее подходящую модель, которая
будет вести себя корректно практически в любых случаях.
Возможные значения включают mmap
, shm
,
posix
и win32
.
-
opcache.protect_memory
bool
-
Защищает разделяемую память от неожиданной записи во время запуска скриптов.
Полезно только для внутренней отладки.
-
opcache.mmap_base
string
-
Базовое значение для сегмента разделяемой памяти в ОС Windows. Каждый
PHP-процесс должен отображать разделяемую память в одинаковое адресное пространство.
Эта директива помогает исправить ошибки «Не удается повторно прикрепиться к базовому адресу»
(Unable to reattach to base address).
-
opcache.restrict_api
string
-
Разрешает вызывать API-функции модуля OPcache только из PHP-скриптов, чей путь начинается
с заданной строки. Значение по умолчанию равно ""
и означает отсутствие ограничений.
-
opcache.file_update_protection
string
-
Исключает кеширование файлов, с момента изменения которых прошло меньше секунд, чем указали.
Это защищает от кеширования неполностью обновлённых файлов. Если все обновления файлов атомарны, можно повысить
производительность, задав для этого параметра значение 0
.
Это разрешит закешировать файлы немедленно.
-
opcache.huge_code_pages
bool
-
Включает или отключает копирование PHP-кода (текстового сегмента) в HUGE PAGES.
Опция может повысить производительность, но требует соответствующих системных
настроек.
Опция доступна в Linux начиная с PHP 7.0.0 и во FreeBSD начиная с PHP 7.4.0.
-
opcache.lockfile_path
string
-
Абсолютный путь к хранилищу общих файлов блокировок (только для *nix-систем).
-
opcache.opt_debug_level
string
-
Создаёт сброс опкодов для отладки отдельных этапов оптимизации.
Значение 0x10000 будет выводить опкоды в том виде, в каком их создал компилятор,
до оптимизации, тогда как значение
0x20000 будет выводить оптимизированные опкоды.
-
opcache.file_cache
string
-
Включает и устанавливает каталог кеша второго уровня. Опция должна
повысить производительность, когда SHM-память заполнилась,
при перезапуске сервера или сбросе разделяемой SHM-памяти. Значение по умолчанию ""
отключает кеширование на основе файлов.
-
opcache.file_cache_only
bool
-
Включает или выключает кеширование опкодов в разделяемой памяти.
Замечание:
До PHP 8.1.0 отключение этой директивы с уже заполненным
файловым кешем требовало ручной очистки файлового кеша.
-
opcache.file_cache_consistency_checks
bool
-
Включает или выключает проверку контрольной суммы при загрузке скрипта
из файлового кеша.
-
opcache.file_cache_fallback
bool
-
Подразумевает opcache.file_cache_only=1
для конкретного процесса, которому
не удалось повторно подключиться к разделяемой памяти
(только для ОС Windows). Требуется явное включение файлового кеша.
Предостережение
Отключение этой опции конфигурации может помешать запуску процессов, и поэтому не рекомендуется.
-
opcache.validate_permission
bool
-
Проверяет права доступа к кешированному файлу для текущего пользователя.
-
opcache.validate_root
bool
-
Предотвращает коллизии имён в chroot-окружении. Опцию необходимо включать
для каждого chroot-окружения, чтобы предотвратить доступ
к файлам за пределами chroot.
-
opcache.preload
string
-
Задаёт PHP-скрипт, который модуль скомпилирует и выполнит при старте сервера,
а также сможет предзагрузить другие файлы, либо через конструкцию include,
либо через функцию opcache_compile_file(). Каждая сущность (например,
функции и классы), которую определили в этих файлах, будет автоматически доступна для запросов
до момента выключения сервера.
Замечание:
Предварительная загрузка не поддерживается ОС Windows.
-
opcache.preload_user
string
-
Позволяет запускать предварительную загрузку от имени заданного пользователя системы.
Опция полезна для серверов, которые запускаются от имени root-пользователя перед переключением
на непривилегированного пользователя системы.
По умолчанию предварительная загрузка от имени root запрещена по соображениям безопасности,
если только этой директиве явно не установили значение root
.
-
opcache.cache_id
string
-
В системах Windows процессы, которые запускают один и тот же SAPI-интерфейс PHP
под одной и той же учётной записью пользователя с тем же идентификатором кеша, делят между собой один экземпляр OPcache.
Значение этой опции разрешается задавать произвольно.
Подсказка
На IIS-серверах пулы приложений поддерживают способность работать с отдельными экземплярами OPcache.
Чтобы разделить кеши, переменную окружения APP_POOL_ID указывают как идентификатор кеша
opcache.cache_id
.
-
opcache.jit
string|int
-
В обычном режиме параметр принимает одно из четырёх строковых значений:
disable
: Деактивирован, нельзя включить во время выполнения.
off
: Выключен, но разрешается включить во время выполнения.
-
tracing
/on
: Включить JIT с компиляцией трассировок.
Включён по умолчанию и рекомендуется для большей части пользователей.
function
: Включить JIT с компиляцией функций.
В продвинутом режиме параметр принимает 4-значное целое число CRTO
, в котором цифры означают:
C
(флаги оптимизации для процессора)
-
0
: Отключить оптимизацию для ЦП.
1
: Включить набор инструкций AVX, если поддерживается ЦП.
R
(распределение регистров)
-
0
: Не распределять регистры.
1
: Выделять локальный блочный регистр.
2
: Выделять глобальный регистр.
T
(триггер)
-
0
: Компилировать каждую функцию при загрузке скрипта.
1
: Компилировать функций при первом выполнении.
-
2
: Профилировать функции при первом запросе и компилировать самые горячие функции.
3
: Профилировать на лету и компилировать горячие функции.
4
: Не используется.
-
5
: Включить JIT с компиляцией трассировок.
Профилировать на лету и компилировать трассировки горячих сегментов кода.
O
(уровень оптимизации)
-
0
: Без JIT-компилятора.
1
: Минимальный уровень JIT-компиляции (вызывать стандартные обработчики виртуальной машины).
2
: Вызывать встроенные обработчики виртуальной машины.
3
: Разрешить компилятору делать выводы о типах значений.
4
: Использовать граф вызовов.
5
: Оптимизировать весь скрипт.
Режим tracing
соответствует CRTO = 1254
,
Режим function
соответствует CRTO = 1205
.
-
opcache.jit_buffer_size
int
-
Объем разделяемой памяти, который резервируется для скомпилированного JIT-кода. Нулевое значение отключает JIT.
Объём измеряется в байтах, если значение параметра указали как целое число (int).
Параметр также принимает значения в сокращённой нотации, которую описывает раздел FAQ.
-
opcache.jit_debug
int
-
Битовая маска, которая определяет, какой вывод JIT-отладки включить.
Возможные значения смотрите в файле » zend_jit.h
(ищите определения макросов, которые начинаются с префикса ZEND_JIT_DEBUG
).
-
opcache.jit_bisect_limit
int
-
Опция отладки, которая отключает JIT-компиляцию после компиляции конкретного количества функций.
Опция помогает разделять источник неправильной JIT-компиляции.
Примечание: этот параметр работает, только если для JIT-триггера установили значение 0 (компиляция при загрузке скрипта)
или 1 (компиляция при первом выполнении), например opcache.jit=1215
.
Подробнее о значениях рассказывает описание опции opcache.jit.
-
opcache.jit_prof_threshold
float
-
Когда используется режим триггера «профилирование функций при первом запросе» этот порог определяет, считается ли
функция горячей. Количество вызовов функции, разделённое на количество вызовов
всех функций, должно быть выше порогового значения. Например, пороговое значение 0,005 означает,
что функции, которые составляют более 0,5% всех вызовов, будут компилироваться JIT-компилятором.
-
opcache.jit_max_root_traces
int
-
Максимальное количество корневых стеков вызовов.
Корневой стек вызова — поток выполнения, который сначала проходит по одному пути через код,
что является единицей JIT-компиляции.
JIT не будет компилировать новый код, если достигнет этого предела.
-
opcache.jit_max_side_traces
int
-
Максимальное количество боковых стеков вызова, которые могут принадлежать корневому стеку.
Боковой стек вызова — другой поток выполнения, который не идёт по пути скомпилированного корневого стека вызова.
Боковые стеки вызова, которые принадлежат тому же корневому стеку вызова, не будут компилироваться,
если достигнут этого предела.
-
opcache.jit_max_exit_counters
int
-
Максимальное количество счётчиков выхода бокового стека вызова. Опция ограничивает общее количество
возможных боковых стеков вызова для всех корневых стеков.
-
opcache.jit_hot_loop
int
-
После скольких итераций цикл считается горячим.
Допустимый диапазон значений: [0,255]
; для значений за пределами этого диапазона,
например -1
или 256
, будет использоваться значение по умолчанию.
Значение 0
отключит трассировку и компиляцию циклов JIT-компилятором.
-
opcache.jit_hot_func
int
-
После скольких вызовов функция считается горячей.
Допустимый диапазон значений: [0,255]
; для значений за пределами этого диапазона,
например -1
или 256
, будет использоваться значение по умолчанию.
Значение 0
отключит трассировку и компиляцию функций JIT-компилятором.
-
opcache.jit_hot_return
int
-
После скольких возвратов возврат считается горячим.
Допустимый диапазон значений: [0,255]
; для значений за пределами этого диапазона,
например -1
или 256
, будет использоваться значение по умолчанию.
Значение 0
отключит трассировку и компиляцию возвратов JIT-компилятором.
-
opcache.jit_hot_side_exit
int
-
После скольких выходов выход из бокового стека вызова считается горячим.
Допустимый диапазон значений: [0,255]
; для значений за пределами этого диапазона,
например -1
или 256
, будет использоваться значение по умолчанию.
Значение 0
отключит трассировку и компиляцию боковых выходов JIT-компилятором.
-
opcache.jit_blacklist_root_trace
int
-
Максимальное количество попыток компиляции корневого стека вызова, прежде чем компилятор занесёт корневой стек в чёрный список.
-
opcache.jit_blacklist_side_trace
int
-
Максимальное количество попыток компиляции бокового стека вызова, прежде чем компилятор занесёт боковой стек в чёрный список.
-
opcache.jit_max_loop_unrolls
int
-
Максимальное количество попыток развернуть цикл в боковом пути
при попытке достичь корневого пути и закрыть внешний цикл.
-
opcache.jit_max_recursive_calls
int
-
Максимальное количество развёрнутых циклов рекурсивных вызовов.
-
opcache.jit_max_recursive_returns
int
-
Максимальное количество развёрнутых циклов рекурсивных возвратов.
-
opcache.jit_max_polymorphic_calls
int
-
Максимальное количество попыток встроить полиморфные динамические вызовы или вызовы полиморфных методов.
Вызовы, которые превышают этот предел, обрабатываются как мегаморфные и не встраиваются.