Skip to content

Commit aad4d42

Browse files
mmalferovmmalferov
authored
Создал файлы с описанием новых функций модуля Opcache (#1142)
* Create opcache-jit-blacklist.xml * Create opcache-is-script-cached-in-file-cache.xml * opcache-jit-blacklist.xml Fix XML syntax error
1 parent 505546f commit aad4d42

File tree

2 files changed

+184
-0
lines changed

2 files changed

+184
-0
lines changed

‎reference/opcache/functions/opcache-is-script-cached-in-file-cache.xml‎

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 3c36a56c9e6875fbe3295827a15747d6eae9572e Maintainer: malferov Status: ready -->
3+
<!-- Reviewed: no -->
4+
<refentry xml:id="function.opcache-is-script-cached-in-file-cache" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<refnamediv>
6+
<refname>opcache_is_script_cached_in_file_cache</refname>
7+
<refpurpose>Проверяет, содержится ли скрипт в файловом кеше модуля OPCache</refpurpose>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis>
13+
<type>bool</type><methodname>opcache_is_script_cached_in_file_cache</methodname>
14+
<methodparam><type>string</type><parameter>filename</parameter></methodparam>
15+
</methodsynopsis>
16+
<simpara>
17+
Функция проверяет, закешировался ли PHP-скрипт в файловом кеше модуля OPCache,
18+
и упрощает проверку «прогрева» кеша конкретного скрипта.
19+
Функция проверяет только кеш файлов, а не кеширование операционного кода в памяти.
20+
Кеширование в памяти проверяют функцией <function>opcache_is_script_cached</function>.
21+
</simpara>
22+
</refsect1>
23+
24+
<refsect1 role="parameters">
25+
&reftitle.parameters;
26+
<variablelist>
27+
<varlistentry>
28+
<term><parameter>filename</parameter></term>
29+
<listitem>
30+
<simpara>
31+
Путь к PHP-скрипту, кеширование которого требуется проверить.
32+
</simpara>
33+
</listitem>
34+
</varlistentry>
35+
</variablelist>
36+
</refsect1>
37+
38+
<refsect1 role="returnvalues">
39+
&reftitle.returnvalues;
40+
<simpara>
41+
Функция возвращает значение &true;, если модуль OPCache закешировал файл с путём <parameter>filename</parameter>,
42+
иначе возвращается значение &false;.
43+
</simpara>
44+
</refsect1>
45+
46+
<refsect1 role="seealso">
47+
&reftitle.seealso;
48+
<simplelist>
49+
<member><function>opcache_compile_file</function></member>
50+
<member><function>opcache_is_script_cached</function></member>
51+
</simplelist>
52+
</refsect1>
53+
</refentry>
54+
<!-- Keep this comment at the end of the file
55+
Local variables:
56+
mode: sgml
57+
sgml-omittag:t
58+
sgml-shorttag:t
59+
sgml-minimize-attributes:nil
60+
sgml-always-quote-attributes:t
61+
sgml-indent-step:1
62+
sgml-indent-data:t
63+
indent-tabs-mode:nil
64+
sgml-parent-document:nil
65+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
66+
sgml-exposed-tags:nil
67+
sgml-local-catalogs:nil
68+
sgml-local-ecat-files:nil
69+
End:
70+
vim600: syn=xml fen fdm=syntax fdl=2 si
71+
vim: et tw=78 syn=sgml
72+
vi: ts=1 sw=1
73+
-->

‎reference/opcache/functions/opcache-jit-blacklist.xml‎

Lines changed: 111 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,111 @@
1+
<?xml version="1.0" encoding="utf-8"?>
2+
<!-- EN-Revision: 3c36a56c9e6875fbe3295827a15747d6eae9572e Maintainer: malferov Status: ready -->
3+
<!-- Reviewed: no -->
4+
<refentry xml:id="function.opcache-jit-blacklist" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
5+
<refnamediv>
6+
<refname>opcache_jit_blacklist</refname>
7+
<refpurpose>Исключает функцию из JIT-компиляции</refpurpose>
8+
</refnamediv>
9+
10+
<refsect1 role="description">
11+
&reftitle.description;
12+
<methodsynopsis>
13+
<type>void</type>
14+
<methodname>opcache_jit_blacklist</methodname>
15+
<methodparam>
16+
<type>Closure</type>
17+
<parameter>closure</parameter>
18+
</methodparam>
19+
</methodsynopsis>
20+
<simpara>
21+
Функция запрещает JIT-компиляцию конкретной функции при работе JIT в режиме трассировки.
22+
Целевую функцию передают в аргументе в виде замыкания <classname>Closure</classname>.
23+
</simpara>
24+
<warning>
25+
<simpara>
26+
Запрет не затронет части функции, которые JIT уже скомпилировал —
27+
такие участки кода продолжат выполняться в скомпилированном виде.
28+
</simpara>
29+
</warning>
30+
</refsect1>
31+
32+
<refsect1 role="parameters">
33+
&reftitle.parameters;
34+
<variablelist>
35+
<varlistentry>
36+
<term>
37+
<parameter>closure</parameter>
38+
</term>
39+
<listitem>
40+
<simpara>
41+
Функция, которую требуется исключить из JIT-компиляции. В аргументе передают первоклассное callable-значение
42+
или анонимную функцию; при передаче последней исключается
43+
сама анонимная функция.
44+
</simpara>
45+
</listitem>
46+
</varlistentry>
47+
</variablelist>
48+
</refsect1>
49+
50+
<refsect1 role="returnvalues">
51+
&reftitle.returnvalues;
52+
<simpara>
53+
&return.void;
54+
</simpara>
55+
</refsect1>
56+
57+
<refsect1 role="examples">
58+
&reftitle.examples;
59+
<example>
60+
<title>
61+
Пример исключения функции из JIT-компиляции
62+
функцией <function>opcache_jit_blacklist</function>
63+
</title>
64+
<programlisting role="php">
65+
<![CDATA[
66+
<?php
67+
68+
function foo()
69+
{
70+
$x = 1;
71+
$x += 0;
72+
++$x;
73+
var_dump($x);
74+
}
75+
76+
opcache_jit_blacklist(foo(...));
77+
78+
foo();
79+
]]>
80+
</programlisting>
81+
</example>
82+
</refsect1>
83+
84+
<refsect1 role="seealso">
85+
&reftitle.seealso;
86+
<simplelist>
87+
<member><function>opcache_invalidate</function></member>
88+
<member><function>opcache_reset</function></member>
89+
</simplelist>
90+
</refsect1>
91+
</refentry>
92+
<!-- Keep this comment at the end of the file
93+
Local variables:
94+
mode: sgml
95+
sgml-omittag:t
96+
sgml-shorttag:t
97+
sgml-minimize-attributes:nil
98+
sgml-always-quote-attributes:t
99+
sgml-indent-step:1
100+
sgml-indent-data:t
101+
indent-tabs-mode:nil
102+
sgml-parent-document:nil
103+
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
104+
sgml-exposed-tags:nil
105+
sgml-local-catalogs:nil
106+
sgml-local-ecat-files:nil
107+
End:
108+
vim600: syn=xml fen fdm=syntax fdl=2 si
109+
vim: et tw=78 syn=sgml
110+
vi: ts=1 sw=1
111+
-->

0 commit comments

Comments
 (0)