minor docs improvement

Fixes #937

CHANGELOG.md

@@ -6,10 +6,6 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
-## [5.0.1] - 2024-03-27
-- Fix error in Smarty\Smarty::compileAllTemplates() by including missing FilesystemIterator class [#966](https://github.com/smarty-php/smarty/issues/966)  
-
-
 ## [5.0.0] - 2024-03-25
 - Fixed that scoped variables would overwrite parent scope [#952](https://github.com/smarty-php/smarty/issues/952)
 - Removed publicly accessible `$tpl->_var_stack` variable

changelog/972.md

@@ -1 +0,0 @@
-- Fix Smarty::assign() not returning $this when called with an array as first parameter [#972](https://github.com/smarty-php/smarty/pull/972)

docs/designers/language-modifiers/language-modifier-is_array.md

@@ -1,9 +0,0 @@
-# is_array
-
-Return true if the variable passed to it is an array.
-
-## Basic usage
-
-```smarty
-{if $myVar|is_array}it's an array{/if}
-```

mkdocs.yml

@@ -60,7 +60,6 @@ nav:
         - 'escape': 'designers/language-modifiers/language-modifier-escape.md'
         - 'from_charset': 'designers/language-modifiers/language-modifier-from-charset.md'
         - 'indent': 'designers/language-modifiers/language-modifier-indent.md'
-        - 'is_array': 'designers/language-modifiers/language-modifier-is_array.md'
         - 'isset': 'designers/language-modifiers/language-modifier-isset.md'
         - 'join': 'designers/language-modifiers/language-modifier-join.md'
         - 'json_encode': 'designers/language-modifiers/language-modifier-json-encode.md'

src/BlockHandler/TextFormat.php

@@ -20,6 +20,9 @@ use Smarty\Template;
  * - indent_char   - string (" ")
  * - wrap_boundary - boolean (true)
  *
+ * @link   https://www.smarty.net/manual/en/language.function.textformat.php {textformat}
+ *         (Smarty online manual)
+ *
  * @param array                    $params   parameters
  * @param string                   $content  contents of the block
  * @param Template $template template object

src/Compile/Modifier/CatModifierCompiler.php

@@ -11,6 +11,8 @@ namespace Smarty\Compile\Modifier;
  * Input:    string to catenate
  * Example:  {$var|cat:"foo"}
  *
+ * @link   https://www.smarty.net/manual/en/language.modifier.cat.php cat
+ *           (Smarty online manual)
  * @author Uwe Tews
  */
 

src/Compile/Modifier/CountCharactersModifierCompiler.php

@@ -6,6 +6,8 @@ namespace Smarty\Compile\Modifier;
  * Name:     count_characters
  * Purpose:  count the number of characters in a text
  *
+ * @link   https://www.smarty.net/manual/en/language.modifier.count.characters.php count_characters (Smarty online
+ *         manual)
  * @author Uwe Tews
  */
 

src/Compile/Modifier/CountParagraphsModifierCompiler.php

@@ -6,6 +6,8 @@ namespace Smarty\Compile\Modifier;
  * Name:     count_paragraphs
  * Purpose:  count the number of paragraphs in a text
  *
+ * @link   https://www.smarty.net/manual/en/language.modifier.count.paragraphs.php
+ *          count_paragraphs (Smarty online manual)
  * @author Uwe Tews
  */
 

src/Compile/Modifier/CountSentencesModifierCompiler.php

@@ -6,6 +6,8 @@ namespace Smarty\Compile\Modifier;
  * Name:     count_sentences
  * Purpose:  count the number of sentences in a text
  *
+ * @link   https://www.smarty.net/manual/en/language.modifier.count.paragraphs.php
+ *          count_sentences (Smarty online manual)
  * @author Uwe Tews
  */
 

src/Compile/Modifier/CountWordsModifierCompiler.php

@@ -6,6 +6,7 @@ namespace Smarty\Compile\Modifier;
  * Name:     count_words
  * Purpose:  count the number of words in a text
  *
+ * @link   https://www.smarty.net/manual/en/language.modifier.count.words.php count_words (Smarty online manual)
  * @author Uwe Tews
  */
 

src/Compile/Modifier/DefaultModifierCompiler.php

@@ -6,6 +6,7 @@ namespace Smarty\Compile\Modifier;
  * Name:     default
  * Purpose:  designate default value for empty variables
  *
+ * @link   https://www.smarty.net/manual/en/language.modifier.default.php default (Smarty online manual)
  * @author Uwe Tews
  */
 

src/Compile/Modifier/EscapeModifierCompiler.php

@@ -9,6 +9,7 @@ use Smarty\Exception;
  * Name:     escape
  * Purpose:  escape string for output
  *
+ * @link   https://www.smarty.net/docsv2/en/language.modifier.escape count_characters (Smarty online manual)
  * @author Rodney Rehm
  */
 

src/Compile/Modifier/IndentModifierCompiler.php

@@ -6,6 +6,7 @@ namespace Smarty\Compile\Modifier;
  * Name:     indent
  * Purpose:  indent lines of text
  *
+ * @link   https://www.smarty.net/manual/en/language.modifier.indent.php indent (Smarty online manual)
  * @author Uwe Tews
  */
 

src/Compile/Modifier/LowerModifierCompiler.php

@@ -6,6 +6,7 @@ namespace Smarty\Compile\Modifier;
  * Name:     lower
  * Purpose:  convert string to lowercase
  *
+ * @link   https://www.smarty.net/manual/en/language.modifier.lower.php lower (Smarty online manual)
  * @author Monte Ohrt <monte at ohrt dot com>
  * @author Uwe Tews
  */

src/Compile/Modifier/Nl2brModifierCompiler.php

@@ -7,6 +7,7 @@ namespace Smarty\Compile\Modifier;
  * Name:     nl2br
  * Purpose:  insert HTML line breaks before all newlines in a string
  *
+ * @link   https://www.smarty.net/docs/en/language.modifier.nl2br.tpl nl2br (Smarty online manual)
  */
 
 class Nl2brModifierCompiler extends Base {

src/Compile/Modifier/RoundModifierCompiler.php

@@ -7,6 +7,7 @@ namespace Smarty\Compile\Modifier;
  * Name:     round
  * Purpose:  Returns the rounded value of num to specified precision (number of digits after the decimal point)
  *
+ * @link   https://www.smarty.net/docs/en/language.modifier.round.tpl round (Smarty online manual)
  */
 
 class RoundModifierCompiler extends Base {

src/Compile/Modifier/StrRepeatModifierCompiler.php

@@ -6,6 +6,7 @@ namespace Smarty\Compile\Modifier;
  * Name:     str_repeat
  * Purpose:  returns string repeated times times
  *
+ * @link   https://www.smarty.net/docs/en/language.modifier.str_repeat.tpl str_repeat (Smarty online manual)
  */
 
 class StrRepeatModifierCompiler extends Base {

src/Compile/Modifier/StringFormatModifierCompiler.php

@@ -6,6 +6,7 @@ namespace Smarty\Compile\Modifier;
  * Name:     string_format
  * Purpose:  format strings via sprintf
  *
+ * @link   https://www.smarty.net/manual/en/language.modifier.string.format.php string_format (Smarty online manual)
  * @author Uwe Tews
  */
 

src/Compile/Modifier/StripModifierCompiler.php

@@ -9,6 +9,7 @@ namespace Smarty\Compile\Modifier;
  * Example:  {$var|strip} {$var|strip:" "}
  * Date:     September 25th, 2002
  *
+ * @link   https://www.smarty.net/manual/en/language.modifier.strip.php strip (Smarty online manual)
  * @author Uwe Tews
  */
 

src/Compile/Modifier/StripTagsModifierCompiler.php

@@ -6,6 +6,7 @@ namespace Smarty\Compile\Modifier;
  * Name:     strip_tags
  * Purpose:  strip html tags from text
  *
+ * @link   https://www.smarty.net/docs/en/language.modifier.strip.tags.tpl strip_tags (Smarty online manual)
  * @author Uwe Tews
  */
 

src/Compile/Modifier/StrlenModifierCompiler.php

@@ -7,6 +7,7 @@ namespace Smarty\Compile\Modifier;
  * Name:     strlen
  * Purpose:  return the length of the given string
  *
+ * @link   https://www.smarty.net/docs/en/language.modifier.strlen.tpl strlen (Smarty online manual)
  */
 
 class StrlenModifierCompiler extends Base {

src/Compile/Modifier/UpperModifierCompiler.php

@@ -6,6 +6,7 @@ namespace Smarty\Compile\Modifier;
  * Name:     lower
  * Purpose:  convert string to uppercase
  *
+ * @link   https://www.smarty.net/manual/en/language.modifier.upper.php lower (Smarty online manual)
  * @author Uwe Tews
  */
 

src/Compile/Modifier/WordWrapModifierCompiler.php

@@ -6,6 +6,7 @@ namespace Smarty\Compile\Modifier;
  * Name:     wordwrap
  * Purpose:  wrap a string of text at a given length
  *
+ * @link   https://www.smarty.net/manual/en/language.modifier.wordwrap.php wordwrap (Smarty online manual)
  * @author Uwe Tews
  */
 

src/Data.php

@@ -109,7 +109,7 @@ class Data
             foreach ($tpl_var as $_key => $_val) {
                 $this->assign($_key, $_val, $nocache, $scope);
             }
-			return $this;
+			return;
         }
 		switch ($scope ?? $this->getDefaultScope()) {
 			case self::SCOPE_GLOBAL:
@@ -163,6 +163,8 @@ class Data
      *                              be not cached
      *
      * @return Data
+     * @link https://www.smarty.net/docs/en/api.append.tpl
+     *
      * @api  Smarty::append()
      */
 	public function append($tpl_var, $value = null, $merge = false, $nocache = false)
@@ -216,6 +218,7 @@ class Data
      *
      * @return mixed variable value or or array of variables
      * @api  Smarty::getTemplateVars()
+     * @link https://www.smarty.net/docs/en/api.get.template.vars.tpl
      *
      */
     public function getTemplateVars($varName = null, $searchParents = true)
@@ -348,6 +351,7 @@ class Data
 	 * @param string|array $tpl_var the template variable(s) to clear
 	 *
 	 * @return Data
+	 * @link https://www.smarty.net/docs/en/api.clear.assign.tpl
 	 *
 	 * @api  Smarty::clearAssign()
 	 */
@@ -367,6 +371,7 @@ class Data
 	 * clear all the assigned template variables.
 	 *
 	 * @return Data
+	 * @link https://www.smarty.net/docs/en/api.clear.all.assign.tpl
 	 *
 	 * @api  Smarty::clearAllAssign()
 	 */
@@ -382,6 +387,7 @@ class Data
 	 * @param string|null $name variable name or null
 	 *
 	 * @return Data
+	 * @link https://www.smarty.net/docs/en/api.clear.config.tpl
 	 *
 	 * @api  Smarty::clearConfig()
 	 */
@@ -434,6 +440,7 @@ class Data
 	 *
 	 * @return mixed variable value or or array of variables
 	 * @throws Exception
+	 * @link https://www.smarty.net/docs/en/api.get.config.vars.tpl
 	 *
 	 * @api  Smarty::getConfigVars()
 	 */
@@ -455,6 +462,7 @@ class Data
 
 	 * @returns $this
 	 * @throws \Exception
+	 * @link https://www.smarty.net/docs/en/api.config.load.tpl
 	 *
 	 * @api  Smarty::configLoad()
 	 */

src/Extension/DefaultExtension.php

@@ -113,6 +113,7 @@ class DefaultExtension extends Base {
 	 * Name:     spacify
 	 * Purpose:  add spaces between characters in a string
 	 *
+	 * @link   https://www.smarty.net/manual/en/language.modifier.spacify.php spacify (Smarty online manual)
 	 * @author Monte Ohrt <monte at ohrt dot com>
 	 *
 	 * @param string $string       input string
@@ -233,6 +234,7 @@ class DefaultExtension extends Base {
 	 *          - format: strftime format for output
 	 *          - default_date: default date if $string is empty
 	 *
+	 * @link   https://www.smarty.net/manual/en/language.modifier.date.format.php date_format (Smarty online manual)
 	 * @author Monte Ohrt <monte at ohrt dot com>
 	 *
 	 * @param string $string       input date string
@@ -384,6 +386,7 @@ class DefaultExtension extends Base {
 	 * Name:     escape
 	 * Purpose:  escape string for output
 	 *
+	 * @link   https://www.smarty.net/docs/en/language.modifier.escape
 	 * @author Monte Ohrt <monte at ohrt dot com>
 	 *
 	 * @param string  $string        input string
@@ -651,6 +654,8 @@ class DefaultExtension extends Base {
 	 * Name:     regex_replace
 	 * Purpose:  regular expression search/replace
 	 *
+	 * @link   https://www.smarty.net/manual/en/language.modifier.regex.replace.php
+	 *          regex_replace (Smarty online manual)
 	 * @author Monte Ohrt <monte at ohrt dot com>
 	 *
 	 * @param string       $string  input string
@@ -698,6 +703,7 @@ class DefaultExtension extends Base {
 	 * Name:     replace
 	 * Purpose:  simple search/replace
 	 *
+	 * @link   https://www.smarty.net/manual/en/language.modifier.replace.php replace (Smarty online manual)
 	 * @author Monte Ohrt <monte at ohrt dot com>
 	 * @author Uwe Tews
 	 *
@@ -720,6 +726,7 @@ class DefaultExtension extends Base {
 	 *               optionally splitting in the middle of a word, and
 	 *               appending the $etc string or inserting $etc into the middle.
 	 *
+	 * @link   https://www.smarty.net/manual/en/language.modifier.truncate.php truncate (Smarty online manual)
 	 * @author Monte Ohrt <monte at ohrt dot com>
 	 *
 	 * @param string  $string      input string

src/FunctionHandler/Counter.php

@@ -13,6 +13,8 @@ use Smarty\Template;
  * @param Template $template template object
  *
  * @return string|null
+ *@link   https://www.smarty.net/manual/en/language.function.counter.php {counter}
+ *         (Smarty online manual)
  *
  * @author Monte Ohrt <monte at ohrt dot com>
  */

src/FunctionHandler/Cycle.php

@@ -26,6 +26,8 @@ use Smarty\Template;
  * {cycle name=row values="one,two,three" reset=true}
  * {cycle name=row}
  *
+ * @link    https://www.smarty.net/manual/en/language.function.cycle.php {cycle}
+ *           (Smarty online manual)
  * @author  Monte Ohrt <monte at ohrt dot com>
  * @author  credit to Mark Priatel <mpriatel@rogers.com>
  * @author  credit to Gerard <gerard@interfold.com>

src/FunctionHandler/Fetch.php

@@ -10,6 +10,8 @@ use Smarty\Template;
  * Name:     fetch
  * Purpose:  fetch file, web or ftp data and display results
  *
+ * @link   https://www.smarty.net/manual/en/language.function.fetch.php {fetch}
+ *         (Smarty online manual)
  * @author Monte Ohrt <monte at ohrt dot com>
  *
  * @param array                    $params   parameters

src/FunctionHandler/HtmlCheckboxes.php

@@ -27,6 +27,8 @@ use Smarty\Template;
  * - assign     (optional) - assign the output as an array to this variable
  * - escape     (optional) - escape the content (not value), defaults to true
  *
+ * @link    https://www.smarty.net/manual/en/language.function.html.checkboxes.php {html_checkboxes}
+ *             (Smarty online manual)
  * @author  Christopher Kvarme <christopher.kvarme@flashjab.com>
  * @author  credits to Monte Ohrt <monte at ohrt dot com>
  * @version 1.0

src/FunctionHandler/HtmlImage.php

@@ -20,6 +20,8 @@ use Smarty\Template;
  * - basedir     - (optional) - base directory for absolute paths, default is environment variable DOCUMENT_ROOT
  * - path_prefix - prefix for path output (optional, default empty)
  *
+ * @link    https://www.smarty.net/manual/en/language.function.html.image.php {html_image}
+ *          (Smarty online manual)
  * @author  Monte Ohrt <monte at ohrt dot com>
  * @author  credits to Duda <duda@big.hu>
  * @version 1.0

src/FunctionHandler/HtmlOptions.php

@@ -19,6 +19,8 @@ use Smarty\Template;
  * - id         (optional) - string default not set
  * - class      (optional) - string default not set
  *
+ * @link   https://www.smarty.net/manual/en/language.function.html.options.php {html_image}
+ *           (Smarty online manual)
  * @author Monte Ohrt <monte at ohrt dot com>
  * @author Ralf Strehle (minor optimization) <ralf dot strehle at yahoo dot de>
  *

src/FunctionHandler/HtmlRadios.php

@@ -27,6 +27,8 @@ use Smarty\Template;
  * {html_radios values=$ids name='box' separator='<br>' output=$names}
  * {html_radios values=$ids checked=$checked separator='<br>' output=$names}
  *
+ * @link    https://www.smarty.net/manual/en/language.function.html.radios.php {html_radios}
+ *          (Smarty online manual)
  * @author  Christopher Kvarme <christopher.kvarme@flashjab.com>
  * @author  credits to Monte Ohrt <monte at ohrt dot com>
  * @version 1.0

src/FunctionHandler/HtmlSelectDate.php

@@ -26,6 +26,8 @@ use Smarty\Template;
  *            - 2.0 complete rewrite for performance,
  *              added attributes month_names, *_id
  *
+ * @link    https://www.smarty.net/manual/en/language.function.html.select.date.php {html_select_date}
+ *           (Smarty online manual)
  * @version 2.0
  * @author  Andrei Zmievski
  * @author  Monte Ohrt <monte at ohrt dot com>

src/FunctionHandler/HtmlSelectTime.php

@@ -9,6 +9,8 @@ use Smarty\Template;
  * Name:     html_select_time
  * Purpose:  Prints the dropdowns for time selection
  *
+ * @link   https://www.smarty.net/manual/en/language.function.html.select.time.php {html_select_time}
+ *           (Smarty online manual)
  * @author Roberto Berto <roberto@berto.net>
  * @author Monte Ohrt <monte AT ohrt DOT com>
  *

src/FunctionHandler/HtmlTable.php

@@ -37,6 +37,8 @@ use Smarty\Template;
  * @return string
  *@author  credit to boots <boots dot smarty at yahoo dot com>
  * @version 1.1
+ * @link    https://www.smarty.net/manual/en/language.function.html.table.php {html_table}
+ *           (Smarty online manual)
  *
  * @author  Monte Ohrt <monte at ohrt dot com>
  * @author  credit to Messju Mohr <messju at lammfellpuschen dot de>

src/FunctionHandler/Mailto.php

@@ -35,6 +35,8 @@ use Smarty\Template;
  * {mailto address="me@domain.com" cc="you@domain.com,they@domain.com"}
  * {mailto address="me@domain.com" extra='class="mailto"'}
  *
+ * @link    https://www.smarty.net/manual/en/language.function.mailto.php {mailto}
+ *           (Smarty online manual)
  * @version 1.2
  * @author  Monte Ohrt <monte at ohrt dot com>
  * @author  credits to Jason Sweat (added cc, bcc and subject functionality)

src/FunctionHandler/Math.php

@@ -10,6 +10,8 @@ use Smarty\Template;
  * Name:     math
  * Purpose:  handle math computations in template
  *
+ * @link   https://www.smarty.net/manual/en/language.function.math.php {math}
+ *           (Smarty online manual)
  * @author Monte Ohrt <monte at ohrt dot com>
  *
  * @param array                    $params   parameters

src/Smarty.php

@@ -2,7 +2,6 @@
 
 namespace Smarty;
 
-use FilesystemIterator;
 use RecursiveDirectoryIterator;
 use RecursiveIteratorIterator;
 use Smarty\Cacheresource\File;
@@ -13,12 +12,11 @@ use Smarty\Extension\CoreExtension;
 use Smarty\Extension\DefaultExtension;
 use Smarty\Extension\ExtensionInterface;
 use Smarty\Filter\Output\TrimWhitespace;
-use Smarty\Runtime\CaptureRuntime;
-use Smarty\Runtime\DefaultPluginHandlerRuntime;
-use Smarty\Runtime\ForeachRuntime;
-use Smarty\Runtime\InheritanceRuntime;
-use Smarty\Runtime\TplFunctionRuntime;
-
+use Smarty\Resource\BasePlugin;
+use Smarty\Smarty\Runtime\CaptureRuntime;
+use Smarty\Smarty\Runtime\ForeachRuntime;
+use Smarty\Smarty\Runtime\InheritanceRuntime;
+use Smarty\Smarty\Runtime\TplFunctionRuntime;
 
 /**
  * Project:     Smarty: the PHP compiling template engine
@@ -40,6 +38,7 @@ use Smarty\Runtime\TplFunctionRuntime;
  * Smarty mailing list. Send a blank e-mail to
  * smarty-discussion-subscribe@googlegroups.com
  *
+ * @link      https://www.smarty.net/
  * @author    Monte Ohrt <monte at ohrt dot com>
  * @author    Uwe Tews   <uwe dot tews at gmail dot com>
  * @author    Rodney Rehm
@@ -54,7 +53,7 @@ class Smarty extends \Smarty\TemplateBase {
 	/**
 	 * smarty version
 	 */
-	const SMARTY_VERSION = '5.0.1';
+	const SMARTY_VERSION = '5.0.0';
 
 	/**
 	 * define caching modes
@@ -730,6 +729,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 *
 	 * @return $this
 	 * @throws \Smarty\Exception
+	 * @link https://www.smarty.net/docs/en/api.register.plugin.tpl
 	 *
 	 * @api  Smarty::registerPlugin()
 	 */
@@ -756,6 +756,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 * @param string $name name of template tag
 	 *
 	 * @return array|null
+	 * @link https://www.smarty.net/docs/en/api.unregister.plugin.tpl
 	 *
 	 * @api  Smarty::unregisterPlugin()
 	 */
@@ -773,6 +774,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 * @param string $name name of template tag
 	 *
 	 * @return $this
+	 * @link https://www.smarty.net/docs/en/api.unregister.plugin.tpl
 	 *
 	 * @api  Smarty::unregisterPlugin()
 	 */
@@ -846,6 +848,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 *
 	 * @return $this
 	 * @throws Exception              if $callback is not callable
+	 * @link https://www.smarty.net/docs/en/api.register.default.plugin.handler.tpl
 	 *
 	 * @api  Smarty::registerDefaultPluginHandler()
 	 *
@@ -1249,6 +1252,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 *
 	 * @return int number of cache files deleted
 	 * @throws \Smarty\Exception
+	 * @link https://www.smarty.net/docs/en/api.clear.cache.tpl
 	 *
 	 * @api  Smarty::clearCache()
 	 */
@@ -1268,6 +1272,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 * @param string $type resource type
 	 *
 	 * @return int number of cache files deleted
+	 * @link https://www.smarty.net/docs/en/api.clear.all.cache.tpl
 	 *
 	 * @api  Smarty::clearAllCache()
 	 */
@@ -1284,6 +1289,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 *
 	 * @return int number of template files deleted
 	 * @throws \Smarty\Exception
+	 * @link https://www.smarty.net/docs/en/api.clear.compiled.template.tpl
 	 *
 	 * @api  Smarty::clearCompiledTemplate()
 	 */
@@ -1749,15 +1755,15 @@ class Smarty extends \Smarty\TemplateBase {
 		// Lazy load runtimes when/if needed
 		switch ($type) {
 			case 'Capture':
-				return $this->runtimes[$type] = new CaptureRuntime();
+				return $this->runtimes[$type] = new \Smarty\Runtime\CaptureRuntime();
 			case 'Foreach':
-				return $this->runtimes[$type] = new ForeachRuntime();
+				return $this->runtimes[$type] = new \Smarty\Runtime\ForeachRuntime();
 			case 'Inheritance':
-				return $this->runtimes[$type] = new InheritanceRuntime();
+				return $this->runtimes[$type] = new \Smarty\Runtime\InheritanceRuntime();
 			case 'TplFunction':
-				return $this->runtimes[$type] = new TplFunctionRuntime();
+				return $this->runtimes[$type] = new \Smarty\Runtime\TplFunctionRuntime();
 			case 'DefaultPluginHandler':
-				return $this->runtimes[$type] = new DefaultPluginHandlerRuntime(
+				return $this->runtimes[$type] = new \Smarty\Runtime\DefaultPluginHandlerRuntime(
 					$this->getDefaultPluginHandlerFunc()
 				);
 		}
@@ -1797,6 +1803,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 * @return bool
 	 * @throws \Smarty\Exception
 	 * @api  Smarty::loadFilter()
+	 * @link https://www.smarty.net/docs/en/api.load.filter.tpl
 	 *
 	 * @deprecated since 5.0
 	 */
@@ -1848,6 +1855,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 * @throws \Smarty\Exception
 	 * @api  Smarty::unloadFilter()
 	 *
+	 * @link https://www.smarty.net/docs/en/api.unload.filter.tpl
 	 *
 	 * @deprecated since 5.0
 	 */
@@ -1891,6 +1899,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 * @param Base $resource_handler
 	 *
 	 * @return Smarty
+	 * @link https://www.smarty.net/docs/en/api.register.cacheresource.tpl
 	 *
 	 * @api  Smarty::registerCacheResource()
 	 *
@@ -1913,6 +1922,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 *
 	 * @return Smarty
 	 * @api  Smarty::unregisterCacheResource()
+	 * @link https://www.smarty.net/docs/en/api.unregister.cacheresource.tpl
 	 *
 	 * @deprecated since 5.0
 	 *
@@ -1946,6 +1956,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 *
 	 * @return TemplateBase
 	 * @throws \Smarty\Exception
+	 * @link https://www.smarty.net/docs/en/api.register.filter.tpl
 	 *
 	 * @api  Smarty::registerFilter()
 	 */
@@ -2007,6 +2018,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 * @throws \Smarty\Exception
 	 * @api  Smarty::unregisterFilter()
 	 *
+	 * @link https://www.smarty.net/docs/en/api.unregister.filter.tpl
 	 *
 	 */
 	public function unregisterFilter($type, $name) {
@@ -2040,7 +2052,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 * @param array|string $modifiers modifier or list of modifiers
 	 *                                                                                   to add
 	 *
-	 * @return Smarty
+	 * @return \Smarty|Template
 	 * @api Smarty::addDefaultModifiers()
 	 *
 	 */
@@ -2119,7 +2131,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 * @throws \Smarty\Exception
 	 */
 	public function display($template = null, $cache_id = null, $compile_id = null) {
-		$this->returnOrCreateTemplate($template, $cache_id, $compile_id)->display();
+		return $this->returnOrCreateTemplate($template, $cache_id, $compile_id)->display();
 	}
 
 	/**
@@ -2189,6 +2201,7 @@ class Smarty extends \Smarty\TemplateBase {
 	 * @return bool cache status
 	 * @throws \Exception
 	 * @throws \Smarty\Exception
+	 * @link https://www.smarty.net/docs/en/api.is.cached.tpl
 	 *
 	 * @api  Smarty::isCached()
 	 */

src/Template.php

@@ -604,6 +604,7 @@ class Template extends TemplateBase {
 	 * @return bool cache status
 	 * @throws \Exception
 	 * @throws \Smarty\Exception
+	 * @link https://www.smarty.net/docs/en/api.is.cached.tpl
 	 *
 	 * @api  Smarty::isCached()
 	 */

src/TemplateBase.php

@@ -75,6 +75,7 @@ abstract class TemplateBase extends Data {
 	 *
 	 * @return \Smarty|\Smarty\Template
 	 * @throws \Smarty\Exception
+	 * @link https://www.smarty.net/docs/en/api.register.object.tpl
 	 *
 	 * @api  Smarty::registerObject()
 	 */
@@ -115,6 +116,7 @@ abstract class TemplateBase extends Data {
 	 *
 	 * @return TemplateBase
 	 * @api  Smarty::unregisterObject()
+	 * @link https://www.smarty.net/docs/en/api.unregister.object.tpl
 	 *
 	 */
 	public function unregisterObject($object_name) {
@@ -177,6 +179,7 @@ abstract class TemplateBase extends Data {
 	 * @return Data data object
 	 * @throws Exception
 	 * @api  Smarty::createData()
+	 * @link https://www.smarty.net/docs/en/api.create.data.tpl
 	 *
 	 */
 	public function createData(Data $parent = null, $name = null) {
@@ -219,6 +222,7 @@ abstract class TemplateBase extends Data {
 	 *
 	 * @return object
 	 * @throws \Smarty\Exception if no such object is found
+	 * @link https://www.smarty.net/docs/en/api.get.registered.object.tpl
 	 *
 	 * @api  Smarty::getRegisteredObject()
 	 */
@@ -315,6 +319,7 @@ abstract class TemplateBase extends Data {
 	 * @return TemplateBase
 	 * @throws \Smarty\Exception
 	 * @api  Smarty::registerClass()
+	 * @link https://www.smarty.net/docs/en/api.register.class.tpl
 	 *
 	 */
 	public function registerClass($class_name, $class_impl) {
@@ -372,9 +377,10 @@ abstract class TemplateBase extends Data {
 	 * Registers a resource to fetch a template
 	 *
 	 * @param string $name name of resource type
-	 * @param \Smarty\Resource\BasePlugin $resource_handler instance of Smarty\Resource\BasePlugin
+	 * @param Smarty\Resource\Base $resource_handler instance of Smarty\Resource\Base
 	 *
-	 * @return \Smarty\Smarty|\Smarty\Template
+	 * @return \Smarty|\Smarty\Template
+	 * @link https://www.smarty.net/docs/en/api.register.resource.tpl
 	 *
 	 * @api  Smarty::registerResource()
 	 */
@@ -391,6 +397,7 @@ abstract class TemplateBase extends Data {
 	 *
 	 * @return TemplateBase
 	 * @api  Smarty::unregisterResource()
+	 * @link https://www.smarty.net/docs/en/api.unregister.resource.tpl
 	 *
 	 */
 	public function unregisterResource($type) {

src/functions.php

@@ -66,7 +66,7 @@ function smarty_make_timestamp($string)
 		|| (interface_exists('DateTimeInterface', false) && $string instanceof DateTimeInterface)
 	) {
 		return (int)$string->format('U'); // PHP 5.2 BC
-	} elseif (strlen($string) === 14 && ctype_digit((string)$string)) {
+	} elseif (strlen($string) === 14 && ctype_digit($string)) {
 		// it is mysql timestamp format of YYYYMMDDHHMMSS?
 		return mktime(
 			substr($string, 8, 2),

tests/UnitTests/SecurityTests/SecurityTest.php

@@ -10,411 +10,411 @@ use Smarty\CompilerException;
 
 /**
  * class for security test
+ *
+ * 
+ * 
+ * 
  */
 class SecurityTest extends PHPUnit_Smarty
 {
-	public function setUp(): void
-	{
-		$this->setUpSmarty(__DIR__);
+    public function setUp(): void
+    {
+        $this->setUpSmarty(__DIR__);
 
-		$this->smarty->setForceCompile(true);
-		$this->smarty->enableSecurity();
-	}
-	public function testInit()
-	{
-		$this->cleanDirs();
-	}
+        $this->smarty->setForceCompile(true);
+        $this->smarty->enableSecurity();
+   }
+   public function testInit()
+    {
+        $this->cleanDirs();
+    }
 
-	/**
-	 * test that security is loaded
-	 */
-	public function testSecurityLoaded()
-	{
-		$this->assertTrue(is_object($this->smarty->security_policy));
-	}
+/**
+* test that security is loaded
+ */
+    public function testSecurityLoaded()
+    {
+        $this->assertTrue(is_object($this->smarty->security_policy));
+    }
 
-	/**
-	 * test trusted PHP function
-	 */
-	public function testTrustedFunction()
-	{
-		$this->assertEquals("5", $this->smarty->fetch('string:{assign var=foo value=[1,2,3,4,5]}{count($foo)}'));
-	}
+/**
+ * test trusted PHP function
+ */
+    public function testTrustedFunction()
+    {
+        $this->assertEquals("5", $this->smarty->fetch('string:{assign var=foo value=[1,2,3,4,5]}{count($foo)}'));
+    }
 
-	/**
-	 * test trusted modifier
-	 * @deprecated
-	 */
-	public function testTrustedModifier()
-	{
-		$this->assertEquals("5", @$this->smarty->fetch('string:{assign var=foo value=[1,2,3,4,5]}{$foo|@count}'));
-	}
+/**
+ * test trusted modifier
+ * @deprecated
+ */
+    public function testTrustedModifier()
+    {
+        $this->assertEquals("5", @$this->smarty->fetch('string:{assign var=foo value=[1,2,3,4,5]}{$foo|@count}'));
+    }
 
-	/**
-	 * test not trusted modifier
-	 *
-	 *
-	 *  @deprecated
-	 */
-	public function testNotTrustedModifier()
-	{
-		$this->smarty->security_policy->disabled_modifiers[] = 'escape';
-		$this->expectException(\Smarty\Exception::class);
-		$this->expectExceptionMessage('modifier \'escape\' disabled by security setting');
-		@$this->smarty->fetch('string:{assign var=foo value=[1,2,3,4,5]}{$foo|escape}');
-	}
+/**
+ * test not trusted modifier
+  * 
+  * 
+ *  @deprecated
+ */
+    public function testNotTrustedModifier()
+    {
+        $this->smarty->security_policy->disabled_modifiers[] = 'escape';
+        $this->expectException(\Smarty\Exception::class);
+        $this->expectExceptionMessage('modifier \'escape\' disabled by security setting');
+        @$this->smarty->fetch('string:{assign var=foo value=[1,2,3,4,5]}{$foo|escape}');
+    }
 
-	/**
-	 * test allowed tags
-	 */
-	public function testAllowedTags1()
-	{
-		$this->smarty->security_policy->allowed_tags = array('counter');
-		$this->assertEquals("1", $this->smarty->fetch('string:{counter start=1}'));
-	}
+/**
+ * test allowed tags
+ */
+    public function testAllowedTags1()
+    {
+        $this->smarty->security_policy->allowed_tags = array('counter');
+        $this->assertEquals("1", $this->smarty->fetch('string:{counter start=1}'));
+    }
 
-	/**
-	 * test not allowed tag
-	 *
-	 *
-	 */
-	public function testNotAllowedTags2()
-	{
-		$this->expectException(\Smarty\Exception::class);
-		$this->expectExceptionMessage('tag \'cycle\' not allowed by security setting');
-		$this->smarty->security_policy->allowed_tags = array('counter');
-		$this->smarty->fetch('string:{counter}{cycle values="1,2"}');
-	}
+/**
+ * test not allowed tag
+  * 
+  * 
+ */
+    public function testNotAllowedTags2()
+    {
+        $this->expectException(\Smarty\Exception::class);
+        $this->expectExceptionMessage('tag \'cycle\' not allowed by security setting');
+        $this->smarty->security_policy->allowed_tags = array('counter');
+        $this->smarty->fetch('string:{counter}{cycle values="1,2"}');
+    }
 
-	/**
-	 * test disabled tag
-	 *
-	 *
-	 */
-	public function testDisabledTags()
-	{
-		$this->expectException(\Smarty\Exception::class);
-		$this->expectExceptionMessage('tag \'cycle\' disabled by security setting');
-		$this->smarty->security_policy->disabled_tags = array('cycle');
-		$this->smarty->fetch('string:{counter}{cycle values="1,2"}');
-	}
+/**
+ * test disabled tag
+  * 
+  * 
+ */
+    public function testDisabledTags()
+    {
+        $this->expectException(\Smarty\Exception::class);
+        $this->expectExceptionMessage('tag \'cycle\' disabled by security setting');
+        $this->smarty->security_policy->disabled_tags = array('cycle');
+        $this->smarty->fetch('string:{counter}{cycle values="1,2"}');
+    }
 
-	/**
-	 * test allowed modifier
-	 */
-	public function testAllowedModifier1()
-	{
-		error_reporting(E_ALL  & E_STRICT);
-		$this->smarty->security_policy->allowed_modifiers = array('capitalize');
-		$this->assertEquals("Hello World", $this->smarty->fetch('string:{"hello world"|capitalize}'));
-		error_reporting(E_ALL | E_STRICT);
-	}
+/**
+ * test allowed modifier
+ */
+    public function testAllowedModifier1()
+    {
+        error_reporting(E_ALL  & E_STRICT);
+        $this->smarty->security_policy->allowed_modifiers = array('capitalize');
+        $this->assertEquals("Hello World", $this->smarty->fetch('string:{"hello world"|capitalize}'));
+        error_reporting(E_ALL | E_STRICT);
+    }
 
-	public function testAllowedModifier2()
-	{
-		$this->smarty->security_policy->allowed_modifiers = array('upper');
-		$this->assertEquals("HELLO WORLD", $this->smarty->fetch('string:{"hello world"|upper}'));
-	}
+    public function testAllowedModifier2()
+    {
+        $this->smarty->security_policy->allowed_modifiers = array('upper');
+        $this->assertEquals("HELLO WORLD", $this->smarty->fetch('string:{"hello world"|upper}'));
+    }
 
-	/**
-	 * test not allowed modifier
-	 *
-	 *
-	 */
-	public function testNotAllowedModifier()
-	{
-		$this->expectException(\Smarty\Exception::class);
-		$this->expectExceptionMessage('modifier \'lower\' not allowed by security setting');
-		$this->smarty->security_policy->allowed_modifiers = array('upper');
-		$this->smarty->fetch('string:{"hello"|upper}{"world"|lower}');
-	}
+/**
+ * test not allowed modifier
+  * 
+  * 
+  */
+    public function testNotAllowedModifier()
+    {
+        $this->expectException(\Smarty\Exception::class);
+        $this->expectExceptionMessage('modifier \'lower\' not allowed by security setting');
+        $this->smarty->security_policy->allowed_modifiers = array('upper');
+        $this->smarty->fetch('string:{"hello"|upper}{"world"|lower}');
+    }
 
-	/**
-	 * test disabled modifier
-	 *
-	 *
-	 */
-	public function testDisabledModifier()
-	{
-		$this->expectException(\Smarty\Exception::class);
-		$this->expectExceptionMessage('modifier \'lower\' disabled by security setting');
-		$this->smarty->security_policy->disabled_modifiers = array('lower');
-		$this->smarty->fetch('string:{"hello"|upper}{"world"|lower}');
-	}
+/**
+ * test disabled modifier
+  * 
+  * 
+  */
+    public function testDisabledModifier()
+    {
+        $this->expectException(\Smarty\Exception::class);
+        $this->expectExceptionMessage('modifier \'lower\' disabled by security setting');
+        $this->smarty->security_policy->disabled_modifiers = array('lower');
+        $this->smarty->fetch('string:{"hello"|upper}{"world"|lower}');
+    }
 
 
-	/**
-	 * test Smarty no longer handles embedded PHP
-	 */
-	public function testSmartyPhpAllow()
-	{
-		$this->assertEquals('<?php echo "hello world"; ?>', $this->smarty->fetch('string:<?php echo "hello world"; ?>'));
-	}
+/**
+ * test Smarty no longer handles embedded PHP
+ */
+    public function testSmartyPhpAllow()
+    {
+        $this->assertEquals('<?php echo "hello world"; ?>', $this->smarty->fetch('string:<?php echo "hello world"; ?>'));
+    }
 
-	public function testSmartyPhpAllow2()
-	{
-		$this->assertEquals('<? echo "hello world"; ?>', $this->smarty->fetch('string:<? echo "hello world"; ?>'));
-	}
+    public function testSmartyPhpAllow2()
+    {
+        $this->assertEquals('<? echo "hello world"; ?>', $this->smarty->fetch('string:<? echo "hello world"; ?>'));
+    }
 
-	public function testSmartyPhpAllow3()
-	{
-		$this->assertEquals('<% echo "hello world"; %>', $this->smarty->fetch('string:<% echo "hello world"; %>'));
-	}
+    public function testSmartyPhpAllow3()
+    {
+        $this->assertEquals('<% echo "hello world"; %>', $this->smarty->fetch('string:<% echo "hello world"; %>'));
+    }
 
-	/**
-	 * test standard directory
-	 */
-	public function testStandardDirectory()
-	{
-		$content = $this->smarty->fetch('string:{include file="helloworld.tpl"}');
-		$this->assertEquals("hello world", $content);
-	}
+/**
+ * test standard directory
+ */
+    public function testStandardDirectory()
+    {
+        $content = $this->smarty->fetch('string:{include file="helloworld.tpl"}');
+        $this->assertEquals("hello world", $content);
+    }
 
-	/**
-	 * test trusted directory
-	 */
-	public function testTrustedDirectory()
-	{
-		$this->smarty->security_policy->secure_dir = array('.' . DIRECTORY_SEPARATOR . 'templates_2' . DIRECTORY_SEPARATOR);
-		$this->assertEquals("hello world", $this->smarty->fetch('string:{include file="templates_2/hello.tpl"}'));
-	}
+/**
+ * test trusted directory
+ */
+    public function testTrustedDirectory()
+    {
+        $this->smarty->security_policy->secure_dir = array('.' . DIRECTORY_SEPARATOR . 'templates_2' . DIRECTORY_SEPARATOR);
+        $this->assertEquals("hello world", $this->smarty->fetch('string:{include file="templates_2/hello.tpl"}'));
+    }
 
-	/**
-	 * test not trusted directory
-	 *
-	 *
-	 *
-	 */
-	public function testNotTrustedDirectory()
-	{
-		$this->expectException(\Smarty\Exception::class);
-		$this->expectExceptionMessage('not trusted file path');
-		$this->smarty->security_policy->secure_dir = array(str_replace('\\', '/', __DIR__ . '/templates_3/'));
-		$this->smarty->fetch('string:{include file="templates_2/hello.tpl"}');
-	}
+/**
+ * test not trusted directory
+  *
+  * 
+  * 
+  */
+    public function testNotTrustedDirectory()
+    {
+        $this->expectException(\Smarty\Exception::class);
+        $this->expectExceptionMessage('not trusted file path');
+        $this->smarty->security_policy->secure_dir = array(str_replace('\\', '/', __DIR__ . '/templates_3/'));
+        $this->smarty->fetch('string:{include file="templates_2/hello.tpl"}');
+     }
 
-	/**
-	 * test disabled security for not trusted dir
-	 */
-	public function testDisabledTrustedDirectory()
-	{
-		$this->smarty->disableSecurity();
-		$this->assertEquals("hello world", $this->smarty->fetch('string:{include file="templates_2/hello.tpl"}'));
-	}
+/**
+ * test disabled security for not trusted dir
+ */
+    public function testDisabledTrustedDirectory()
+    {
+        $this->smarty->disableSecurity();
+        $this->assertEquals("hello world", $this->smarty->fetch('string:{include file="templates_2/hello.tpl"}'));
+    }
 
-	/**
-	 * test trusted static class
-	 */
-	public function testTrustedStaticClass()
-	{
-		$this->smarty->security_policy->static_classes = array('mysecuritystaticclass');
-		$tpl = $this->smarty->createTemplate('string:{mysecuritystaticclass::square(5)}');
-		$this->assertEquals('25', $this->smarty->fetch($tpl));
-	}
+/**
+ * test trusted static class
+ */
+    public function testTrustedStaticClass()
+    {
+        $this->smarty->security_policy->static_classes = array('mysecuritystaticclass');
+        $tpl = $this->smarty->createTemplate('string:{mysecuritystaticclass::square(5)}');
+        $this->assertEquals('25', $this->smarty->fetch($tpl));
+    }
 
-	/**
-	 * test not trusted PHP function
-	 *
-	 *
-	 */
-	public function testNotTrustedStaticClass()
-	{
-		$this->expectException(\Smarty\Exception::class);
-		$this->expectExceptionMessage('access to static class \'mysecuritystaticclass\' not allowed by security setting');
-		$this->smarty->security_policy->static_classes = array('null');
-		$this->smarty->fetch('string:{mysecuritystaticclass::square(5)}');
-	}
+    /**
+     * test not trusted PHP function
+     *
+     *
+     */
+    public function testNotTrustedStaticClass()
+    {
+        $this->expectException(\Smarty\Exception::class);
+        $this->expectExceptionMessage('access to static class \'mysecuritystaticclass\' not allowed by security setting');
+        $this->smarty->security_policy->static_classes = array('null');
+        $this->smarty->fetch('string:{mysecuritystaticclass::square(5)}');
+    }
 
-	/**
-	 * test not trusted PHP function
-	 */
-	public function testNotTrustedStaticClassEval()
-	{
-		$this->expectException(\Smarty\Exception::class);
-		$this->expectExceptionMessage('dynamic static class not allowed by security setting');
-		$this->smarty->security_policy->static_classes = array('null');
-		$this->smarty->fetch('string:{$test = "mysecuritystaticclass"}{$test::square(5)}');
-	}
+    /**
+     * test not trusted PHP function
+     */
+    public function testNotTrustedStaticClassEval()
+    {
+        $this->expectException(\Smarty\Exception::class);
+        $this->expectExceptionMessage('dynamic static class not allowed by security setting');
+        $this->smarty->security_policy->static_classes = array('null');
+        $this->smarty->fetch('string:{$test = "mysecuritystaticclass"}{$test::square(5)}');
+    }
 
-	/**
-	 * test not trusted PHP function
-	 */
-	public function testNotTrustedStaticClassSmartyVar()
-	{
-		$this->expectException(\Smarty\Exception::class);
-		$this->expectExceptionMessage('dynamic static class not allowed by security setting');
-		$this->smarty->security_policy->static_classes = array('null');
-		$this->smarty->fetch('string:{$smarty.template_object::square(5)}');
-	}
+    /**
+     * test not trusted PHP function
+     */
+    public function testNotTrustedStaticClassSmartyVar()
+    {
+        $this->expectException(\Smarty\Exception::class);
+        $this->expectExceptionMessage('dynamic static class not allowed by security setting');
+        $this->smarty->security_policy->static_classes = array('null');
+        $this->smarty->fetch('string:{$smarty.template_object::square(5)}');
+    }
 
-	public function testChangedTrustedDirectory()
-	{
-		$this->smarty->security_policy->secure_dir = array(
-			'.' . DIRECTORY_SEPARATOR . 'templates_2' . DIRECTORY_SEPARATOR,
-		);
-		$this->assertEquals("hello world", $this->smarty->fetch('string:{include file="templates_2/hello.tpl"}'));
+    public function testChangedTrustedDirectory()
+    {
+        $this->smarty->security_policy->secure_dir = array(
+            '.' . DIRECTORY_SEPARATOR . 'templates_2' . DIRECTORY_SEPARATOR,
+        );
+        $this->assertEquals("hello world", $this->smarty->fetch('string:{include file="templates_2/hello.tpl"}'));
 
-		$this->smarty->security_policy->secure_dir = array(
-			'.' . DIRECTORY_SEPARATOR . 'templates_2' . DIRECTORY_SEPARATOR,
-			'.' . DIRECTORY_SEPARATOR . 'templates_3' . DIRECTORY_SEPARATOR,
-		);
-		$this->assertEquals("templates_3", $this->smarty->fetch('string:{include file="templates_3/dirname.tpl"}'));
-	}
-	/**
-	 * test template file exits
-	 *
-	 *
-	 *
-	 */
-	public function testTemplateTrustedStream()
-	{
-		stream_wrapper_register("global", ResourceStreamSecurity::class)
-		or die("Failed to register protocol");
-		$fp = fopen("global://mytest", "r+");
-		fwrite($fp, 'hello world {$foo}');
-		fclose($fp);
-		$this->smarty->security_policy->streams= array('global');
-		$tpl = $this->smarty->createTemplate('global:mytest');
-		$this->assertTrue($tpl->getSource()->exists);
-		stream_wrapper_unregister("global");
-	}
-	/**
-	 *
-	 *
-	 * test template file exits
-	 */
-	public function testTemplateNotTrustedStream()
-	{
-		$this->expectException(\Smarty\Exception::class);
-		$this->expectExceptionMessage('stream \'global\' not allowed by security setting');
-		stream_wrapper_register("global", ResourceStreamSecurity::class)
-		or die("Failed to register protocol");
-		$fp = fopen("global://mytest", "r+");
-		fwrite($fp, 'hello world {$foo}');
-		fclose($fp);
-		$this->smarty->security_policy->streams= array('notrusted');
-		$tpl = $this->smarty->createTemplate('global:mytest');
-		$this->assertTrue($tpl->getSource()->exists);
-		stream_wrapper_unregister("global");
-	}
+        $this->smarty->security_policy->secure_dir = array(
+            '.' . DIRECTORY_SEPARATOR . 'templates_2' . DIRECTORY_SEPARATOR,
+            '.' . DIRECTORY_SEPARATOR . 'templates_3' . DIRECTORY_SEPARATOR,
+        );
+        $this->assertEquals("templates_3", $this->smarty->fetch('string:{include file="templates_3/dirname.tpl"}'));
+    }
+/**
+ * test template file exits
+ *
+ * 
+ * 
+ */
+    public function testTemplateTrustedStream()
+    {
+        stream_wrapper_register("global", ResourceStreamSecurity::class)
+        or die("Failed to register protocol");
+        $fp = fopen("global://mytest", "r+");
+        fwrite($fp, 'hello world {$foo}');
+        fclose($fp);
+        $this->smarty->security_policy->streams= array('global');
+        $tpl = $this->smarty->createTemplate('global:mytest');
+        $this->assertTrue($tpl->getSource()->exists);
+        stream_wrapper_unregister("global");
+    }
+/**
+ * 
+ * 
+ * test template file exits
+ */
+    public function testTemplateNotTrustedStream()
+    {
+        $this->expectException(\Smarty\Exception::class);
+        $this->expectExceptionMessage('stream \'global\' not allowed by security setting');
+        stream_wrapper_register("global", ResourceStreamSecurity::class)
+        or die("Failed to register protocol");
+        $fp = fopen("global://mytest", "r+");
+        fwrite($fp, 'hello world {$foo}');
+        fclose($fp);
+        $this->smarty->security_policy->streams= array('notrusted');
+        $tpl = $this->smarty->createTemplate('global:mytest');
+        $this->assertTrue($tpl->getSource()->exists);
+        stream_wrapper_unregister("global");
+    }
+/**
+ * 
+ * @group slow
+*/
+    public function testTrustedUri()
+    {
+        $this->smarty->security_policy->trusted_uri = array(
+            '#https://www.smarty.net$#i'
+        );
+        $this->assertStringContainsString('<title>Preface | Smarty</title>', $this->smarty->fetch('string:{fetch file="https://www.smarty.net/docs/en/preface.tpl"}'));
+    }
 
-	public function testTrustedUri()
-	{
-		$this->smarty->security_policy->trusted_uri = array(
-			'#https://s4otw4nhg.erteorteortert.nusuchtld$#i'
-		);
+/**
+ * 
+ * 
+*/
+    public function testNotTrustedUri()
+    {
+        $this->expectException(\Smarty\Exception::class);
+        $this->expectExceptionMessage('URI \'https://www.smarty.net/docs/en/preface.tpl\' not allowed by security setting');
+        $this->smarty->security_policy->trusted_uri = array();
+        $this->assertStringContainsString('<title>Preface | Smarty</title>', $this->smarty->fetch('string:{fetch file="https://www.smarty.net/docs/en/preface.tpl"}'));
+    }
 
-		$this->expectException(\Smarty\Exception::class);
-		$this->expectExceptionMessage('{fetch} cannot read resource \'https://s4otw4nhg.erteorteortert.nusuchtld/docs/en/preface.tpl\'');
-
-		$this->smarty->fetch('string:{fetch file="https://s4otw4nhg.erteorteortert.nusuchtld/docs/en/preface.tpl"}');
-	}
-
-	/**
-	 *
-	 *
-	 */
-	public function testNotTrustedUri()
-	{
-		$this->expectException(\Smarty\Exception::class);
-		$this->expectExceptionMessage('URI \'https://example.net\' not allowed by security setting');
-		$this->smarty->security_policy->trusted_uri = [];
-		$this->assertStringContainsString(
-			'<title>Preface | Smarty</title>',
-			$this->smarty->fetch('string:{fetch file="https://example.net"}')
-		);
-	}
-
-	/**
-	 * In security mode, accessing $smarty.template_object should be illegal.
-	 */
-	public function testSmartyTemplateObject() {
-		$this->expectException(CompilerException::class);
-		$this->smarty->display('string:{$smarty.template_object}');
-	}
+    /**
+     * In security mode, accessing $smarty.template_object should be illegal.
+     */
+    public function testSmartyTemplateObject() {
+        $this->expectException(CompilerException::class);
+        $this->smarty->display('string:{$smarty.template_object}');
+    }
 
 }
 
 class mysecuritystaticclass
 {
-	const STATIC_CONSTANT_VALUE = 3;
-	static $static_var = 5;
+    const STATIC_CONSTANT_VALUE = 3;
+    static $static_var = 5;
 
-	static function square($i)
-	{
-		return $i * $i;
-	}
+    static function square($i)
+    {
+        return $i * $i;
+    }
 }
 
 #[AllowDynamicProperties]
 class ResourceStreamSecurity
 {
-	private $position;
-	private $varname;
+    private $position;
+    private $varname;
 
-	public function stream_open($path, $mode, $options, &$opened_path)
-	{
-		$url = parse_url($path);
-		$this->varname = $url["host"];
-		$this->position = 0;
+    public function stream_open($path, $mode, $options, &$opened_path)
+    {
+        $url = parse_url($path);
+        $this->varname = $url["host"];
+        $this->position = 0;
 
-		return true;
-	}
+        return true;
+    }
 
-	public function stream_read($count)
-	{
-		$p = &$this->position;
-		$ret = substr($GLOBALS[$this->varname], $p, $count);
-		$p += strlen($ret);
+    public function stream_read($count)
+    {
+        $p = &$this->position;
+        $ret = substr($GLOBALS[$this->varname], $p, $count);
+        $p += strlen($ret);
 
-		return $ret;
-	}
+        return $ret;
+    }
 
-	public function stream_write($data)
-	{
-		$v = &$GLOBALS[$this->varname];
-		$l = strlen($data);
-		$p = &$this->position;
-		$v = substr($v ?? '', 0, $p) . $data . substr($v ?? '', $p += $l);
+    public function stream_write($data)
+    {
+        $v = &$GLOBALS[$this->varname];
+        $l = strlen($data);
+        $p = &$this->position;
+        $v = substr($v ?? '', 0, $p) . $data . substr($v ?? '', $p += $l);
 
-		return $l;
-	}
+        return $l;
+    }
 
-	public function stream_tell()
-	{
-		return $this->position;
-	}
+    public function stream_tell()
+    {
+        return $this->position;
+    }
 
-	public function stream_eof()
-	{
-		if (!isset($GLOBALS[$this->varname])) {
-			return true;
-		}
+    public function stream_eof()
+    {
+        if (!isset($GLOBALS[$this->varname])) {
+            return true;
+        }
 
-		return $this->position >= strlen($GLOBALS[$this->varname]);
-	}
+        return $this->position >= strlen($GLOBALS[$this->varname]);
+    }
 
-	public function stream_seek($offset, $whence)
-	{
-		$l = strlen($GLOBALS[$this->varname]);
-		$p = &$this->position;
-		switch ($whence) {
-			case SEEK_SET:
-				$newPos = $offset;
-				break;
-			case SEEK_CUR:
-				$newPos = $p + $offset;
-				break;
-			case SEEK_END:
-				$newPos = $l + $offset;
-				break;
-			default:
-				return false;
-		}
-		$ret = ($newPos >= 0 && $newPos <= $l);
-		if ($ret) {
-			$p = $newPos;
-		}
-		return $ret;
-	}
+    public function stream_seek($offset, $whence)
+    {
+        $l = strlen($GLOBALS[$this->varname]);
+        $p = &$this->position;
+        switch ($whence) {
+            case SEEK_SET:
+                $newPos = $offset;
+                break;
+            case SEEK_CUR:
+                $newPos = $p + $offset;
+                break;
+            case SEEK_END:
+                $newPos = $l + $offset;
+                break;
+            default:
+                return false;
+        }
+        $ret = ($newPos >= 0 && $newPos <= $l);
+        if ($ret) {
+            $p = $newPos;
+        }
+        return $ret;
+    }
 }

tests/UnitTests/SmartyMethodsTests/Assign/AssignTest.php

@@ -42,15 +42,4 @@ class AssignTest extends PHPUnit_Smarty
         $this->smarty->assign(array('foo' => 'bar', 'foo2' => 'bar2'));
         $this->assertEquals('bar bar2', $this->smarty->fetch('eval:{$foo} {$foo2}'));
     }
-
-	/**
-	 * Test that assign returns this.
-	 */
-	public function testAssignReturnsThis()
-	{
-		$this->assertEquals(
-			'data',
-			$this->smarty->assign(['dummy' => 'data'])->fetch('eval:{$dummy}')
-		);
-	}
 }

tests/UnitTests/TemplateSource/TagTests/PluginFunction/PluginFunctionFetchTest.php

@@ -1,71 +1,85 @@
 <?php
+/**
+ * Smarty PHPunit tests of modifier
+ *
+
+ * @author  Rodney Rehm
+ */
 
 /**
- * class testing fetch function
+ * class for modifier tests
+ *
+ * 
+ * 
+ * 
  */
 class PluginFunctionFetchTest extends PHPUnit_Smarty
 {
-	public function setUp(): void
-	{
-		$this->setUpSmarty(__DIR__);
-	}
+    public function setUp(): void
+    {
+        $this->setUpSmarty(__DIR__);
+    }
 
-	public function testInit()
-	{
-		$this->cleanDirs();
-	}
+    public function testInit()
+    {
+        $this->cleanDirs();
+    }
 
-	/**
-	 * test {fetch} from local file
-	 */
-	public function testFetchFile()
-	{
-		$this->assertStringContainsString(
-			'ct4hn8nzgm;cgzm;',
-			$this->smarty->fetch('string:{fetch file="./testfile.txt"}')
-		);
-	}
 
-	/**
-	 * test {fetch} non-existing file
-	 */
-	public function testFetchNonExistingFile()
-	{
-		$this->expectException(\Smarty\Exception::class);
-		$this->expectExceptionMessage('{fetch} cannot read resource \'./no/such/file\'');
-		$this->smarty->fetch('string:{fetch file="./no/such/file"}');
-	}
+/**
+* test {fetch} from UIR
+*
+* 
+* @group slow
+*/
+   public function testFetchUri()
+    {
+        $this->assertStringContainsString('<title>Preface | Smarty</title>', $this->smarty->fetch('string:{fetch file="https://www.smarty.net/docs/en/preface.tpl"}'));
+    }
 
-	/**
-	 * test {fetch file=...} access to file from path not aloo/wed by security settings
-	 *
-	 * @run InSeparateProcess
-	 *
-	 */
-	public function testFetchSecurity()
-	{
-		$this->expectException(\Smarty\Exception::class);
-		$this->expectExceptionMessage('not trusted file path');
-		$this->cleanDirs();
-		$dir=$this->smarty->getTemplateDir();
-		$this->smarty->enableSecurity();
-		$this->smarty->fetch('string:{fetch file=\''. $dir[0]. '../../../../../etc/passwd\'}');
-	}
-	/**
-	 * test {fetch file=...} access to file from path not aloo/wed by security settings
-	 *
-	 * @run InSeparateProcess
-	 *
-	 */
-	public function testFetchSecurity2()
-	{
-		$this->expectException(\Smarty\Exception::class);
-		$this->expectExceptionMessage('not trusted file path');
-		$this->cleanDirs();
-		$this->smarty->getTemplateDir();
-		$this->smarty->enableSecurity();
-		$this->smarty->setTemplateDir('/templates');
-		$this->smarty->fetch('string:{fetch file="/templates/../etc/passwd"}');
-	}
+/**
+* test {fetch} invalid uri
+*
+* 
+* 
+*/
+  public function testFetchInvalidUri()
+  {
+      $this->expectException(\Smarty\Exception::class);
+      $this->expectExceptionMessage('{fetch} cannot read resource \'https://foo.smarty.net/foo.dat\'');
+      $this->smarty->fetch('string:{fetch file="https://foo.smarty.net/foo.dat"}');
+  }
+
+  /**
+  * test {fetch file=...} access to file from path not aloo/wed by security settings
+  *
+  * @run InSeparateProcess
+  * 
+  */
+  public function testFetchSecurity()
+  {
+      $this->expectException(\Smarty\Exception::class);
+      $this->expectExceptionMessage('not trusted file path');
+      $this->cleanDirs();
+      $dir=$this->smarty->getTemplateDir();
+      $this->smarty->enableSecurity();
+      $this->smarty->fetch('string:{fetch file=\''. $dir[0]. '../../../../../etc/passwd\'}');
+  }
+  /**
+  * test {fetch file=...} access to file from path not aloo/wed by security settings
+  *
+  * @run InSeparateProcess
+  * 
+  */
+  public function testFetchSecurity2()
+  {
+      $this->expectException(\Smarty\Exception::class);
+      $this->expectExceptionMessage('not trusted file path');
+      $this->cleanDirs();
+      $this->smarty->getTemplateDir();
+      $this->smarty->enableSecurity();
+      $this->smarty->setTemplateDir('/templates');
+      $this->smarty->fetch('string:{fetch file="/templates/../etc/passwd"}');
+  }
 
 }

tests/UnitTests/TemplateSource/TagTests/PluginFunction/testfile.txt

@@ -1 +0,0 @@
-ct4hn8nzgm;cgzm;