Skip to content

Document --enable-zend-max-execution-timers configure option #5269

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
lacatoire wants to merge 1 commit into
base: master
Choose a base branch
from
Open

Document --enable-zend-max-execution-timers configure option #5269

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
19 changes: 19 additions & 0 deletions appendices/configure/misc.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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>
Expand Down
8 changes: 8 additions & 0 deletions reference/info/ini.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down