From 5a0edc07db313ed24dd9afbc7ddc71b36c19a913 Mon Sep 17 00:00:00 2001
From: Louis-Arnaud <la.catoire@gmail.com>
Date: Fri, 10 Jul 2026 14:04:58 +0200
Subject: [PATCH] ext/opcache: Fix JIT default-mode wording and document fatal
 error on JIT init failure (8.4.0)

---
 reference/opcache/ini.xml | 9 ++++++++-
 1 file changed, 8 insertions(+), 1 deletion(-)

diff --git a/reference/opcache/ini.xml b/reference/opcache/ini.xml
index 3d45f0d638f4..c1077de44303 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 the 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">