fenom/docs/en/configuration.md
2014-08-02 00:24:14 +04:00

3.0 KiB
Raw Blame History

Setup

Configure

Template cache

$fenom->setCompileDir($dir);

This method set the name of the directory where template caches are stored. By default this is /tmp. This directory must be writeable.

Template settings

// set options using factory
$fenom = Fenom::factory($tpl_dir, $compile_dir, $options);
// or inline using method setOptions
$fenom->setOptions($options);

Options may by associative array like 'option_name' => true or bitwise mask.

Option name Constant Description Affect
disable_methods Fenom::DENY_METHODS disable calling methods of objects in templates.
disable_native_funcs Fenom::DENY_NATIVE_FUNCS disable calling native function in templates, except allowed.
auto_reload Fenom::AUTO_RELOAD reload template if source will be changed decreases performance
force_compile Fenom::FORCE_COMPILE recompile template every time when the template renders very decreases performance
disable_cache Fenom::DISABLE_CACHE disable compile cache greatly decreases performance
force_include Fenom::FORCE_INCLUDE paste template body instead of include-tag increases performance, increases cache size
auto_escape Fenom::AUTO_ESCAPE html-escape each variables outputs decreases performance
force_verify Fenom::FORCE_VERIFY check existence every used variable decreases performance

| disable_statics | Fenom::DENY_STATICS | disable calling static methods in templates. | | | strip | Fenom::AUTO_STRIP | strip all whitespaces in templates. | decrease cache size |

$fenom->setOptions(array(
    "compile_check" => true,
    "force_include" => true
));
// same
$fenom->setOptions(Fenom::AUTO_RELOAD | Fenom::FORCE_INCLUDE);

Note By default all options disabled

Extends

Template providers

Бывает так что шаблны не хранятся на файловой сиситеме, а хранятся в некотором хранилище, например, в базе данных MySQL. В этом случае шаблонизатору нужно описать как забирать шаблоны из хранилища, как проверять дату изменения шаблона и где хранить кеш шаблонов (опционально). Эту задачу берут на себя Providers, это объекты реальзующие интерфейс Fenom\ProviderInterface.

Callbacks and filters

Before compile callback

$fenom->addPreFilter(function () { /* ... */ });

Tag filter callback

Filter callback

After compile callback