limb3_2007_3:ru:packages:core:global_functions
Глобальные функции Limb3 из пакета CORE
Пакет CORE содержит набор следующих служебных функций:
Функции для перевода из одного стиля написания строк в другой
Функция | Назначение | Пример использования |
lmb_under_scores($string) | Переводит строку в under_scores | lmb_under_scores('MyData'); /* вернет my_data */ |
lmb_camel_case($string) | Переводит строку в CamelCase | lmb_camel_case('my_data'); /* вернет MyData */ |
lmb_humanize($string) | Переводит строку в «удобную для просмотра человеком» | lmb_humanize('MyData'); /* вернет my data */ |
Функции для работы с относительными путями с учетом include_path
Функция | Назначение | Пример использования |
lmb_is_path_absolute($path) | Возращает true, если $path - абсолютный. Реализована достаточно тривиальная проверка, но которой хватает в 99% случаев. | lmb_is_path_absolute('limb/core/common.inc.php') /* вернет false */ |
lmb_get_include_path_items() | Возвращает в виде массива элементы include_path | lmb_get_include_path_items(); |
lmb_is_readable($path) | Возвращает true, если файл существует. Учитывает то, что путь до файла может быть относительным include_path. Необходимость этой функции появилась из-за того, что php-функция file_exists() не учитывает include_path, а fopen() - учитывает. | lmb_is_readable('limb/core/common.inc.php'); |
lmb_resolve_include_path($path) | Находит абсолютный путь до файла по относительному имени с учетом include_path | lmb_resolve_include_path('limb/core/common.inc.php'); /* вернет что-то типа /var/dev/limb/core/common.inc.php */ |
lmb_glob($glob) | Аналог php-glob() с тем отличием, что если дан относительный путь, то он будет рассмотрен у учетом include_path, и функция в этом случае вернет объединенный результат | lmb_glob('limb/*/src/'); |
Функции для подключения классов и отложенной загрузки кода
Функция | Назначение | Пример использования |
lmb_require($file_path, $optional = false) | Типичное назначение данной функции - пометить какой-либо файл с классом для отложенной загрузки, которая произойдет в autoload. Однако реальная работа этой функции будет зависеть от того, какой парамет в нее пришел в $file_path. Если пришел путь до файла с Limb3 классов, например, limb/core/src/lmbObject.class.php, тогда lmb_require запомнит, что класс lmbObject лежит в файле limb/core/src/lmbObject.class.php и при необходимости подключит его. Если пришел путь в виде limb/core/src/*.class.php, то lmb_require найдет и пометит для себя все файлы классов, находящиеся в данной директории. Если же парамет $file_path имеет иной вид, без суффикса .class.php, тогда lmb_require() работает полностью как обычная php-функция require_once(). Обратите внимание, что lmb_require, если использована * (звездочка) не ищет файлы рекурсивно вниз по иерархии) Если параметр $optional = true, то это означает, что подключение файла опционально и не найденный файл не вызовет ошибки | lmb_require('limb/core/common.inc.php') |
lmb_require_optional($file_path) | Алиас для вызова lmb_require($file_path, true) | |
lmb_autoload($path) | Функция для подключение файла класса ранее помеченного к загрузке через lmb_require(). Эта функция автоматически подключается как одна из autoload-функции при помощи spl_autoload_register() в файле common.inc.php | |
Дополнительные служебные функции
Функция | Назначение | Пример использования |
lmb_var_dump($obj, $echo = false) | Выводит или возвращает (завис от параметра echo) значение var_dump от $obj | lmb_var_dump($my_object); |
limb3_2007_3/ru/packages/core/global_functions.txt · Последние изменения: 2010/11/10 10:02 (внешнее изменение)
Обсуждение