SourceForge.net Logo                  

 

РУССКИЙ ENGLISH
Вернуться к оглавлению Back to Contents
Словарь терминов
Исходный файл
(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:
  • <#varname#>
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:
  • <##filename##>
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).