Словарь терминов |
Исходный файл (source file)
|
|
Исходный HTML-файл, содержимое которого будет проанализировано во время обработки; этот файл может содержать метки (nicks) и callback тэги специального формата.
|
Метка (nick)
|
|
Выражение, начинающееся с символов, определенных как начало метки (nick's start), и заканчивающееся символами, определенными как окончание метки (nick's end).
Поддерживаются два типа меток:
метка переменной (variable nick) и метка файла (file nick).
Выражение внутри метки переменной определяет имя переменной из PHP-скрипта, внутри метки файла - имя файла. При обработке каждая метка переменной заменяется значением переменной с указанным именем (если такая переменная существует и имеет значение); каждая метка файла заменяется содержимым файла с указанным именем (если такой файл существует).
|
Начало метки (Start of nick)
|
|
Выражение, определенное заранее как один из библиотечных параметров.
Начало метки может начинать либо метку переменной (variable nick), либо метку файла (file nick).
|
Окончание метки (End of nick)
|
|
Выражение, определенное заранее как один из библиотечных параметров. Окончание метки может заканчивать либо метку переменной (variable nick), либо метку файла (file nick).
|
Метка переменной (Variable nick)
|
|
Выражение, начинающееся с начала метки (nick's start) и заканчивающееся концом метки (nick's end). Во время обработки может быть заменена значением глобальной переменной, либо значением переменной из пространства имен (namespace variable), либо значением константы с указанным именем.
По умолчанию определены следующие параметры:
Пример использования метки переменной в исходном файле (source file):
|
Метка файла (File nick)
|
|
Выражение, начинающееся с начала метки (nick's start) и заканчивающееся концом метки (nick's end).
Во время обработки может быть заменена его содержимым файла с указанным именем (если такой файл существует).
По умолчанию определены следующие параметры:
Пример использования метки файла в исходном файле (source file):
|
Callback тэг (Callback tag)
|
|
HTML тэг, не входящий в список стандартных HTML тэгов;
Во время обработки содержимое тега заменяется на результат
работы функции, имя и параметры вызова которой определены
внутри данного тега.
В данное время, используя этот тэг, пользователь может вызывать как стандартные PHP-функции, так и свои собственные функции, принимающие в качестве аргумента переменную или константу простого типа (string, integer, boolean, double), а также вызывать дополнительно определенные библиотечные функции.
По умолчанию, поддерживаются callback тэги следующего вида:
- <callback name=имя_функции>
-
содержимое_тэга
- </callback>
где
-
имя_функции -
имя функции, которая будет вызвана;
-
содержимое_тэга -
строка, передаваемая в вызываемую функцию в качестве аргумента;
В данной версии имя callback тэга можно указывать без учета регистра, например, <cAllBACK> и <calLBaCK> - означают одно и то же.
Вложенные callback тэги допустимы.
|
Переменная из пространства имен (Namespace variable)
|
|
Индекс в пространстве имен (namespace), переданном в функцию-обработчик.
|
Пространство имен (Namespace)
|
|
Ассоциативный массив, переданный в функцию-обработчик;
внутри этой функции, каждый индекс массива рассматривается
как имя дополнительной локальной переменной.
Если существует глобальная PHP переменная с таким же именем,
то внутри функции-обработчика будет взято значение,
соответствующее индексу в пространстве имен.
|
|
Dictionary |
Source file
|
|
parsed HTML-file, containing preformatted nicks
and callback tags.
|
Nick
|
|
Expression, which is started with nick's start
and ended with nick's end;
it's replaced while parsing.
Two types of nicks are supported:
variable nicks and
file nicks.
Expression inside the variable nick
defines the variable name in PHP-script; expression inside the
file nick defines the file name.
While parsing, each variable nick
is replaced with the PHP-variable with specified variable name
(if this variable exists and is set) or is removed
(if variable is not defined).
Each file nick is replaced with
the file content with the specified file name
(if file exists) or is removed (if file is not found).
|
Start of nick
|
|
Expression, pre-defined as one of the library parameters;
it starts either variable nick or
file nick.
|
End of nick
|
|
Expression, pre-defined as one of the library parameters;
it ends either variable nick or
file nick.
|
Variable nick
|
|
Expression, which is started with
variable nick's start
and ended with variable nick's end;
it's replaced while parsing with either
global or namespace variable or constant value.
Default settings for variable nick:
Example of use in source file:
|
File nick
|
|
Expression, which is started with
file nick's start
and ended with file nick's end;
it's replaced while parsing with file content.
Default settings for file nick:
Example of use in source file:
|
Callback tag
|
|
user-defined HTML tag;
while parsing causes the corresponding function call
and is replaced with function result.
By default,
- <callback name=funcname>
-
tag inner
- </callback>
tags are used; where
-
funcname -
name of the function to be called;
-
tag inner -
string, passed to called function as the first parameter;
Callback tag name is case-insensitive.
Nested callback tags are allowed.
|
Namespace variable
|
|
Key in namespace,
passed to the parsing function.
|
Namespace
|
|
Associative array, passed to the parsing function;
within this function each key is considered
as local variable name and value corresponding to the key
overrides the global PHP variable with the same name (if any).
|
|