[DOC-CVS] [doc-en] master: ext/opcache: document the JIT default change and startup fatal error (PHP 8.4) (#5738)

Author: Louis-Arnaud (lacatoire)
Committer: GitHub (web-flow)
Pusher: jordikroon
Date: 2026-08-14T14:56:56+02:00

Commit: https://github.com/php/doc-en/commit/36d18e7d4a32ecfdacc1eb086276ffb1baf0393c
Raw diff: https://github.com/php/doc-en/commit/36d18e7d4a32ecfdacc1eb086276ffb1baf0393c.diff

ext/opcache: document the JIT default change and startup fatal error (PHP 8.4) (#5738)

* ext/opcache: Fix JIT default-mode wording and document fatal error on JIT init failure (8.4.0)

Co-authored-by: Jordi Kroon <[email protected]>

Changed paths:
  M  reference/opcache/ini.xml


Diff:

diff --git a/reference/opcache/ini.xml b/reference/opcache/ini.xml
index 3d45f0d638f4..966af001f32f 100644
--- a/reference/opcache/ini.xml
+++ b/reference/opcache/ini.xml
@@ -1158,7 +1158,8 @@ function getA() { return A; }
      <member><literal>off</literal>:  Disabled, but can be enabled at runtime.</member>
      <member>
       <literal>tracing</literal>/<literal>on</literal>: Use tracing JIT.
-      Enabled by default and recommended for most users.
+      Recommended for most users. Prior to PHP 8.4.0, this was the default
+      value; as of PHP 8.4.0 the default is <literal>disable</literal>.
      </member>
      <member><literal>function</literal>: Use function JIT.</member>
     </simplelist>
@@ -1220,6 +1221,12 @@ function getA() { return A; }
      The <literal>"tracing"</literal> mode corresponds to <code>CRTO = 1254</code>,
      the <literal>"function"</literal> mode corresponds to <code>CRTO = 1205</code>.
     </para>
+    <note>
+     <simpara>
+      As of PHP 8.4.0, if JIT is enabled, PHP exits with a fatal error
+      during startup when JIT initialization fails.
+     </simpara>
+    </note>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.opcache.jit-buffer-size">