From e1a021f6ab78ee1541584e3b6550c32c5806fbf4 Mon Sep 17 00:00:00 2001
From: lacatoire <la.catoire@gmail.com>
Date: Thu, 5 Feb 2026 12:41:08 +0100
Subject: [PATCH] Document --enable-zend-max-execution-timers configure option

Fixes #3767
---
 appendices/configure/misc.xml | 19 +++++++++++++++++++
 reference/info/ini.xml        |  8 ++++++++
 2 files changed, 27 insertions(+)

diff --git a/appendices/configure/misc.xml b/appendices/configure/misc.xml
index c95b91eab5a8..81683b0825c9 100644
--- a/appendices/configure/misc.xml
+++ b/appendices/configure/misc.xml
@@ -46,6 +46,25 @@
     </listitem>
    </varlistentry>
 
+   <varlistentry xml:id="configure.enable-zend-max-execution-timers">
+    <term>
+     <option role="configure">--enable-zend-max-execution-timers</option>
+    </term>
+    <listitem>
+     <para>
+      Enable the use of POSIX timers for
+      <link linkend="ini.max-execution-time">max_execution_time</link>
+      tracking, using per-thread CPU time clocks instead of the default
+      wall-clock based <literal>setitimer()</literal>.
+      This provides more accurate execution time measurement in threaded
+      environments.
+      Available on Linux only (requires <literal>timer_create()</literal>
+      support).
+      Available since PHP 8.1.0. Enabled by default for ZTS builds on
+      Linux since PHP 8.3.0.
+     </para>
+    </listitem>
+   </varlistentry>
    <varlistentry xml:id="configure.enable-sigchild">
     <term>
      <option role="configure">--enable-sigchild</option>
diff --git a/reference/info/ini.xml b/reference/info/ini.xml
index fcb3b6ec99a7..b5693f35ff09 100644
--- a/reference/info/ini.xml
+++ b/reference/info/ini.xml
@@ -251,6 +251,14 @@
       <function>set_time_limit</function> function for more
       details.
      </para>
+     <para>
+      When PHP is compiled with
+      <link linkend="configure.enable-zend-max-execution-timers">--enable-zend-max-execution-timers</link>
+      (the default for ZTS builds on Linux since PHP 8.3.0), the
+      execution time is measured using per-thread CPU time clocks
+      via POSIX timers, which provides more accurate tracking
+      than the default wall-clock based timer.
+     </para>
      <para>
       Your web server can have other timeout configurations that may 
       also interrupt PHP execution. Apache has a