Example:setPath("somefolder","otherfolder"); * * @param null|string|string[] $templatePath If null then it uses the current path /views folder * @param null|string $compiledPath If null then it uses the current path /views folder */ public function setPath($templatePath, $compiledPath): void { if ($templatePath === null) { $templatePath = \getcwd() . '/views'; } if ($compiledPath === null) { $compiledPath = \getcwd() . '/compiles'; } $this->templatePath = (is_array($templatePath)) ? $templatePath : [$templatePath]; $this->compiledPath = $compiledPath; } /** * @return array */ public function getAliasClasses(): array { return $this->aliasClasses; } /** * @param array $aliasClasses */ public function setAliasClasses($aliasClasses): void { $this->aliasClasses = $aliasClasses; } /** * @param string $aliasName * @param string $classWithNS */ public function addAliasClasses($aliasName, $classWithNS): void { $this->aliasClasses[$aliasName] = $classWithNS; } // // /** * Authentication. Sets with a user,role and permission * * @param string $user * @param null $role * @param array $permission */ public function setAuth($user = '', $role = null, $permission = []): void { $this->currentUser = $user; $this->currentRole = $role; $this->currentPermission = $permission; } /** * run the blade engine. It returns the result of the code. * * @param string $string HTML to parse * @param array $data It is an associative array with the datas to display. * @return string It returns a parsed string * @throws Exception */ public function runString($string, $data = []): string { $php = $this->compileString($string); $obLevel = \ob_get_level(); \ob_start(); \extract($data, EXTR_SKIP); $previousError = \error_get_last(); try { @eval('?' . '>' . $php); } catch (Exception $e) { while (\ob_get_level() > $obLevel) { \ob_end_clean(); } throw $e; } catch (\Throwable $e) { // PHP >= 7 while (\ob_get_level() > $obLevel) { \ob_end_clean(); } $this->showError('runString', $e->getMessage() . ' ' . $e->getCode(), true); return ''; } $lastError = \error_get_last(); // PHP 5.6 if ($previousError != $lastError && $lastError['type'] == E_PARSE) { while (\ob_get_level() > $obLevel) { \ob_end_clean(); } $this->showError('runString', $lastError['message'] . ' ' . $lastError['type'], true); return ''; } return $this->postRun(\ob_get_clean()); } /** * Compile the given Blade template contents. * * @param string $value * @return string */ public function compileString($value): string { $result = ''; if (\strpos($value, '@verbatim') !== false) { $value = $this->storeVerbatimBlocks($value); } $this->footer = []; // Here we will loop through all the tokens returned by the Zend lexer and // parse each one into the corresponding valid PHP. We will then have this // template as the correctly rendered PHP that can be rendered natively. foreach (\token_get_all($value) as $token) { $result .= \is_array($token) ? $this->parseToken($token) : $token; } if (!empty($this->verbatimBlocks)) { $result = $this->restoreVerbatimBlocks($result); } // If there are any footer lines that need to get added to a template we will // add them here at the end of the template. This gets used mainly for the // template inheritance via the extends keyword that should be appended. if (\count($this->footer) > 0) { $result = \ltrim($result, PHP_EOL) . PHP_EOL . \implode(PHP_EOL, \array_reverse($this->footer)); } return $result; } /** * Store the verbatim blocks and replace them with a temporary placeholder. * * @param string $value * @return string */ protected function storeVerbatimBlocks($value): string { return \preg_replace_callback('/(?verbatimBlocks[] = $matches[1]; return $this->verbatimPlaceholder; }, $value); } /** * Parse the tokens from the template. * * @param array $token * * @return string * * @see BladeOne::compileStatements * @see BladeOne::compileExtends * @see BladeOne::compileComments * @see BladeOne::compileEchos */ protected function parseToken($token): string { [$id, $content] = $token; if ($id == T_INLINE_HTML) { foreach ($this->compilers as $type) { $content = $this->{"compile$type"}($content); } } return $content; } /** * Replace the raw placeholders with the original code stored in the raw blocks. * * @param string $result * @return string */ protected function restoreVerbatimBlocks($result): string { $result = \preg_replace_callback('/' . \preg_quote($this->verbatimPlaceholder) . '/', function() { return \array_shift($this->verbatimBlocks); }, $result); $this->verbatimBlocks = []; return $result; } /** * it calculates the relative path of a web.
* This function uses the current url and the baseurl * * @param string $relativeWeb . Example img/images.jpg * @return string Example ../../img/images.jpg */ public function relative($relativeWeb): string { return $this->assetDict[$relativeWeb] ?? ($this->relativePath . $relativeWeb); } /** * It adds an alias to the link of the resources.
* addAssetDict('name','url/res.jpg')
* addAssetDict(['name'=>'url/res.jpg','name2'=>'url/res2.jpg']); * * @param string|array $name example 'css/style.css', you could also add an array * @param string $url example https://www.web.com/style.css' */ public function addAssetDict($name, $url = ''): void { if (\is_array($name)) { $this->assetDict = \array_merge($this->assetDict, $name); } else { $this->assetDict[$name] = $url; } } public function addAssetDictCDN($name, $url = ''): void { if (\is_array($name)) { $this->assetDictCDN = \array_merge($this->assetDictCDN, $name); } else { $this->assetDictCDN[$name] = $url; } } /** * Compile the push statements into valid PHP. * * @param string $expression * @return string * @see BladeOne::startPush */ public function compilePush($expression): string { return $this->phpTag . "\$this->startPush$expression; ?>"; } /** * Compile the push statements into valid PHP. * * @param string $expression * @return string * @see BladeOne::startPush */ public function compilePushOnce($expression): string { $key = '$__pushonce__' . \trim(\substr($expression, 2, -2)); return $this->phpTag . "if(!isset($key)): $key=1; \$this->startPush$expression; ?>"; } /** * Compile the push statements into valid PHP. * * @param string $expression * @return string * @see BladeOne::startPush */ public function compilePrepend($expression): string { return $this->phpTag . "\$this->startPush$expression; ?>"; } /** * Start injecting content into a push section. * * @param string $section * @param string $content * @return void */ public function startPush($section, $content = ''): void { if ($content === '') { if (\ob_start()) { $this->pushStack[] = $section; } } else { $this->extendPush($section, $content); } } /* * endswitch tag */ /** * Append content to a given push section. * * @param string $section * @param string $content * @return void */ protected function extendPush($section, $content): void { if (!isset($this->pushes[$section])) { $this->pushes[$section] = []; // start an empty section } if (!isset($this->pushes[$section][$this->renderCount])) { $this->pushes[$section][$this->renderCount] = $content; } else { $this->pushes[$section][$this->renderCount] .= $content; } } /** * Start injecting content into a push section. * * @param string $section * @param string $content * @return void */ public function startPrepend($section, $content = ''): void { if ($content === '') { if (\ob_start()) { \array_unshift($this->pushStack[], $section); } } else { $this->extendPush($section, $content); } } /** * Stop injecting content into a push section. * * @return string */ public function stopPush(): string { if (empty($this->pushStack)) { $this->showError('stopPush', 'Cannot end a section without first starting one', true); } $last = \array_pop($this->pushStack); $this->extendPush($last, \ob_get_clean()); return $last; } /** * Stop injecting content into a push section. * * @return string */ public function stopPrepend(): string { if (empty($this->pushStack)) { $this->showError('stopPrepend', 'Cannot end a section without first starting one', true); } $last = \array_shift($this->pushStack); $this->extendStartPush($last, \ob_get_clean()); return $last; } /** * Append content to a given push section. * * @param string $section * @param string $content * @return void */ protected function extendStartPush($section, $content): void { if (!isset($this->pushes[$section])) { $this->pushes[$section] = []; // start an empty section } if (!isset($this->pushes[$section][$this->renderCount])) { $this->pushes[$section][$this->renderCount] = $content; } else { $this->pushes[$section][$this->renderCount] = $content . $this->pushes[$section][$this->renderCount]; } } /** * Get the string contents of a push section. * * @param string $section the name of the section * @param string $default the default name of the section is not found. * @return string */ public function yieldPushContent($section, $default = ''): string { if ($section === null || $section === '') { return $default; } if ($section[-1] === '*') { $keys = array_keys($this->pushes); $findme = rtrim($section, '*'); $result = ""; foreach ($keys as $key) { if (strpos($key, $findme) === 0) { $result .= \implode(\array_reverse($this->pushes[$key])); } } return $result; } if (!isset($this->pushes[$section])) { return $default; } return \implode(\array_reverse($this->pushes[$section])); } /** * Get the string contents of a push section. * * @param int|string $each if "int", then it split the foreach every $each numbers.
* if "string" or "c3", then it means that it will split in 3 columns
* @param string $splitText * @param string $splitEnd * @return string */ public function splitForeach($each = 1, $splitText = ',', $splitEnd = ''): string { $loopStack = static::last($this->loopsStack); // array(7) { ["index"]=> int(0) ["remaining"]=> int(6) ["count"]=> int(5) ["first"]=> bool(true) ["last"]=> bool(false) ["depth"]=> int(1) ["parent"]=> NULL } if (($loopStack['index']) == $loopStack['count'] - 1) { return $splitEnd; } $eachN = 0; if (is_numeric($each)) { $eachN = $each; } elseif (strlen($each) > 1) { if ($each[0] === 'c') { $eachN = round($loopStack['count'] / substr($each, 1)); } } else { $eachN = PHP_INT_MAX; } if (($loopStack['index'] + 1) % $eachN === 0) { return $splitText; } return ''; } /** * Return the last element in an array passing a given truth test. * * @param array $array * @param callable|null $callback * @param mixed $default * @return mixed */ public static function last($array, ?callable $callback = null, $default = null) { if (\is_null($callback)) { return empty($array) ? static::value($default) : \end($array); } return static::first(\array_reverse($array), $callback, $default); } /** * Return the default value of the given value. * * @param mixed $value * @return mixed */ public static function value($value) { return $value instanceof Closure ? $value() : $value; } /** * Return the first element in an array passing a given truth test. * * @param array $array * @param callable|null $callback * @param mixed $default * @return mixed */ public static function first($array, ?callable $callback = null, $default = null) { if (\is_null($callback)) { return empty($array) ? static::value($default) : \reset($array); } foreach ($array as $key => $value) { if ($callback($key, $value)) { return $value; } } return static::value($default); } /** * @param string $name * @param $args [] * @return string * @throws BadMethodCallException */ public function __call($name, $args) { if ($name === 'if') { return $this->registerIfStatement($args[0] ?? null, $args[1] ?? null); } $this->showError('call', "function $name is not defined
", true, true); return ''; } /** * Register an "if" statement directive. * * @param string $name * @param callable $callback * @return string */ public function registerIfStatement($name, callable $callback): string { $this->conditions[$name] = $callback; $this->directive($name, function($expression) use ($name) { $tmp = $this->stripParentheses($expression); return $expression !== '' ? $this->phpTag . " if (\$this->check('$name', $tmp)): ?>" : $this->phpTag . " if (\$this->check('$name')): ?>"; }); $this->directive('else' . $name, function($expression) use ($name) { $tmp = $this->stripParentheses($expression); return $expression !== '' ? $this->phpTag . " elseif (\$this->check('$name', $tmp)): ?>" : $this->phpTag . " elseif (\$this->check('$name')): ?>"; }); $this->directive('end' . $name, function() { return $this->phpTag . ' endif; ?>'; }); return ''; } /** * Check the result of a condition. * * @param string $name * @param array $parameters * @return bool */ public function check($name, ...$parameters): bool { return \call_user_func($this->conditions[$name], ...$parameters); } /** * @param bool $bool * @param string $view name of the view * @param array $value arrays of values * @return string * @throws Exception */ public function includeWhen($bool = false, $view = '', $value = []): string { if ($bool) { return $this->runChild($view, $value); } return ''; } /** * Macro of function run. Runchild backups the operations, so it is ideal to run as a child process without * intervining with other processes. * * @param $view * @param array $variables * @return string * @throws Exception */ public function runChild($view, $variables = []): string { if (\is_array($variables)) { if ($this->includeScope) { $backup = $this->variables; } else { $backup = null; } $newVariables = \array_merge($this->variables, $variables); $backupControlStack = $this->controlStack; $backupSectionStack = $this->sectionStack; $backupLookStack = $this->loopsStack; } else { $this->showError('run/include', "RunChild: Include/run variables should be defined as array ['idx'=>'value']", true); return ''; } $r = $this->runInternal($view, $newVariables, false, $this->isRunFast); if ($backup !== null) { $this->variables = $backup; } $this->controlStack = $backupControlStack; $this->sectionStack = $backupSectionStack; $this->loopsStack = $backupLookStack; return $r; } /** * run the blade engine. It returns the result of the code. * * @param string $view * @param array $variables * @param bool $forced if true then it recompiles no matter if the compiled file exists or not. * @param bool $runFast if true then the code is not compiled neither checked, and it runs directly the compiled * version. * @return string * @throws Exception * @noinspection PhpUnusedParameterInspection */ protected function runInternal(string $view, $variables = [], $forced = false, $runFast = false): string { $this->currentView = $view; if (@\count($this->composerStack)) { $this->evalComposer($view); } if (@\count($this->variablesGlobal) > 0) { $this->variables = \array_merge($variables, $this->variablesGlobal); //$this->variablesGlobal = []; // used so we delete it. } else { $this->variables = $variables; } if (!$runFast) { // a) if the "compile" is forced then we compile the original file, then save the file. // b) if the "compile" is not forced then we read the datetime of both file, and we compared. // c) in both cases, if the compiled doesn't exist then we compile. if ($view) { $this->fileName = $view; } $result = $this->compile($view, $forced); if (!$this->isCompiled) { return $this->postRun($this->evaluateText($result, $this->variables)); } } elseif ($view) { $this->fileName = $view; } $this->isRunFast = $runFast; return $this->postRun($this->evaluatePath($this->getCompiledFile(), $this->variables)); } protected function evalComposer($view): void { foreach ($this->composerStack as $viewKey => $fn) { if ($this->wildCardComparison($view, $viewKey)) { if (is_callable($fn)) { $fn($this); } elseif ($this->methodExistsStatic($fn, 'composer')) { // if the method exists statically then $fn is the class and 'composer' is the name of the method $fn::composer($this); } elseif (is_object($fn) || class_exists($fn)) { // if $fn is an object, or it is a class and the class exists. $instance = (is_object($fn)) ? $fn : new $fn(); if (method_exists($instance, 'composer')) { // and the method exists inside the instance. $instance->composer($this); } else { if ($this->mode === self::MODE_DEBUG) { $this->showError('evalComposer', "BladeOne: composer() added an incorrect method [$fn]", true, true); return; } $this->showError('evalComposer', 'BladeOne: composer() added an incorrect method', true, true); return; } } else { $this->showError('evalComposer', 'BladeOne: composer() added an incorrect method', true, true); } } } } /** * It compares with wildcards (*) and returns true if both strings are equals
* The wildcards only works at the beginning and/or at the end of the string.
* **Example:**
* ``` * Text::wildCardComparison('abcdef','abc*'); // true * Text::wildCardComparison('abcdef','*def'); // true * Text::wildCardComparison('abcdef','*abc*'); // true * Text::wildCardComparison('abcdef','*cde*'); // true * Text::wildCardComparison('abcdef','*cde'); // false * * ``` * * @param string $text * @param string|null $textWithWildcard * * @return bool */ protected function wildCardComparison($text, $textWithWildcard): bool { if (($textWithWildcard === null || $textWithWildcard === '') || strpos($textWithWildcard, '*') === false ) { // if the text with wildcard is null or empty, or it contains two ** or it contains no * then.. return $text == $textWithWildcard; } if ($textWithWildcard === '*' || $textWithWildcard === '**') { return true; } $c0 = $textWithWildcard[0]; $c1 = substr($textWithWildcard, -1); $textWithWildcardClean = str_replace('*', '', $textWithWildcard); $p0 = strpos($text, $textWithWildcardClean); if ($p0 === false) { // no matches. return false; } if ($c0 === '*' && $c1 === '*') { // $textWithWildcard='*asasasas*' return true; } if ($c1 === '*') { // $textWithWildcard='asasasas*' return $p0 === 0; } // $textWithWildcard='*asasasas' $len = strlen($textWithWildcardClean); return (substr($text, -$len) === $textWithWildcardClean); } protected function methodExistsStatic($class, $method): bool { try { return (new \ReflectionMethod($class, $method))->isStatic(); } catch (\ReflectionException $e) { return false; } } /** * Compile the view at the given path. * * @param string $templateName The name of the template. Example folder.template * @param bool $forced If the compilation will be forced (always compile) or not. * @return boolean|string True if the operation was correct, or false (if not exception) * if it fails. It returns a string (the content compiled) if isCompiled=false * @throws Exception */ public function compile($templateName = null, $forced = false) { $compiled = $this->getCompiledFile($templateName); $template = $this->getTemplateFile($templateName); if (!$this->isCompiled) { $contents = $this->compileString($this->getFile($template)); $this->compileCallBacks($contents, $templateName); return $contents; } if ($forced || $this->isExpired($templateName)) { // compile the original file $contents = $this->compileString($this->getFile($template)); $this->compileCallBacks($contents, $templateName); if ($this->optimize) { // removes space and tabs and replaces by a single space $contents = \preg_replace('/^ {2,}/m', ' ', $contents); $contents = \preg_replace('/^\t{2,}/m', ' ', $contents); } $ok = @\file_put_contents($compiled, $contents); if ($ok === false) { $this->showError( 'Compiling', "Unable to save the file [$compiled]. Check the compile folder is defined and has the right permission" ); return false; } } return true; } /** * Get the full path of the compiled file. * * @param string $templateName * @return string */ public function getCompiledFile($templateName = ''): string { $templateName = (empty($templateName)) ? $this->fileName : $templateName; $fullPath = $this->getTemplateFile($templateName); if ($fullPath == '') { throw new \RuntimeException('Template not found: ' . ($this->mode == self::MODE_DEBUG ? $this->templatePath[0] . '/' . $templateName : $templateName)); } $style = $this->compileTypeFileName; if ($style === 'auto') { $style = 'sha1'; } $hash = $style === 'md5' ? \md5($fullPath) : \sha1($fullPath); return $this->compiledPath . '/' . basename($templateName) . '_' . $hash . $this->compileExtension; } /** * Get the mode of the engine.See BladeOne::MODE_* constants * * @return int=[self::MODE_AUTO,self::MODE_DEBUG,self::MODE_FAST,self::MODE_SLOW][$i] * @noinspection PhpUndefinedConstantInspection */ public function getMode(): int { if (\defined('BLADEONE_MODE')) { $this->mode = BLADEONE_MODE; } return $this->mode; } /** * Set the compile mode
* * @param $mode int=[self::MODE_AUTO,self::MODE_DEBUG,self::MODE_FAST,self::MODE_SLOW][$i] * @return void */ public function setMode($mode): void { $this->mode = $mode; } /** * It sets the comment mode
* @param int $commentMode =[0,1,2][$i]
* **0** comments are generated as php code.
* **1** comments are generated as html code
* **2** comments are ignored (no code is generated)
* @return void */ public function setCommentMode(int $commentMode): void { $this->commentMode = $commentMode; } /** * Get the full path of the template file. *

Example: getTemplateFile('.abc.def')

';
            \var_dump($object);
            echo '

*
• It returns the $this->canonicalUrl value if is not null
*
• Otherwise, it returns the $this->currentUrl if not null
*
• Otherwise, the url is calculated with the information sends by the user
*

*
• It returns the $this->currentUrl if not null
*
• Otherwise, the url is calculated with the information sends by the user
*

'; var_dump$expression; echo '