Настройка во время выполнения

Поведение функций зависит от установок в файле php.ini.

Краткое разъяснение конфигурационных директив.

opcache.enable bool

Включает кеш опкодов. Код не оптимизируется и не кешируется, если опцию отключили. Опцию opcache.enable нельзя включить во время выполнения функцией ini_set(), но можно отключить. Попытка включить опцию в скрипте выдаст предупреждение.

opcache.enable_cli bool

Включает кеш опкодов для CLI-версии PHP.

opcache.memory_consumption int

Размер разделяемой памяти в мегабайтах для OPcache. Минимально допустимое значение — 8, которое кеш опкодов займёт, если установили значение меньше.

opcache.interned_strings_buffer int

Количество памяти в мегабайтах для хранения интернированных строк. Максимальное значение — 32 767 на 64-разрядных архитектурах и 4095 на 32-разрядных архитектурах.

Замечание:

До PHP 8.4.0 максимальное значение составляло 4095 мегабайт на всех архитектурах.

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.

opcache.save_comments bool

При отключении опции модуль отбрасывает комментарии для документации из кеша опкодов, чтобы уменьшить размер оптимизированного кода. Отключение этой директивы конфигурации может спровоцировать сбой в работе приложений и фреймворков, которые полагаются на аннотации в комментариях, включая 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

Битовая маска, которая контролирует, какие шаги оптимизации выполняются. Значением по умолчанию является 0x7FFEBFFF, которое включает все безопасные оптимизации. Отключение оптимизаций или включение небезопасных оптимизаций в основном полезно для отладки/разработки оптимизатора.

Каждый бит в битовой маске включает определённый этап оптимизации:

Маска битов оптимизации

Бит	Название	Описание	По умолчанию
0	PASS_1	Простая оптимизация Peephole	On
1	PASS_2	Не используется (объединён с PASS_1)	On
2	PASS_3	Простая оптимизация JuMP	On
3	PASS_4	Оптимизация Call	On
4	PASS_5	Оптимизация на основе графа управления потоком	On
5	PASS_6	Оптимизация на основе анализа потока данных	On
6	PASS_7	Следует ли использовать график вызовов для оптимизации на основе SSA	On
7	PASS_8	Редкое распространение условных констант	On
8	PASS_9	Оптимизация временных переменных	On
9	PASS_10	Удаление кодов операций NOP	On
10	PASS_11	Сжатие литералов	On
11	PASS_12	Предварительный расчет размера стека вызовов	On
12	PASS_13	Удаление неиспользуемых переменных	On
13	PASS_14	Удаление мёртвого кода	On
14	PASS_15	Сбор и замена объявлений констант (небезопасно)	Off
15	PASS_16	Встраивание тривиальных функций (часть оптимизации вызовов)	On
16	(Flag)	Игнорировать возможность перегрузки оператора (небезопасно)	Off

Замечание: Безопасные и небезопасные оптимизации

Безопасные оптимизации (включены по умолчанию) сохраняют точное поведение кода PHP, одновременно повышая производительность. Включают удаление мёртвого кода, сворачивание констант и оптимизацию переходов.

Небезопасные оптимизации (по умолчанию отключено) может изменить поведение в пограничных случаях:

• Бит 14: Сбор констант. Константы подставляются во время компиляции, игнорируя порядок объявления во время выполнения:

  <?php
  echo getA();         // Вывод: "hello" вместо того, чтобы вызывать ошибку
  const A = "hello";
  function getA() { return A; }

• Бит 16: Игнорирование перегрузки операторов. Небезопасно при использовании классов с do_operation (например, GMP, BCMath) в арифметических операциях. При объявлении типов оптимизатор может безопасно применять те же оптимизации.

opcache.inherited_hack bool

Эта директива конфигурации игнорируется.

opcache.dups_fix bool

Этот хак требуется только для обхода ошибок «Невозможно повторно объявить класс» (Cannot redeclare class).

opcache.blacklist_filename string

Расположение файла чёрного списка OPcache. Файл чёрного списка — текстовый файл, который содержит имена файлов, которые не нужно ускорять, по одной записи на строку. Допускаются подстановочные знаки, также можно указывать префиксы. Строки, которые начинаются с точки с запятой, игнорируются как комментарии.

Пример простого чёрного списка:

; Соответствует конкретному файлу.
/var/www/broken.php
; Префикс, который соответствует каждому файлу, который начинается с «x».
/var/www/x
; Соответствует подстановочному знаку.
/var/www/*-broken.php

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. Начиная с PHP 8.3.0, эту директиву не нужно устанавливать, чтобы разрешить предварительную загрузку при запуске от имени root при использовании CLI SAPI или phpdbg SAPI.

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

Максимальное количество попыток встроить полиморфные динамические вызовы или вызовы полиморфных методов. Вызовы, которые превышают этот предел, обрабатываются как мегаморфные и не встраиваются.