Smarty

About 2 min

Smarty

Smarty 2.0 Templates.

This class implements the entire Smarty 2.0 template specification. For documentation on the Smarty 2.0 template format see the Smarty 2.0 online documentation: https://www.smarty.net/docsv2/en/

Tags are in the format of {$tagname}. This tag would reference a parameter passed to the parser with the array key value of 'tagname'. Such as:

$tpl = new \Hazaar\Template\Smarty($templateContent);
$tpl->render(['tagname' => 'Hello, World!']);

Properties

templatePrefix

public string $templatePrefix = '_smarty_template_'

sourceFile

public string $sourceFile

allowGlobals

public bool $allowGlobals = true

functions

public array $functions

compiler

public Compiler $compiler

customFunctions

protected array $customFunctions

content

protected string $content

includes

protected array $includes

filters

private array $filters

functionHandlers

private array $functionHandlers

Methods

__construct

Create a new Smarty template object.

public __construct(?string $content, ?Compiler $compiler): void

Parameters

Parameter	Type	Description
`$content`	`string`
`$compiler`	`Compiler`

loadFromString

Load the SMARTy template from a supplied string.

public loadFromString(string $content): void

Parameters

Parameter	Type	Description
`$content`	`string`	The template source code

loadFromFile

Read the template from a file.

public loadFromFile(File $file): void

Parameters

Parameter	Type	Description
`$file`	`File`	can be either a Hazaar\File object or a string to a file on disk

registerFunction

public registerFunction(string $functionName, callable $callback): void

Custom functions are functions that can be called from within the template. The function must be defined in the template and can be called using the syntax:

{$functionName param1="value" param2="value"}

The function will be called with the parameters as an array. The function must return a string which will be inserted into the template at the point the function was called.

Parameters

Parameter	Type	Description
`$functionName`	`string`
`$callback`	`callable`

registerFunctionHandler

public registerFunctionHandler(mixed $handler): void

Customer function handlers are objects that can be used to handle custom functions in the template. A custom function is a function that is not built-in and is defined in the template and can be called using the syntax:

{$functionName param1="value" param2="value"}

You can register multiple custom function handlers. The first handler that contains a method with the same name as the function will be used to handle the function.

Parameters

Parameter	Type	Description
`$handler`	`mixed`

getTemplate

Returns the original un-compiled template.

public getTemplate(): string

getTemplateFile

Retrieves the template file path.

public getTemplateFile(): ?string

prepend

Prepend a string to the existing content.

public prepend(string $string): void

Parameters

Parameter	Type	Description
`$string`	`string`

append

Append a string to the existing content.

public append(string $string): void

Parameters

Parameter	Type	Description
`$string`	`string`

addFilter

Add a post-processing filter to the template.

public addFilter(\Closure $filter): void

Filters are applied after the template has been rendered and can be used to modify the output. Useful for things like minifying the output or removing whitespace.

Parameters

Parameter	Type	Description
`$filter`	`\Closure`

render

Render the template with the supplied parameters and return the rendered content.

public render(array $params): string

Parameters

Parameter	Type	Description
`$params`	`array`	parameters to use when embedding variables in the rendered template

prepareRendererClass

Prepare the renderer class.

private prepareRendererClass(): string

prepareEvalRenderer

private prepareEvalRenderer(): string

preparePHPRenderer

private preparePHPRenderer(): string

checkFilesChanged

Check if any of the files have changed sinace the template was last compiled.

private checkFilesChanged(array $watchFiles, int $timestamp): bool

Parameters

Parameter	Type	Description
`$watchFiles`	`array`	The files to check for changes
`$timestamp`	`int`	The timestamp of the template file

Generated by Hazaar API Doc Generator