eZ Publish  [trunk]
Static Public Member Functions | Public Attributes
eZTemplateCompiler Class Reference

Creates compiled PHP code from templates to speed up template usage. More...

List of all members.

Static Public Member Functions

static alwaysGenerate ()
static boundVariableName ($variableID, $parameters)
static combineStaticNodes ($tpl, &$resourceData, &$lastNode, &$newNode)
static compilationDirectory ()
static compilationFilename ($key, $resourceData)
static compileTemplate ($tpl, $key, &$resourceData)
static createCommonCompileTemplate ()
static createStaticVariableData ($tpl, $staticData, $variableItemPlacement)
static currentTextName ($parameters)
static executeCompilation ($tpl, &$textElements, $key, &$resourceData, $rootNamespace, $currentNamespace)
static executeCompilationHelper ($phpScript, &$text, $tpl, $key, &$resourceData, $rootNamespace, $currentNamespace)
static fetchTemplatePiece ($placementData)
static generateMergeNamespaceCode ($php, $tpl, $namespace, $namespaceScope, $parameters=array(), $skipSimpleAssignment=false)
static generatePHPCode ($useComments, $php, $tpl, &$node, &$resourceData)
static generatePHPCodeChildren ($useComments, $php, $tpl, &$nodeChildren, &$resourceData, &$parameters, $currentParameters)
static generateVariableCode ($php, $tpl, $node, &$knownTypes, $dataInspection, $parameters, &$resourceData)
static generateVariableDataCode ($php, $tpl, $variableData, &$knownTypes, $dataInspection, &$persistence, $parameters, &$resourceData)
static hasCompiledTemplate ($key, $timestamp, &$resourceData)
static inspectVariableData ($tpl, $variableData, $variablePlacement, &$resourceData)
static isAccumulatorsEnabled ()
static isCommentsEnabled ()
static isCompilationEnabled ()
static isDevelopmentModeEnabled ()
static isExecutionEnabled ()
static isFallbackResourceCodeEnabled ()
static isNodePlacementEnabled ()
static isTimingPointsEnabled ()
static isTreeEnabled ($treeName)
static operatorHint ($tpl, $operatorName)
static operatorStaticData ($tpl, $operatorName)
static processElementTransformationChild ($useComments, $php, $tpl, &$node, $elementTree, $elementList, &$resourceData)
static processElementTransformationList ($tpl, &$node, $elements, &$privateData)
static processNodeCombining ($useComments, $php, $tpl, &$node, &$resourceData, &$newNode)
static processNodeCombiningChildren ($useComments, $php, $tpl, &$nodeChildren, &$resourceData, &$parentNode)
static processNodeTransformation ($useComments, $php, $tpl, &$node, &$resourceData, &$newNode)
static processNodeTransformationChild ($useComments, $php, $tpl, &$node, &$resourceData)
static processNodeTransformationChildren ($useComments, $php, $tpl, &$node, &$children, &$resourceData)
static processNodeTransformationNodes ($tpl, &$node, &$nodes, &$privateData)
static processNodeTransformationRoot ($useComments, $php, $tpl, &$node, &$resourceData)
static processRemoveNodePlacement (&$node)
static processStaticOptimizations ($useComments, $php, $tpl, &$node, &$resourceData, &$newNode)
static setSettings ($settingsMap)
static staticNodeData ($node)
static TemplatePrefix ()

Public Attributes

const CODE_DATE = 1074699607

Detailed Description

Creates compiled PHP code from templates to speed up template usage.

Various optimizations that can be done are:

Data:

  • Is constant, generate static data
  • Is variable, generate direct variable extraction
  • Has operators
  • Has attributes

Attributes:

  • Is constant, generate static data

Operators:

  • Supports input
  • Supports output
  • Supports parameters
  • Generates static data (true, false)
  • Custom PHP code
  • Modifies template variables, if possible name which ones. Allows for caching of variables in the script.

Functions:

  • Supports parameters
  • Supports children (set? no, section? yes)
  • Generates static data (ldelim,rdelim)
  • Children usage, no result(set-block) | copy(let,default) | dynamic(conditional, repeated etc.)
  • Children tree, requires original tree | allows custom processing
  • Custom PHP code
  • Deflate/transform tree, create new non-nested tree (let, default)
  • Modifies template variables, if possible name which ones. Allows for caching of variables in the script.

Definition at line 47 of file eztemplatecompiler.php.

Member Function Documentation

static eZTemplateCompiler::alwaysGenerate ( ) [static]
Returns:
true if template compilation should always be run even if a sufficient compilation already exists.

Definition at line 249 of file eztemplatecompiler.php.

Referenced by hasCompiledTemplate().

static eZTemplateCompiler::boundVariableName ( $  variableID,
$  parameters 
) [static]

Definition at line 1725 of file eztemplatecompiler.php.

static eZTemplateCompiler::combineStaticNodes ( $  tpl,
&$  resourceData,
&$  lastNode,
&$  newNode 
) [static]

Tries to combine the node $lastNode and the node $newNode into one new text node. If possible the new node is created in $newNode and $lastNode will be set to false. Combining nodes only works for text nodes and variable nodes without variable lookup, attributes and operators.

Definition at line 738 of file eztemplatecompiler.php.

Referenced by processNodeCombiningChildren().

static eZTemplateCompiler::compilationDirectory ( ) [static]
Returns:
the directory for compiled templates.

Definition at line 277 of file eztemplatecompiler.php.

Referenced by compileTemplate(), createCommonCompileTemplate(), executeCompilation(), generatePHPCodeChildren(), and hasCompiledTemplate().

static eZTemplateCompiler::compilationFilename ( $  key,
$  resourceData 
) [static]

Creates the name for the compiled template and returns it. The name conists of original filename with the md5 of the key and charset appended.

Definition at line 310 of file eztemplatecompiler.php.

Referenced by compileTemplate(), executeCompilation(), generatePHPCodeChildren(), and hasCompiledTemplate().

static eZTemplateCompiler::compileTemplate ( $  tpl,
$  key,
&$  resourceData 
) [static]

Generates the cache which will be used for handling optimized processing using the key $key.

Note:
Each call to this will set the PHP time limit to 30
Returns:
false if the cache does not exist.

Definition at line 443 of file eztemplatecompiler.php.

static eZTemplateCompiler::createCommonCompileTemplate ( ) [static]

Creates the common.php file which has common functions for compiled templates. If the file already exists if will not create it.

Definition at line 1624 of file eztemplatecompiler.php.

Referenced by compileTemplate().

static eZTemplateCompiler::createStaticVariableData ( $  tpl,
$  staticData,
$  variableItemPlacement 
) [static]

Creates a variable data element for the data $staticData and returns it. The type of element depends on the type of the data, strings and booleans are returned as eZTemplate::TYPE_STRING and eZTemplate::TYPE_NUMERIC while other types are turned into text and returned as eZTemplate::TYPE_STRING.

Definition at line 1562 of file eztemplatecompiler.php.

Referenced by inspectVariableData().

static eZTemplateCompiler::currentTextName ( $  parameters) [static]

Figures out the current text name to use in compiled template code and return it. The names will be text, text1, text2 etc.

Definition at line 1713 of file eztemplatecompiler.php.

Referenced by compileTemplate(), and generatePHPCodeChildren().

static eZTemplateCompiler::executeCompilation ( $  tpl,
&$  textElements,
$  key,
&$  resourceData,
$  rootNamespace,
$  currentNamespace 
) [static]

Tries to execute the compiled template and returns true if succsesful. Returns false if caching is disabled or the compiled template could not be executed.

Definition at line 375 of file eztemplatecompiler.php.

Referenced by eZTemplateFileResource\executeCompiledTemplate().

static eZTemplateCompiler::executeCompilationHelper ( $  phpScript,
&$  text,
$  tpl,
$  key,
&$  resourceData,
$  rootNamespace,
$  currentNamespace 
) [static]

Helper function for executeCompilation. Will execute the script $phpScript and set the result text in $text. The parameters $tpl, $resourceData, $rootNamespace and $currentNamespace are passed to the executed template compilation script.

Returns:
true if a text result was created.

Definition at line 413 of file eztemplatecompiler.php.

Referenced by executeCompilation().

static eZTemplateCompiler::fetchTemplatePiece ( $  placementData) [static]

Opens the template files specified in $placementData and fetches the text portion defined by the start and end position. The text is returned or null if the text could not be fetched.

Definition at line 1592 of file eztemplatecompiler.php.

Referenced by generatePHPCodeChildren().

static eZTemplateCompiler::generateMergeNamespaceCode ( $  php,
$  tpl,
$  namespace,
$  namespaceScope,
$  parameters = array(),
$  skipSimpleAssignment = false 
) [static]

Generates PHP code which will do namespace merging. The namespace to merge with is specified in $namespace and the scope of the merging is defined by $namespaceScope.

Definition at line 2614 of file eztemplatecompiler.php.

Referenced by generatePHPCodeChildren(), and generateVariableDataCode().

static eZTemplateCompiler::generatePHPCode ( $  useComments,
$  php,
$  tpl,
&$  node,
&$  resourceData 
) [static]

Generates the PHP code defined in the template node tree $node. The code is generated using the php creator specified in $php.

Definition at line 1737 of file eztemplatecompiler.php.

Referenced by compileTemplate().

static eZTemplateCompiler::generatePHPCodeChildren ( $  useComments,
$  php,
$  tpl,
&$  nodeChildren,
&$  resourceData,
&$  parameters,
$  currentParameters 
) [static]

Generates the PHP code for all node children specified in $nodeChildren.

See also:
generatePHPCode

Definition at line 1759 of file eztemplatecompiler.php.

Referenced by generatePHPCode().

static eZTemplateCompiler::generateVariableCode ( $  php,
$  tpl,
$  node,
&$  knownTypes,
$  dataInspection,
$  parameters,
&$  resourceData 
) [static]

Generates PHP code for the variable node $node. Use generateVariableDataCode if you want to create code for arbitrary variable data structures.

Definition at line 2669 of file eztemplatecompiler.php.

static eZTemplateCompiler::generateVariableDataCode ( $  php,
$  tpl,
$  variableData,
&$  knownTypes,
$  dataInspection,
&$  persistence,
$  parameters,
&$  resourceData 
) [static]

Generates PHP code for the variable tree structure in $variableData. The code will contain string, numeric and identifier assignment, variable lookup, attribute lookup and operator execution. Use generateVariableCode if you want to create code for a variable tree node.

Definition at line 2682 of file eztemplatecompiler.php.

static eZTemplateCompiler::hasCompiledTemplate ( $  key,
$  timestamp,
&$  resourceData 
) [static]
Returns:
true if the compiled template with the key $key exists. A compiled template is found usable when it exists and has a timestamp higher or equal to $timestamp.

Definition at line 352 of file eztemplatecompiler.php.

static eZTemplateCompiler::inspectVariableData ( $  tpl,
$  variableData,
$  variablePlacement,
&$  resourceData 
) [static]

Looks over the variable data $variableData and returns an array with information on the structure. The following entries are generated.

  • is-constant - true if the variable data contains constant data like text and numerics
  • is-variable - true if the variable data is a variable lookup
  • has-operators - true if operators are present
  • has-attributes - true if attributes are used

Definition at line 1363 of file eztemplatecompiler.php.

Referenced by combineStaticNodes(), processNodeCombiningChildren(), and processStaticOptimizations().

static eZTemplateCompiler::isAccumulatorsEnabled ( ) [static]
Returns:
true if template compilation should include debug accumulators.

Definition at line 164 of file eztemplatecompiler.php.

Referenced by compileTemplate().

static eZTemplateCompiler::isCommentsEnabled ( ) [static]
Returns:
true if template compilation should include comments.

Definition at line 124 of file eztemplatecompiler.php.

Referenced by compileTemplate(), executeCompilation(), generatePHPCodeChildren(), eZTemplateMenuFunction\templateNodeTransformation(), eZTemplateToolbarFunction\templateNodeTransformation(), and eZTemplateIncludeFunction\templateNodeTransformation().

static eZTemplateCompiler::isCompilationEnabled ( ) [static]
Returns:
true if template compiling is enabled.
Note:
To change this setting edit settings/site.ini and locate the group TemplateSettings and the entry TemplateCompile.

Definition at line 97 of file eztemplatecompiler.php.

Referenced by eZTemplateFileResource\canCompileTemplate(), compileTemplate(), executeCompilation(), and hasCompiledTemplate().

static eZTemplateCompiler::isDevelopmentModeEnabled ( ) [static]
Returns:
true if template compilation should run in development mode.

When in development mode the system will perform additional checks, e.g. for modification time of compiled file vs original source file. This mode is quite useful for development since it requires less clear-cache calls but has additional file checks and should be turned off for live sites.

Definition at line 147 of file eztemplatecompiler.php.

Referenced by generatePHPCodeChildren().

static eZTemplateCompiler::isExecutionEnabled ( ) [static]
Returns:
true if the compiled template execution is enabled.

Definition at line 232 of file eztemplatecompiler.php.

Referenced by executeCompilation().

static eZTemplateCompiler::isFallbackResourceCodeEnabled ( ) [static]
Returns:
true if resource fallback code should be included.

Definition at line 198 of file eztemplatecompiler.php.

static eZTemplateCompiler::isNodePlacementEnabled ( ) [static]
Returns:
true if template compilation should include comments.

Definition at line 215 of file eztemplatecompiler.php.

Referenced by compileTemplate().

static eZTemplateCompiler::isTimingPointsEnabled ( ) [static]
Returns:
true if template compilation should include debug timing points.

Definition at line 181 of file eztemplatecompiler.php.

Referenced by compileTemplate().

static eZTemplateCompiler::isTreeEnabled ( $  treeName) [static]
Returns:
true if template node tree named $treeName should be included the compiled template.

Definition at line 266 of file eztemplatecompiler.php.

Referenced by compileTemplate().

static eZTemplateCompiler::operatorHint ( $  tpl,
$  operatorName 
) [static]
Returns:
the operator hint for the operator $operatorName, or false if the operator does not exist or has no hints.

Definition at line 1499 of file eztemplatecompiler.php.

Referenced by generateVariableDataCode(), and inspectVariableData().

static eZTemplateCompiler::operatorStaticData ( $  tpl,
$  operatorName 
) [static]
Returns:
static data from operators which support returning static data, or null if no static data could be extracted. The operator is specified in $operatorName.

Definition at line 1533 of file eztemplatecompiler.php.

Referenced by inspectVariableData().

static eZTemplateCompiler::processElementTransformationChild ( $  useComments,
$  php,
$  tpl,
&$  node,
$  elementTree,
$  elementList,
&$  resourceData 
) [static]

Iterates over the children of the function node $node and transforms the tree. If the node is not a function it will return false.

See also:
processNodeTransformationRoot, processNodeTransformationChild

Definition at line 1175 of file eztemplatecompiler.php.

Referenced by processElementTransformationList(), and processNodeTransformationChild().

static eZTemplateCompiler::processElementTransformationList ( $  tpl,
&$  node,
$  elements,
&$  privateData 
) [static]

Iterates over the element list $elements and transforms them.

See also:
processElementTransformationChild

Definition at line 1157 of file eztemplatecompiler.php.

Referenced by eZTemplateCompiledLoop\processChildren(), eZTemplateSwitchFunction\templateNodeCaseTransformation(), eZTemplateIfFunction\templateNodeTransformation(), and eZTemplateSectionFunction\templateNodeTransformation().

static eZTemplateCompiler::processNodeCombining ( $  useComments,
$  php,
$  tpl,
&$  node,
&$  resourceData,
&$  newNode 
) [static]

Iterates over the template node tree and tries to combine multiple static siblings into one element. The original tree is specified in $node and the new combined tree will be present in $newNode.

See also:
processNodeCombiningChildren

Definition at line 625 of file eztemplatecompiler.php.

Referenced by compileTemplate().

static eZTemplateCompiler::processNodeCombiningChildren ( $  useComments,
$  php,
$  tpl,
&$  nodeChildren,
&$  resourceData,
&$  parentNode 
) [static]

Does node combining on the children $nodeChildren.

See also:
processNodeCombining

Definition at line 646 of file eztemplatecompiler.php.

Referenced by processNodeCombining().

static eZTemplateCompiler::processNodeTransformation ( $  useComments,
$  php,
$  tpl,
&$  node,
&$  resourceData,
&$  newNode 
) [static]

Iterates over the template node tree $node and returns a new transformed tree in $newNode.

See also:
processNodeTransformationRoot, processNodeTransformationChild

Definition at line 948 of file eztemplatecompiler.php.

Referenced by compileTemplate().

static eZTemplateCompiler::processNodeTransformationChild ( $  useComments,
$  php,
$  tpl,
&$  node,
&$  resourceData 
) [static]

Iterates over the children of the function node $node and transforms the tree. If the node is not a function it will return false.

See also:
processNodeTransformationRoot, processNodeTransformationChild

Definition at line 1027 of file eztemplatecompiler.php.

Referenced by processNodeTransformationChildren(), and processNodeTransformationRoot().

static eZTemplateCompiler::processNodeTransformationChildren ( $  useComments,
$  php,
$  tpl,
&$  node,
&$  children,
&$  resourceData 
) [static]

Iterates over the children $children and does transformation on them.

See also:
processNodeTransformation, processNodeTransformationChild

Definition at line 970 of file eztemplatecompiler.php.

Referenced by processNodeTransformationNodes().

static eZTemplateCompiler::processNodeTransformationNodes ( $  tpl,
&$  node,
&$  nodes,
&$  privateData 
) [static]

Iterates over the nodes $nodes and does transformation on them.

See also:
processNodeTransformationChildren
Note:
This method can be called from operator and functions as long as they have the $privateData parameter.

Definition at line 958 of file eztemplatecompiler.php.

Referenced by eZTemplateCompiledLoop\processChildren(), eZTemplateSwitchFunction\templateNodeCaseTransformation(), and eZTemplateSectionFunction\templateNodeTransformation().

static eZTemplateCompiler::processNodeTransformationRoot ( $  useComments,
$  php,
$  tpl,
&$  node,
&$  resourceData 
) [static]

Iterates over the children of the root node $node and does transformation on them.

See also:
processNodeTransformation, processNodeTransformationChild

Definition at line 993 of file eztemplatecompiler.php.

Referenced by processNodeTransformation(), and processNodeTransformationChild().

static eZTemplateCompiler::processRemoveNodePlacement ( &$  node) [static]

Iterates over the node tree and removes all placement information.

Definition at line 1316 of file eztemplatecompiler.php.

Referenced by compileTemplate().

static eZTemplateCompiler::processStaticOptimizations ( $  useComments,
$  php,
$  tpl,
&$  node,
&$  resourceData,
&$  newNode 
) [static]

Iterates over the items in the tree $node and tries to extract static data from operators which supports it.

Definition at line 848 of file eztemplatecompiler.php.

Referenced by compileTemplate().

static eZTemplateCompiler::setSettings ( $  settingsMap) [static]

Sets/unsets various compiler settings. To set a setting add a key in the $settingsMap with the wanted value, to unset it use null as the value.

The following values can be set.

  • compile - boolean, whether to compile templates or not
  • comments - boolean, whether to include comments in templates
  • accumulators - boolean, whether to include debug accumulators in templates
  • timingpoints - boolean, whether to include debug timingpoints in templates
  • fallbackresource - boolean, whether to include the fallback resource code
  • nodeplacement - boolean, whether to include information on placement of all nodes
  • execution - boolean, whether to execute the compiled templates or not
  • generate - boolean, whether to always generate the compiled files, or only when template is changed
  • compilation-directory - string, where to place compiled files, the path will be relative from the eZ Publish directory and not the var/cache directory.

Definition at line 82 of file eztemplatecompiler.php.

static eZTemplateCompiler::staticNodeData ( $  node) [static]
Returns:
the static data for the node $node or false if no data could be fetched. Will only return data from text nodes and variables nodes without variable lookup, attribute lookup or operators.

Definition at line 817 of file eztemplatecompiler.php.

Referenced by combineStaticNodes().

static eZTemplateCompiler::TemplatePrefix ( ) [static]

Returns the prefix for file names

Definition at line 55 of file eztemplatecompiler.php.

Referenced by compileTemplate(), createCommonCompileTemplate(), executeCompilationHelper(), generatePHPCodeChildren(), and hasCompiledTemplate().

Member Data Documentation

const eZTemplateCompiler::CODE_DATE = 1074699607

Definition at line 49 of file eztemplatecompiler.php.

Referenced by compileTemplate().

The documentation for this class was generated from the following file: