- Use correct type for default configuration options
- Use `<literal>` and `<code>` tags consistently
- Mark all windows-only options in the Changelog column, for consistency
- Slightly improve wording in opcache.file_cache_fallback
- Use `&null;` consistently.
Clarify how to search for jit_debug options, and add an external link to
PHP zend_jit.h source file.
Hopefully, the clarification and link can save PHP the developer's and
user's time/effort with a simple click jumping to where they should go.
This patch has been verified on my local machine and link works well.
This risk is that doc viewer could get a dead link if PHP source code
file location moved or name changed in future. We just hope this is a
rare case and will not happen so frequently. We depend on user's
bug-report to fix any issue.
Reviewed-by: Christoph M. Becker <cmbecker69@gmx.de>
Signed-off-by: Su, Tao <tao.su@intel.com>
Closes GH-1340.
Add more explanation for root trace and side trace in PHP manual.
Includes the influence when reach the maximum value of
opcache.jit_max_root_traces or opcache.jit_max_side_traces.
Signed-off-by:Wang, Xue <xue1.wang@intel.com>
Closes GH-1715.
This patch clarifies the usage of the four JIT tunable options -
jit_hot_{loop,func,return,side_exit} - in PHP manual which end users
should be aware of before they start to tune these options.
1. Valid value range
2. Default value will be used in case beyond valid range
3. Special case of zero value
The patch was verified on my machine with phd local website.
Signed-off-by: Su, Tao <tao.su@intel.com>
Closes GH-1350.
As a new bird to PHP interpreter, I tried to set jit_bisect_limit
with jit=tracing in order to debug/probe PHP JIT feature, but
failed to hit my breakpoint and hence got confused.
I found that jit_bisect_limit only works under special JIT trigger
mode like 0: on script load, or 1: on first execution, after heavily
reading source code and trial-and-error experiments.
So, I would like to clarify the usage in PHP manual.
Hopefully, this can save time cost and reduce confusion of new PHP
interpreter developers.
The patch is verified on my local machine with phd build and the
web content and link looks good.
Signed-off-by: Su, Tao <tao.su@intel.com>
Co-authored-by: Christoph M. Becker <cmbecker69@gmx.de>
Closes GH-1337.
I tried to tell JIT to compile every loops and functions
by setting both opcache.jit_hot_loop and opcache.jit_hot_functions
to 0, but failed to get expected result.
After having read the source code and simple experiments, I found
that setting these two options to 0 will actually disable JIT to
compile any iterations and calls.
So I would like to add clarifications for this behavior in PHP manual.
Signed-off-by: Su, Tao <tao.su@intel.com>
Closes GH-1324.
The "Hacker's guide" is grossly outdated (it is about ZendEngine 2;
some stuff even about ZE1, although ZE4 is current), and nobody is
working on it for years. Therefore we remove this part of the manual;
users are better off reading external resources, such as
<http://www.phpinternalsbook.com/>.
Closes GH-152.
Mikhail Alferov