Файл: libs/fenom/Fenom.php
Строк: 822
<?php
/*
* This file is part of Fenom.
*
* (c) 2013 Ivan Shalganov
*
* For the full copyright and license information, please view the license.md
* file that was distributed with this source code.
*/
use FenomProviderInterface;
use FenomTemplate;
/**
* Fenom Template Engine
*
* @author Ivan Shalganov <a.cobest@gmail.com>
*/
class Fenom
{
const VERSION = '2.0';
/* Actions */
const INLINE_COMPILER = 1;
const BLOCK_COMPILER = 5;
const INLINE_FUNCTION = 2;
const BLOCK_FUNCTION = 7;
/* Options */
const DENY_ACCESSOR = 0x8;
const DENY_METHODS = 0x10;
const DENY_NATIVE_FUNCS = 0x20;
const FORCE_INCLUDE = 0x40;
const AUTO_RELOAD = 0x80;
const FORCE_COMPILE = 0x100;
const AUTO_ESCAPE = 0x200;
const DISABLE_CACHE = 0x400;
const FORCE_VERIFY = 0x800;
const AUTO_TRIM = 0x1000; // reserved
const DENY_STATICS = 0x2000;
const AUTO_STRIP = 0x4000;
/* Default parsers */
const DEFAULT_CLOSE_COMPILER = 'FenomCompiler::stdClose';
const DEFAULT_FUNC_PARSER = 'FenomCompiler::stdFuncParser';
const DEFAULT_FUNC_OPEN = 'FenomCompiler::stdFuncOpen';
const DEFAULT_FUNC_CLOSE = 'FenomCompiler::stdFuncClose';
const SMART_FUNC_PARSER = 'FenomCompiler::smartFuncParser';
const MAX_MACRO_RECURSIVE = 32;
/**
* @var int[] of possible options, as associative array
* @see setOptions
*/
private static $_options_list = array(
"disable_accessor" => self::DENY_ACCESSOR,
"disable_methods" => self::DENY_METHODS,
"disable_native_funcs" => self::DENY_NATIVE_FUNCS,
"disable_cache" => self::DISABLE_CACHE,
"force_compile" => self::FORCE_COMPILE,
"auto_reload" => self::AUTO_RELOAD,
"force_include" => self::FORCE_INCLUDE,
"auto_escape" => self::AUTO_ESCAPE,
"force_verify" => self::FORCE_VERIFY,
"auto_trim" => self::AUTO_TRIM,
"disable_statics" => self::DENY_STATICS,
"strip" => self::AUTO_STRIP,
);
/**
* @var callable[]
*/
public $pre_filters = array();
/**
* @var callable[]
*/
public $filters = array();
/**
* @var callable[]
*/
public $tag_filters = array();
/**
* @var callable[]
*/
public $post_filters = array();
/**
* @var FenomRender[] Templates storage
*/
protected $_storage = array();
/**
* @var string compile directory
*/
protected $_compile_dir = "/tmp";
/**
* @var string[] compile directory for custom provider
*/
protected $_compiles = array();
/**
* @var int masked options
*/
protected $_options = 0;
/**
* @var ProviderInterface
*/
private $_provider;
/**
* @var FenomProviderInterface[]
*/
protected $_providers = array();
/**
* @var string[] list of modifiers [modifier_name => callable]
*/
protected $_modifiers = array(
"upper" => 'strtoupper',
"up" => 'strtoupper',
"lower" => 'strtolower',
"low" => 'strtolower',
"date_format" => 'FenomModifier::dateFormat',
"date" => 'FenomModifier::date',
"truncate" => 'FenomModifier::truncate',
"escape" => 'FenomModifier::escape',
"e" => 'FenomModifier::escape', // alias of escape
"unescape" => 'FenomModifier::unescape',
"strip" => 'FenomModifier::strip',
"length" => 'FenomModifier::length',
"iterable" => 'FenomModifier::isIterable',
"replace" => 'FenomModifier::replace',
"ereplace" => 'FenomModifier::ereplace',
"match" => 'FenomModifier::match',
"ematch" => 'FenomModifier::ematch',
"split" => 'FenomModifier::split',
"esplit" => 'FenomModifier::esplit',
"join" => 'FenomModifier::join',
"in" => 'FenomModifier::in',
);
/**
* @var array of allowed PHP functions
*/
protected $_allowed_funcs = array(
"count" => 1,
"is_string" => 1,
"is_array" => 1,
"is_numeric" => 1,
"is_int" => 1,
'constant' => 1,
"is_object" => 1,
"strtotime" => 1,
"gettype" => 1,
"is_double" => 1,
"json_encode" => 1,
"json_decode" => 1,
"ip2long" => 1,
"long2ip" => 1,
"strip_tags" => 1,
"nl2br" => 1,
"explode" => 1,
"implode" => 1
);
/**
* @var array[] of compilers and functions
*/
protected $_actions = array(
'foreach' => array( // {foreach ...} {break} {continue} {foreachelse} {/foreach}
'type' => self::BLOCK_COMPILER,
'open' => 'FenomCompiler::foreachOpen',
'close' => 'FenomCompiler::foreachClose',
'tags' => array(
'foreachelse' => 'FenomCompiler::foreachElse',
'break' => 'FenomCompiler::tagBreak',
'continue' => 'FenomCompiler::tagContinue',
),
'float_tags' => array('break' => 1, 'continue' => 1)
),
'if' => array( // {if ...} {elseif ...} {else} {/if}
'type' => self::BLOCK_COMPILER,
'open' => 'FenomCompiler::ifOpen',
'close' => 'FenomCompiler::stdClose',
'tags' => array(
'elseif' => 'FenomCompiler::tagElseIf',
'else' => 'FenomCompiler::tagElse'
)
),
'switch' => array( // {switch ...} {case ..., ...} {default} {/switch}
'type' => self::BLOCK_COMPILER,
'open' => 'FenomCompiler::switchOpen',
'close' => 'FenomCompiler::switchClose',
'tags' => array(
'case' => 'FenomCompiler::tagCase',
'default' => 'FenomCompiler::tagDefault'
),
'float_tags' => array('break' => 1)
),
'for' => array( // {for ...} {break} {continue} {/for}
'type' => self::BLOCK_COMPILER,
'open' => 'FenomCompiler::forOpen',
'close' => 'FenomCompiler::forClose',
'tags' => array(
'forelse' => 'FenomCompiler::forElse',
'break' => 'FenomCompiler::tagBreak',
'continue' => 'FenomCompiler::tagContinue',
),
'float_tags' => array('break' => 1, 'continue' => 1)
),
'while' => array( // {while ...} {break} {continue} {/while}
'type' => self::BLOCK_COMPILER,
'open' => 'FenomCompiler::whileOpen',
'close' => 'FenomCompiler::stdClose',
'tags' => array(
'break' => 'FenomCompiler::tagBreak',
'continue' => 'FenomCompiler::tagContinue',
),
'float_tags' => array('break' => 1, 'continue' => 1)
),
'include' => array( // {include ...}
'type' => self::INLINE_COMPILER,
'parser' => 'FenomCompiler::tagInclude'
),
'insert' => array( // {include ...}
'type' => self::INLINE_COMPILER,
'parser' => 'FenomCompiler::tagInsert'
),
'var' => array( // {var ...}
'type' => self::BLOCK_COMPILER,
'open' => 'FenomCompiler::setOpen',
'close' => 'FenomCompiler::setClose'
),
'set' => array( // {set ...}
'type' => self::BLOCK_COMPILER,
'open' => 'FenomCompiler::setOpen',
'close' => 'FenomCompiler::setClose'
),
'add' => array( // {add ...}
'type' => self::BLOCK_COMPILER,
'open' => 'FenomCompiler::setOpen',
'close' => 'FenomCompiler::setClose'
),
'block' => array( // {block ...} {parent} {/block}
'type' => self::BLOCK_COMPILER,
'open' => 'FenomCompiler::tagBlockOpen',
'close' => 'FenomCompiler::tagBlockClose',
'tags' => array('parent' => 'FenomCompiler::tagParent'),
'float_tags' => array('parent' => 1)
),
'extends' => array( // {extends ...}
'type' => self::INLINE_COMPILER,
'parser' => 'FenomCompiler::tagExtends'
),
'use' => array( // {use}
'type' => self::INLINE_COMPILER,
'parser' => 'FenomCompiler::tagUse'
),
'filter' => array( // {filter} ... {/filter}
'type' => self::BLOCK_COMPILER,
'open' => 'FenomCompiler::filterOpen',
'close' => 'FenomCompiler::filterClose'
),
'macro' => array(
'type' => self::BLOCK_COMPILER,
'open' => 'FenomCompiler::macroOpen',
'close' => 'FenomCompiler::macroClose'
),
'import' => array(
'type' => self::INLINE_COMPILER,
'parser' => 'FenomCompiler::tagImport'
),
'cycle' => array(
'type' => self::INLINE_COMPILER,
'parser' => 'FenomCompiler::tagCycle'
),
'raw' => array(
'type' => self::INLINE_COMPILER,
'parser' => 'FenomCompiler::tagRaw'
),
'autoescape' => array( // deprecated
'type' => self::BLOCK_COMPILER,
'open' => 'FenomCompiler::escapeOpen',
'close' => 'FenomCompiler::nope'
),
'escape' => array(
'type' => self::BLOCK_COMPILER,
'open' => 'FenomCompiler::escapeOpen',
'close' => 'FenomCompiler::nope'
),
'strip' => array(
'type' => self::BLOCK_COMPILER,
'open' => 'FenomCompiler::stripOpen',
'close' => 'FenomCompiler::nope'
),
'ignore' => array(
'type' => self::BLOCK_COMPILER,
'open' => 'FenomCompiler::ignoreOpen',
'close' => 'FenomCompiler::nope'
),
'unset' => array(
'type' => self::INLINE_COMPILER,
'parser' => 'FenomCompiler::tagUnset'
)
);
/**
* List of tests
* @see https://github.com/bzick/fenom/blob/develop/docs/operators.md#test-operator
* @var array
*/
protected $_tests = array(
'integer' => 'is_int(%s)',
'int' => 'is_int(%s)',
'float' => 'is_float(%s)',
'double' => 'is_float(%s)',
'decimal' => 'is_float(%s)',
'string' => 'is_string(%s)',
'bool' => 'is_bool(%s)',
'boolean' => 'is_bool(%s)',
'number' => 'is_numeric(%s)',
'numeric' => 'is_numeric(%s)',
'scalar' => 'is_scalar(%s)',
'object' => 'is_object(%s)',
'callable' => 'is_callable(%s)',
'callback' => 'is_callable(%s)',
'array' => 'is_array(%s)',
'iterable' => 'FenomModifier::isIterable(%s)',
'const' => 'defined(%s)',
'template' => '$tpl->getStorage()->templateExists(%s)',
'empty' => 'empty(%s)',
'set' => 'isset(%s)',
'_empty' => '!%s', // for none variable
'_set' => '(%s !== null)', // for none variable
'odd' => '(%s & 1)',
'even' => '!(%s %% 2)',
'third' => '!(%s %% 3)'
);
/**
* Just factory
*
* @param string|FenomProviderInterface $source path to templates or custom provider
* @param string $compile_dir path to compiled files
* @param int|array $options
* @throws InvalidArgumentException
* @return Fenom
*/
public static function factory($source, $compile_dir = '/tmp', $options = 0)
{
if (is_string($source)) {
$provider = new FenomProvider($source);
} elseif ($source instanceof ProviderInterface) {
$provider = $source;
} else {
throw new InvalidArgumentException("Source must be a valid path or provider object");
}
$fenom = new static($provider);
/* @var Fenom $fenom */
$fenom->setCompileDir($compile_dir);
if ($options) {
$fenom->setOptions($options);
}
return $fenom;
}
/**
* @param FenomProviderInterface $provider
*/
public function __construct(FenomProviderInterface $provider)
{
$this->_provider = $provider;
}
/**
* Set compile directory
*
* @param string $dir directory to store compiled templates in
* @throws LogicException
* @return Fenom
*/
public function setCompileDir($dir)
{
if (!is_writable($dir)) {
throw new LogicException("Cache directory $dir is not writable");
}
$this->_compile_dir = $dir;
return $this;
}
/**
*
* @param callable $cb
* @return self
*/
public function addPreFilter($cb)
{
$this->pre_filters[] = $cb;
return $this;
}
public function getPreFilters()
{
return $this->pre_filters;
}
/**
*
* @param callable $cb
* @return self
*/
public function addPostFilter($cb)
{
$this->post_filters[] = $cb;
return $this;
}
public function getPostFilters()
{
return $this->post_filters;
}
/**
* @param callable $cb
* @return self
*/
public function addFilter($cb)
{
$this->filters[] = $cb;
return $this;
}
public function getFilters()
{
return $this->filters;
}
/**
* @param callable $cb
* @return self
*/
public function addTagFilter($cb)
{
$this->tag_filters[] = $cb;
return $this;
}
public function getTagFilters()
{
return $this->tag_filters;
}
/**
* Add modifier
*
* @param string $modifier the modifier name
* @param string $callback the modifier callback
* @return Fenom
*/
public function addModifier($modifier, $callback)
{
$this->_modifiers[$modifier] = $callback;
return $this;
}
/**
* Add inline tag compiler
*
* @param string $compiler
* @param callable $parser
* @return Fenom
*/
public function addCompiler($compiler, $parser)
{
$this->_actions[$compiler] = array(
'type' => self::INLINE_COMPILER,
'parser' => $parser
);
return $this;
}
/**
* @param string $compiler
* @param string|object $storage
* @return $this
*/
public function addCompilerSmart($compiler, $storage)
{
if (method_exists($storage, "tag" . $compiler)) {
$this->_actions[$compiler] = array(
'type' => self::INLINE_COMPILER,
'parser' => array($storage, "tag" . $compiler)
);
}
return $this;
}
/**
* Add block compiler
*
* @param string $compiler
* @param callable $open_parser
* @param callable|string $close_parser
* @param array $tags
* @return Fenom
*/
public function addBlockCompiler(
$compiler,
$open_parser,
$close_parser = self::DEFAULT_CLOSE_COMPILER,
array $tags = array()
) {
$this->_actions[$compiler] = array(
'type' => self::BLOCK_COMPILER,
'open' => $open_parser,
'close' => $close_parser ? : self::DEFAULT_CLOSE_COMPILER,
'tags' => $tags,
);
return $this;
}
/**
* @param $compiler
* @param $storage
* @param array $tags
* @param array $floats
* @throws LogicException
* @return Fenom
*/
public function addBlockCompilerSmart($compiler, $storage, array $tags, array $floats = array())
{
$c = array(
'type' => self::BLOCK_COMPILER,
"tags" => array(),
"float_tags" => array()
);
if (method_exists($storage, $compiler . "Open")) {
$c["open"] = array($storage, $compiler . "Open");
} else {
throw new LogicException("Open compiler {$compiler}Open not found");
}
if (method_exists($storage, $compiler . "Close")) {
$c["close"] = array($storage, $compiler . "Close");
} else {
throw new LogicException("Close compiler {$compiler}Close not found");
}
foreach ($tags as $tag) {
if (method_exists($storage, "tag" . $tag)) {
$c["tags"][$tag] = array($storage, "tag" . $tag);
if ($floats && in_array($tag, $floats)) {
$c['float_tags'][$tag] = 1;
}
} else {
throw new LogicException("Tag compiler $tag (tag{$compiler}) not found");
}
}
$this->_actions[$compiler] = $c;
return $this;
}
/**
* @param string $function
* @param callable $callback
* @param callable|string $parser
* @return Fenom
*/
public function addFunction($function, $callback, $parser = self::DEFAULT_FUNC_PARSER)
{
$this->_actions[$function] = array(
'type' => self::INLINE_FUNCTION,
'parser' => $parser,
'function' => $callback,
);
return $this;
}
/**
* @param string $function
* @param callable $callback
* @return Fenom
*/
public function addFunctionSmart($function, $callback)
{
$this->_actions[$function] = array(
'type' => self::INLINE_FUNCTION,
'parser' => self::SMART_FUNC_PARSER,
'function' => $callback,
);
return $this;
}
/**
* @param string $function
* @param callable $callback
* @param callable|string $parser_open
* @param callable|string $parser_close
* @return Fenom
*/
public function addBlockFunction(
$function,
$callback,
$parser_open = self::DEFAULT_FUNC_OPEN,
$parser_close = self::DEFAULT_FUNC_CLOSE
) {
$this->_actions[$function] = array(
'type' => self::BLOCK_FUNCTION,
'open' => $parser_open,
'close' => $parser_close,
'function' => $callback,
);
return $this;
}
/**
* @param array $funcs
* @return Fenom
*/
public function addAllowedFunctions(array $funcs)
{
$this->_allowed_funcs = $this->_allowed_funcs + array_flip($funcs);
return $this;
}
/**
* Add custom test
* @param string $name test name
* @param string $code test PHP code. Code may contains placeholder %s, which will be replaced by test-value. For example: is_callable(%s)
*/
public function addTest($name, $code)
{
$this->_tests[$name] = $code;
}
/**
* Get test code by name
* @param string $name
* @return string|bool
*/
public function getTest($name)
{
return isset($this->_tests[$name]) ? $this->_tests[$name] : false;
}
/**
* Return modifier function
*
* @param string $modifier
* @param FenomTemplate $template
* @return mixed
*/
public function getModifier($modifier, Template $template = null)
{
if (isset($this->_modifiers[$modifier])) {
return $this->_modifiers[$modifier];
} elseif ($this->isAllowedFunction($modifier)) {
return $modifier;
} else {
return $this->_loadModifier($modifier, $template);
}
}
/**
* Modifier autoloader
* @param string $modifier
* @param FenomTemplate $template
* @return bool
*/
protected function _loadModifier($modifier, $template)
{
return false;
}
/**
* Returns tag info
*
* @param string $tag
* @param FenomTemplate $template
* @return string|bool
*/
public function getTag($tag, Template $template = null)
{
if (isset($this->_actions[$tag])) {
return $this->_actions[$tag];
} else {
return $this->_loadTag($tag, $template);
}
}
/**
* Tags autoloader
* @param string $tag
* @param FenomTemplate $template
* @return bool
*/
protected function _loadTag($tag, $template)
{
return false;
}
/**
* @param string $function
* @return bool
*/
public function isAllowedFunction($function)
{
if ($this->_options & self::DENY_NATIVE_FUNCS) {
return isset($this->_allowed_funcs[$function]);
} else {
return is_callable($function);
}
}
/**
* @param string $tag
* @return array
*/
public function getTagOwners($tag)
{
$tags = array();
foreach ($this->_actions as $owner => $params) {
if (isset($params["tags"][$tag])) {
$tags[] = $owner;
}
}
return $tags;
}
/**
* Add source template provider by scheme
*
* @param string $scm scheme name
* @param FenomProviderInterface $provider provider object
* @param string $compile_path
* @return $this
*/
public function addProvider($scm, FenomProviderInterface $provider, $compile_path = null)
{
$this->_providers[$scm] = $provider;
if ($compile_path) {
$this->_compiles[$scm] = $compile_path;
}
return $this;
}
/**
* Set options
* @param int|array $options
* @return $this
*/
public function setOptions($options)
{
if (is_array($options)) {
$options = self::_makeMask($options, self::$_options_list, $this->_options);
}
$this->_storage = array();
$this->_options = $options;
return $this;
}
/**
* Get options as bits
* @return int
*/
public function getOptions()
{
return $this->_options;
}
/**
* @param bool|string $scm
* @return FenomProviderInterface
* @throws InvalidArgumentException
*/
public function getProvider($scm = false)
{
if ($scm) {
if (isset($this->_providers[$scm])) {
return $this->_providers[$scm];
} else {
throw new InvalidArgumentException("Provider for '$scm' not found");
}
} else {
return $this->_provider;
}
}
/**
* Return empty template
*
* @return FenomTemplate
*/
public function getRawTemplate()
{
return new Template($this, $this->_options);
}
/**
* Execute template and write result into stdout
*
* @param string $template name of template
* @param array $vars array of data for template
* @return FenomRender
*/
public function display($template, array $vars = array())
{
return $this->getTemplate($template)->display($vars);
}
/**
*
* @param string $template name of template
* @param array $vars array of data for template
* @return mixed
*/
public function fetch($template, array $vars = array())
{
return $this->getTemplate($template)->fetch($vars);
}
/**
* Creates pipe-line of template's data to callback
* @note Method not works correctly in old PHP 5.3.*
* @param string $template name of the template
* @param callable $callback template's data handler
* @param array $vars
* @param float $chunk amount of bytes of chunk
* @return array
*/
public function pipe($template, $callback, array $vars = array(), $chunk = 1e6)
{
ob_start($callback, $chunk, PHP_OUTPUT_HANDLER_STDFLAGS);
$data = $this->getTemplate($template)->display($vars);
ob_end_flush();
return $data;
}
/**
* Get template by name
*
* @param string $template template name with schema
* @param int $options additional options and flags
* @return FenomTemplate
*/
public function getTemplate($template, $options = 0)
{
$options |= $this->_options;
if (is_array($template)) {
$key = dechex($options) . "@" . implode(",", $template);
} else {
$key = dechex($options) . "@" . $template;
}
if (isset($this->_storage[$key])) {
/** @var FenomTemplate $tpl */
$tpl = $this->_storage[$key];
if (($this->_options & self::AUTO_RELOAD) && !$tpl->isValid()) {
return $this->_storage[$key] = $this->compile($template, true, $options);
} else {
return $tpl;
}
} elseif ($this->_options & self::FORCE_COMPILE) {
return $this->compile($template, $this->_options & self::DISABLE_CACHE & ~self::FORCE_COMPILE, $options);
} else {
return $this->_storage[$key] = $this->_load($template, $options);
}
}
/**
* Check if template exists
* @param string $template
* @return bool
*/
public function templateExists($template)
{
if ($provider = strstr($template, ":", true)) {
if (isset($this->_providers[$provider])) {
return $this->_providers[$provider]->templateExists(substr($template, strlen($provider) + 1));
}
} else {
return $this->_provider->templateExists($template);
}
return false;
}
/**
* Load template from cache or create cache if it doesn't exists.
*
* @param string $template
* @param int $opts
* @return FenomRender
*/
protected function _load($template, $opts)
{
$file_name = $this->_getCacheName($template, $opts);
if (is_file($this->_compile_dir . "/" . $file_name)) {
$fenom = $this; // used in template
$_tpl = include($this->_compile_dir . "/" . $file_name);
/* @var FenomRender $_tpl */
if (!($this->_options & self::AUTO_RELOAD) || ($this->_options & self::AUTO_RELOAD) && $_tpl->isValid()) {
return $_tpl;
}
}
return $this->compile($template, true, $opts);
}
/**
* Generate unique name of compiled template
*
* @param string $tpl
* @param int $options
* @return string
*/
private function _getCacheName($tpl, $options)
{
if (is_array($tpl)) {
$hash = implode(".", $tpl) . ":" . $options;
foreach ($tpl as &$t) {
$t = str_replace(":", "_", basename($t));
}
return implode("~", $tpl) . "." . sprintf("%x.%x.php", crc32($hash), strlen($hash));
} else {
$hash = $tpl . ":" . $options;
return sprintf("%s.%x.%x.php", str_replace(":", "_", basename($tpl)), crc32($hash), strlen($hash));
}
}
/**
* Compile and save template
*
* @param string|array $tpl
* @param bool $store store template on disk
* @param int $options
* @throws RuntimeException
* @return FenomTemplate
*/
public function compile($tpl, $store = true, $options = 0)
{
$options = $this->_options | $options;
if (is_string($tpl)) {
$template = $this->getRawTemplate()->load($tpl);
} else {
$template = $this->getRawTemplate()->load($tpl[0], false);
unset($tpl[0]);
foreach ($tpl as $t) {
$template->extend($t);
}
}
if ($store) {
$cache = $this->_getCacheName($tpl, $options);
$tpl_tmp = tempnam($this->_compile_dir, $cache);
$tpl_fp = fopen($tpl_tmp, "w");
if (!$tpl_fp) {
throw new RuntimeException("Can't to open temporary file $tpl_tmp. Directory " . $this->_compile_dir . " is writable?");
}
fwrite($tpl_fp, $template->getTemplateCode());
fclose($tpl_fp);
$file_name = $this->_compile_dir . "/" . $cache;
if (!rename($tpl_tmp, $file_name)) {
throw new RuntimeException("Can't to move $tpl_tmp to $file_name");
}
}
return $template;
}
/**
* Flush internal memory template cache
*/
public function flush()
{
$this->_storage = array();
}
/**
* Remove all compiled templates
*/
public function clearAllCompiles()
{
FenomProvider::clean($this->_compile_dir);
}
/**
* Compile code to template
*
* @param string $code
* @param string $name
* @return FenomTemplate
*/
public function compileCode($code, $name = 'Runtime compile')
{
return $this->getRawTemplate()->source($name, $code);
}
/**
* Create bit-mask from associative array use fully associative array possible keys with bit values
* @static
* @param array $values custom assoc array, ["a" => true, "b" => false]
* @param array $options possible values, ["a" => 0b001, "b" => 0b010, "c" => 0b100]
* @param int $mask the initial value of the mask
* @return int result, ( $mask | a ) & ~b
* @throws RuntimeException if key from custom assoc doesn't exists into possible values
*/
private static function _makeMask(array $values, array $options, $mask = 0)
{
foreach ($values as $key => $value) {
if (isset($options[$key])) {
if ($value) {
$mask |= $options[$key];
} else {
$mask &= ~$options[$key];
}
} else {
throw new RuntimeException("Undefined parameter $value");
}
}
return $mask;
}
/**
* Register PSR-0 autoload
* @param string $dir custom directory for autoloading, if NULL — autoload itself
* @return bool
*/
public static function registerAutoload($dir = null)
{
if (!$dir) {
$dir = __DIR__;
}
return spl_autoload_register(
function ($classname) use ($dir) {
$file = $dir . DIRECTORY_SEPARATOR . str_replace('\', DIRECTORY_SEPARATOR, $classname) . '.php';
if (is_file($file)) {
require_once $file;
}
}
);
}
}