$phpErrorCallbackFuncStr
$phpErrorCallbackFuncStr : string|array|null
Класс статических системных методов FASS.
executeCommand(string $name, boolean $log = false, \arary $newRequestParams = array(), boolean $mergeRequestParams = true, array $existingRequestParamsKeysToMerge = array()) : mixed
Выполнение указанной команды и возвращение её результата
| string | $name | Имя команды |
| boolean | $log |
|
| \arary | $newRequestParams |
|
| boolean | $mergeRequestParams |
|
| array | $existingRequestParamsKeysToMerge |
|
Результат
composeTemplate(array $template) : string
Загрузка шаблона со вставкой под-шаблонов
Формат описания:
array(
'name' => "<имя_шаблона>",
'sub' => (
'<[:позиция1:]>' => <под-шаблон 1>,
'<[:позиция2:]>' => <под-шаблон 2>,
...
)
)
| array | $template | Массив описания шаблона |
Строка шаблона
fillTemplate(string $tpl_name, array $data) : array
Загрузка шаблона и заполнение его данными
Если шаблон содержит синтаксическую ошибку, вызывается команда \FASS_Config::$checkTplCommandName, чтобы показать эту ошибку программисту (будет сгенерирована ошибка E_PARSE)
| string | $tpl_name | Имя шаблона |
| array | $data | Массив данных (массив ассоциативных массивов) |
Массив строк шаблона с данными
fillTemplate1(string $name, array $data = array()) : \string/NULL
Загрузка шаблона и заполнение его данными
Обертка над fillTemplate(), но $data - просто ассоц. массив (а не массив массивов), а возвращается просто результат компиляции шаблона или NULL в случае ошибки (а не массив строк)
| string | $name |
|
| array | $data |
|
mkdir(string $pathname, integer $mode = null, boolean $recursive = false) : integer
Создание директории и размещение в ней файла index.html с пустым body (аналог 'IndexIgnore *' из .htaccess, только работать будет везде)
| string | $pathname | Путь и имя директории |
| integer | $mode | Права доступа на новую директорию |
| boolean | $recursive | Разрешает создание вложенных директорий, указанных в $pathname |
0 - ок, 1 - не удалось создать директорию, 2 - не удалось создать файл index.html
setErrorHandlers()
Установить обработчиком php-ошибок метод FASS_Core::phpErrorHandler(), а обработчиком shutdown - метод FASS_Core::phpOnShutdown().
Вызывается в core/init.php при инициализации FASS при автономном использовании, а при встраивании в CMS - оборачивать использование FASS между \FASS_Core::setErrorHandlers() и \FASS_Core::unsetErrorHandlers()
phpErrorHandler(integer $errno, string $errstr, string $errfile, string $errline, array|null $errcontext) : true
Обработчик (callback) php-ошибок.
Не вызывать вручную! Умеет определять, в каком именно шаблоне возникла ошибка (и по какой цепочке он вызывался) Протоколирует ошибку и передает обработку в \FASS_Core::$phpErrorCallbackFuncStr
| integer | $errno | |
| string | $errstr | |
| string | $errfile | |
| string | $errline | |
| array|null | $errcontext |
setErrorCallback(string|array $callback)
Установка реальной ф-ии для обработки ошибок, вызывающейся из обработчика {@see FASS_Core::phpErrorHandler()}
Даннвый метод вызывается в fass/index.php и устанавливает реальным обработчиком ф-ию \fassOnCrash()
| string|array | $callback |
|
phpOnShutdown()
Обработчик (callback) shutdown - нормального завершения работы скрипта или после фатальной ошибки или die().
Не вызывать вручную! Если была ошибка, то, как и \FASS_Core::phpErrorHandler(), протоколирует ошибку и передает обработку в \FASS_Core::$phpErrorCallbackFuncStr. Также умеет определять, в каком именно шаблоне возникла ошибка (и по какой цепочке он вызывался)
arrayExtend(array $array1, array $array2, boolean $mergeSequentialSubarrays = true) : array
Дополнить массив $array1 массивом $array2.
Работает, как array_merge_recursive(), за исключением:
Примеры:
{a: 1} + {a: 2} => {a: 2}
{a: [1,2]} + {a: [2,3]} => {a:[1,2,2,3]} или {a:[2,3]}
[1] + [2] => [1,2] или [2]
[[1,2]] + [[2,3]] => [[1,2,2,3]] или [[2,3]]
| array | $array1 | |
| array | $array2 | |
| boolean | $mergeSequentialSubarrays |
getRefDataString(string $ref_name, mixed $ids, string $col_name = 'name', string $custom_sep = ', ') : string
Возвращает наименования справочника, перечисленные через разделитель в виде строки
| string | $ref_name | Имя справочника (таблицы БД) |
| mixed | $ids | ID нужных значений |
| string | $col_name | Имя колонки с текстовым наименованием |
| string | $custom_sep | Разделитель наименований в результирующей строке |
Строка результата
onAssertFailed(string $script, integer $line, string|null $message, string|null $comment = null)
Обработчик, вызывающийся при провале проверки assert()ю Не вызывать вручную! Логирует провал проверки в error.log и выбрасывает исключение FASS_SystemException
| string | $script | |
| integer | $line | |
| string|null | $message | |
| string|null | $comment |
preProcessTemplateContent(string $text) : string
Преобразование содержимого шаблона
Сейчас в шаблоне поддерживаются замены i18n-кодов на соответсвующие тексты на текущем языке
Пример: строка вида {t:$i18n[msg][ERR_REG_MISSING_LOGIN]} заменится на строку "Логин должен быть заполнен", объявленную в fass/language/msg_ru.i18n.json,
где "t:" - модификатор вывода.
Поддерживаются модификаторы:
t - вывод простого текста
h - вывод html-закодированного текста через ф-ию htmlspecialchars()
hp - вывод текста для значений аттрибутов html-тегов через ф-ию htmlspecialchars()
j - вывод json-закодированного текста через json_encode()
| string | $text | Содержимое файла шаблона |
Преобразованное содержимое шаблона
getCommandInfo(string $name) : Array
Определение характеристик команды по ее имени
[0] => Тип (int) :
0 - Сгенерирована AppXML
1 - Обычная команда
[1] => Имя класс (string)
[2] => Имя метода (string)
[3] => Полный путь к файлу команды (string)
| string | $name | Имя команды |
Характеристики