array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'book.yaconf.php', 1 => 'Yaconf', 2 => 'Yaconf', ), 'up' => array ( 0 => 'refs.basic.other.php', 1 => 'Другие базовые модули', ), 'prev' => array ( 0 => 'class.yaf-exception-loadfailed-view.php', 1 => 'Yaf_Exception_LoadFailed_View', ), 'next' => array ( 0 => 'yaconf.setup.php', 1 => 'Установка и настройка', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/yaconf/book.xml', ), 'history' => array ( ), 'extra_header_links' => array ( 'rel' => 'alternate', 'href' => '/manual/en/feeds/book.yaconf.atom', 'type' => 'application/atom+xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Yaconf

Введение

Модуль Yet Another Configurations Container (Yaconf) — контейнер конфигураций. Он разбирает INI-файлы при запуске PHP и хранит результат в постоянной памяти в течение всего жизненного цикла PHP, поэтому каждое обращение — это быстрый поиск в хеш-таблице без обращений к файлам и без разбора на каждый запрос.

Yaconf хранит каждую конфигурацию как интернированную строку или неизменяемый массив. Для таких данных не ведётся подсчёт ссылок, поэтому извлечение конфигурации из Yaconf фактически обходится без копирования. Начиная с Yaconf 1.2.0 всё разобранное дерево конфигураций вдобавок уплотняется в один непрерывный блок, что снижает накладные расходы по памяти и улучшает локальность кеша.

Разобранная конфигурация находится в постоянной памяти, которую все рабочие процессы PHP-FPM разделяют механизмом копирования при записи: пока файл конфигурации не изменился, рабочие процессы делят одни и те же физические страницы памяти, сколько бы их ни запустили.

Yaconf поддерживает в INI-файлах разделы и наследование разделов. В сборках без ZTS модуль вдобавок автоматически перезагружает файлы при их изменении; в потокобезопасных сборках (ZTS) конфигурации загружаются при запуске, и чтобы подхватить изменения, требуется перезапуск.

Начиная с Yaconf 1.2.0 подкаталоги настроенного каталога загружаются рекурсивно, на глубину до 16 уровней, и адресуются с названием каталога как уровнем ключа: например, вызов Yaconf::get("users.database.master") читает ключ master из файла database.ini, который положили в подкаталог users/.

Хранение чувствительных конфигураций вне веб-дерева вдобавок снижает поверхность атаки. Файлы конфигураций под корнем веб-сервера злоумышленник может получить, например через уязвимость раскрытия файлов. С модулем Yaconf файлы .ini вместо этого размещают в каталоге, который доступен на чтение только root, например /etc/yaconf: главный процесс PHP-FPM загружает конфигурации при запуске службы, а порождённым рабочим процессам, которые работают от непривилегированного пользователя и обрабатывают веб-запросы, доступ к этому каталогу не нужен и не предоставляется.

Для работы модуля Yaconf требуется PHP 7.0 или выше.