-
Notifications
You must be signed in to change notification settings - Fork 71
/
book.xml
90 lines (86 loc) · 3.07 KB
/
book.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
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 46a9cdd2dbef4ec89bf65fad9930e2feb78bbb98 Maintainer: lex Status: ready -->
<!-- Reviewed: no -->
<book xml:id="book.yaconf" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<?phpdoc extension-membership="pecl" ?>
<title>Yaconf</title>
<titleabbrev>Yaconf</titleabbrev>
<preface xml:id="intro.yaconf">
&reftitle.intro;
<para>
Ещё один контейнер конфигураций (<literal>Yet Another Configurations Container</literal>,
<acronym>Yaconf</acronym>) — контейнер конфигураций,
который разбирает INI-файлы и сохраняет результат
в PHP при запуске, результат хранится на протяжении всего жизненного цикла PHP.
</para>
<para>
Контейнер Yaconf сохраняет каждую конфигурацию как
встроенную строку или неизменяемый массив, что означает, что
на них нельзя посчитать refcount-ссылки, поэтому извлечении конфигурации
из модуля yaconf рассматривается как нулевое копирование (zero-copy) и выполняется чрезвычайно быстро.
</para>
<para>
Yaconf поддерживает разделы и наследование разделов
в INI-файлах. Если PHP собрали в непотокобезопасном режиме — без поддержки ZTS,
Yaconf также будет поддерживать автоматическую перезагрузку после изменений INI-файлов.
</para>
<para>
Yaconf требует PHP 7.0 или выше.
</para>
<example>
<title>Пример INI</title>
<programlisting role="ini">
<![CDATA[
;простая пара ключ-значение
key=val
;хеш
hash.a=val
;массив
arr.0=val
;или так
arr[]=val
;использование констант PHP
version=PHP_VERSION
;использование переменных среды
env=${PATH}
]]>
</programlisting>
</example>
<example>
<title>Пример INI-файла с разделами</title>
<programlisting role="ini">
<![CDATA[
[SectionA]
key=val
hash.a=val
;SectionB наследуется от SectionA
[SectionB:SectionA]
;переопределение key из раздела SectionA
key=new_val
]]>
</programlisting>
</example>
</preface>
&reference.yaconf.setup;
&reference.yaconf.yaconf;
</book>
<!-- 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
-->