-
Notifications
You must be signed in to change notification settings - Fork 70
/
ini.xml
157 lines (152 loc) · 6.5 KB
/
ini.xml
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 6dfe0767250cdbdf509223f6bc266557b0a3fec9 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<section xml:id="phar.configuration" xmlns="http://docbook.org/ns/docbook">
&reftitle.runtime;
&extension.runtime;
<para>
<table>
<title>Параметры конфигурации файловой системы и потоков</title>
<tgroup cols="4">
<thead>
<row>
<entry>&Name;</entry>
<entry>&Default;</entry>
<entry>&Changeable;</entry>
<entry>&Changelog;</entry>
</row>
</thead>
<tbody xml:id="phar.configuration.list">
<row>
<entry><link linkend="ini.phar.readonly">phar.readonly</link></entry>
<entry>"1"</entry>
<entry><constant>INI_ALL</constant></entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.phar.require-hash">phar.require_hash</link></entry>
<entry>"1"</entry>
<entry><constant>INI_ALL</constant></entry>
<entry></entry>
</row>
<row>
<entry><link linkend="ini.phar.cache-list">phar.cache_list</link></entry>
<entry>""</entry>
<entry><constant>INI_SYSTEM</constant></entry>
<entry></entry>
</row>
</tbody>
</tgroup>
</table>
</para>
&ini.descriptions.title;
<para>
<variablelist>
<varlistentry xml:id="ini.phar.readonly">
<term>
<parameter>phar.readonly</parameter>
<type>bool</type>
</term>
<listitem>
<para>
Этот параметр отключает поддержку создания или модификации Phar-архивов
с помощью потока <literal>phar</literal> и записи объектов <classname>Phar</classname> на диск.
Этот параметр всегда должен быть включён на рабочих машинах,
поскольку поддержка записи модулем phar позволила бы простое создание,
основанных на PHP, вирусов в случае присутствия других уязвимостей в системе общей безопасности.
</para>
<note>
<para>
Этот параметр может быть отключён в php.ini только исходя из соображений безопасности.
Если параметр <literal>phar.readonly</literal> отключён в php.ini,
пользователь может включить <literal>phar.readonly</literal> в скрипте или отключить его позже.
Если параметр <literal>phar.readonly</literal> включён в php.ini,
скрипт может безвредно "повторно включить" переменную INI, но не может отключить её.
</para>
</note>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.phar.require-hash">
<term>
<parameter>phar.require_hash</parameter>
<type>bool</type>
</term>
<listitem>
<para>
Этот параметр сделает обязательной какую-либо подпись
(в настоящий момент поддерживаются MD5, SHA1, SHA256, SHA512 и OpenSSL)
для всех открываемых Phar-архивов и сделает невозможной обработку
любого Phar-архива, не содержащего подпись.
</para>
<note>
<para>
Этот параметр может быть отключён в php.ini.
Если параметр <literal>phar.require_hash</literal> отключён в php.ini,
пользователь может включить <literal>phar.require_hash</literal> в скрипте или отключить его позже.
Если параметр <literal>phar.require_hash</literal> включён в php.ini,
скрипт может безвредно "повторно включить" переменную INI, но не может отключить её.
</para>
<para>
Этот параметр не влияет на чтение простых tar-файлов
при помощи класса <classname>PharData</classname>.
</para>
</note>
<caution>
<simpara>
<literal>phar.require_hash</literal> не обеспечивает безопасности как таковой -
это всего лишь мера по защите от запуска повреждённого Phar архива, поскольку
кто угодно, имеющий возможность модифицировать архив может с тем же
успехом модифицировать и подпись.
</simpara>
</caution>
</listitem>
</varlistentry>
<varlistentry xml:id="ini.phar.cache-list">
<term>
<parameter>phar.cache_list</parameter>
<type>string</type>
</term>
<listitem>
<para>
Позволяет проводить разметку phar-архивов, для которых необходимо
осуществить предварительный разбор в момент старта веб-сервера.
Обеспечивает повышение производительности за счёт запуска файлов вне
phar-архива со скоростью, очень близкой к той, которая была бы при запуске
этих файлов традиционным способом с диска.
<example>
<title>phar.cache_list usage example</title>
<programlisting>
<![CDATA[
в php.ini (windows):
phar.cache_list =C:\путь\к\phar1.phar;C:\путь\к\phar2.phar
в php.ini (unix):
phar.cache_list =/путь/к/phar1.phar:/путь/к/phar2.phar
]]>
</programlisting>
</example>
</para>
</listitem>
</varlistentry>
</variablelist>
</para>
</section>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->