PHP RFC: Change how JIT is disabled by default

• Date: 2023-15-11
• Author: Daniil Gentili daniil@daniil.it
• Status: Under Discussion

This RFC proposes to change how JIT is disabled by default.

Currently, JIT is disabled by default using the opcache.jit_buffer_size=0 default, instead of opcache.jit=disable.

For example, here are the defaults for these two configuration entries:

  opcache.jit=tracing
  opcache.jit_buffer_size=0

This effectively disables JIT not because jit=disable, but rather because the buffer size is set to 0.

This RFC proposes to change these defaults to:

  opcache.jit=disable
  opcache.jit_buffer_size=64m

The chosen JIT buffer size default is 64 mb, a reasonable default, given that any smaller multiple of 2 causes the buffer to fill up when running moderately sized projects like Psalm or PHPStan.

This RFC does not change the default behavior, JIT was and still is disabled by default, however now it is now disabled by default using the opcache.jit setting, not the opcache.jit_buffer_size setting.

This may affect users who enabled JIT by only setting a different opcache.jit_buffer_size, without specifying a JIT mode with opcache.jit.

To enable JIT, users will also be required to populate the opcache.jit config value.

Next PHP 8.4.

See Backwards Incompatible Changes section.

Pull request:

Reference internals discussion: https://externals.io/message/121359