Fraenkiman e544ed6d9a Smatry Release 4.4.1 on Feb-2024
Comparing changes: https://github.com/smarty-php/smarty/compare/v4.3.1...v4.4.1

It is noticeable that Smarty 4.3.1 does not officially support PHP 8.3. Is only supported with 4.4.0.

Remark:

During tests with Smarty 4.5.1, it was noticed that the following warning occurs:
Deprecated: Using the unregistered function "function_exists" in a template is deprecated and will be removed in a future version. Use Smarty::registerPlugin to explicitly register a custom modifier.

As of Smarty 5.X.X, templates must be revised again.
The Smarty release 5.0.2 is already officially available. However, integration into FlatPress is not entirely trivial.
2024-04-14 18:37:39 +02:00

1.7 KiB

$use_include_path

This tells smarty to respect the include_path within the File Template Resource handler and the plugin loader to resolve the directories known to $template_dir. The flag also makes the plugin loader check the include_path for $plugins_dir.

Note

You should not design your applications to rely on the include_path, as this may - depending on your implementation - slow down your system (and Smarty) considerably.

If use_include_path is enabled, file discovery for $template_dir and $plugins_dir work as follows.

  • For each element $directory in array ($template_dir or $plugins_dir) do

  • Test if requested file is in $directory relative to the current working directory. If file found, return it.

  • For each $path in include_path do

  • Test if requested file is in $directory relative to the $path (possibly relative to the current working directory). If file found, return it.

  • Try default_handler or fail.

This means that whenever a directory/file relative to the current working directory is encountered, it is preferred over anything potentially accessible through the include_path.

Note

Smarty does not filter elements of the include_path. That means a ".:" within your include path will trigger the current working directory lookup twice.

See also Template Resources and $template_dir