В Limb3 выработавшейся практикой стало использование переменных окружения для настройки определенных системных параметров. Все переменные начинаются с ключевого слова LIMB_(единственное исключение - константы шаблонизатора WACT, которые имеют префикс WACT_). Для работы с переменными используются функции lmb_env_set(), lmb_env_setor(), lmb_env_get(), lmb_env_has(), lmb_env_remove(), для отладки lmb_env_trace(), lmb_env_trace_has(), lmb_env_trace_show(). Использование собственных функций, а так же наличие функций для отладки, избавляет от единственного их минуса - «беззащитности» перед плохим кодом.
Мы не отказываемся от настроечных файлов, однако считаем, что низкоуровневые параметры намного проще конфигурировать с помощью низкоуровневых средств. Для обслуживания переменных используется всего 100 строк кода, тогда как настроечные файлы тянут за собой определенные зависимости(например, класс, который осуществляет парсинг настроечных файлов). Сравните:
Используем переменную:
require_once(lmb_env_get('LIMB_VAR_DIR') . '/foo.php');
Используем некую подсистему для получения параметров:
require_once(Toolkit::instanse()->getConf('common')->get('var_dir') . '/foo.php');//вводим зависимость от пакетов toolkit и conf
Механизм констант, использованный ранее, поддерживается и сейчас. Константы просто транслируются в переменные. Например:
define('LIMB_VAR_DIR', '/tmp/'); echo lmb_env_get('LIMB_VAR_DIR'); //'/tmp/' lmb_env_set('LIMB_VAR_DIR', '/tmp/limb/'); echo lmb_env_get('LIMB_VAR_DIR'); //'/tmp/limb/'
Некоторые переменные очень часто используются внутри фреймворка. Чтобы не писать один и тот же скучный для них существует «обертка» в виде функций. Пока такая функция одна lmb_var_dir():
lmb_var_dir('/tmp'); //установка echo lmb_var_dir(); //получение значения
Документацию на не перечисленные здесь константы стоит искать в описании конкретного пакета.
LIMB_APP_MODE(string) - указывает на режим в котором функционирует приложение. Может принимать два значения: 'devel' и 'production'. Используется фильтром lmbErrorHandlerFilter из пакета web_app. В режиме 'devel' приложение выводит все сообщения об ошибках на экран. В режиме production только пишет их в лог.
LIMB_CACHE_DB_META_IN_FILE(boolean) - объявляет, стоит ли кешировать метаданные структуры базы данных. По умолчанию имеет значение false. Используется в пакете DBAL. Строить метаданные структуры БД при каждом запросе - довольно обременительная задача, поэтому имеет смысл эти данные кешировать(они хранятся в директории LIMB_VAR_DIR в файле db_info.xxx.cache). Отменять кеширование имеет смысл только во время разработки, но не на продукционных серверах. Пример использования:
lmb_env_set('LIMB_CACHE_DB_META_IN_FILE', true);//включаем кеширование
LIMB_CONF_INCLUDE_PATH(string)- список путей через «;» указывающих директории относительно include_path, в которых стоит производить поиск *.conf.php и *.ini настроечных файлов. По умолчанию 'settings;limb/*/settings'. Используется в пакете CONFIG. Обычно полезно переопределять эту константу в тестах. Пример использования:
lmb_env_set('LIMB_CONF_INCLUDE_PATH', 'tests/settings;settings');
LIMB_CONTROLLERS_INCLUDE_PATH(string) - список путей через «;» указывающих директории относительно include_path, в которых стоит производить поиск контроллеров. По умолчанию 'src/controller;limb/*/src/controller'. Используется в пакете WEB_APP.
LIMB_SUPPORTED_VIEW_TYPES(string) - список пар <расширение файла шаблона>=<класс view> через «;». Задает список поддерживаемых view-классов и их ассоциации с файлами-шаблонами. Например:
lmb_env_set('LIMB_SUPPORTED_VIEW_TYPES', '.phtml=lmbMacroView;.html=lmbBlitzView;'); //поддерживаются macro-шаблоны с расширениями .phtml и blitz-шаблоны с расширениями .html
Поиск шаблонов происходит слева-направо, т.е. если, в примере, будет найден macro-шаблон, то Blitz-шаблон искаться не будет.
LIMB_VAR_DIR(string) - указывает на некоторую доступную на запись директорию. Обычно в проекте эта директория имеет название var и находится в корневой директории проекта. Все временные данные, кеши, логи, т.е все то, что может быть безболезненно удалено хранится в этой директории. Эта директория должна всегда находиться в списке svn:ignore системы версионного контроля. Пример использования:
lmb_env_set('LIMB_VAR_DIR', dirname(__FILE__) . '/var'); lmb_var_dir(dirname(__FILE__) . '/var'); //"обертка" для быстрого доступа
LIMB_UNDEFINED (string) - Константа! Значение «отсутствие значения». Обычно используется для обозначения отсутствия значения, в случаях, когда null является значащей величиной. Например:
/** * Получение свойства по имени * @param string property имя * @param mixed значение, которое нужно вернуть, если свойство не установленно * @return mixed */ function get($property, $default = LIMB_UNDEFINED) { if(property_exists($this, $property)) return $this->$property; if($default !== LIMB_UNDEFINED) return $default; }
LIMB_UNDEFINED уникально и неизменно на протяжении всего времени работы скрипта.
Константы из этого списка не выставляются, но их значения поддерживаются, чтобы сохранить обратную совместимость.
Обсуждение