array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'yaconf.configuration.php', 1 => 'Настройка во время выполнения', 2 => 'Настройка во время выполнения', ), 'up' => array ( 0 => 'yaconf.setup.php', 1 => 'Установка и настройка', ), 'prev' => array ( 0 => 'yaconf.installation.php', 1 => 'Установка', ), 'next' => array ( 0 => 'yaconf.resources.php', 1 => 'Типы ресурсов', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/yaconf/ini.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

Настройка во время выполнения

Поведение функций зависит от установок в файле php.ini.

Опции настройки Yaconf
Имя По умолчанию Место изменения Список изменений
yaconf.directory "" INI_SYSTEM  
yaconf.check_delay 300 INI_SYSTEM  

Краткое разъяснение конфигурационных директив.

yaconf.directory string

Каталог, в котором размещают все INI-файлы конфигураций. Загружаются только файлы с расширением .ini. Подкаталоги загружаются рекурсивно, на глубину до 16 уровней; каждый из них выступает уровнем ключа, поэтому файл database.ini, который положили в подкаталог users/, адресуют как "users.database". Доступно начиная с Yaconf 1.2.0; раньше загружались только файлы непосредственно в самом каталоге.

Примеры ниже предполагают, что в настроенном каталоге лежит следующий файл database.ini, а рядом с ним — файл features.ini с настройками отдельных возможностей.

Пример #1 Синтаксис INI-файла

; database.ini
name=production                        ; скалярное значение
version=PHP_VERSION                    ; PHP-константы раскрываются
connection_string=${DATABASE_URL}      ; переменные окружения раскрываются
options.max_connections=50             ; вложенный ключ хеша
options.timeout=30

; элементы массива, обе записи равнозначны
replicas.0=replica-1.example.com
replicas[]=replica-2.example.com

Пример #2 Пример разделов INI-файла

; features.ini
[default]
cache_enabled=on
rate_limit=100

; раздел «premium» наследует каждый ключ раздела «default»
; и переопределяет те, которые задаёт заново
[premium:default]
rate_limit=1000
yaconf.check_delay int

Интервал в секундах, с которым Yaconf проверяет, изменился ли какой-нибудь из загруженных INI-файлов, и перезагружает изменившиеся; изменение определяют сравнением времени изменения каталогов. Значение 0 заставляет Yaconf проверять при каждом запросе.

Замечание:

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