diff options
Diffstat (limited to 'vendor/smarty/smarty/docs/appendixes/troubleshooting.md')
-rw-r--r-- | vendor/smarty/smarty/docs/appendixes/troubleshooting.md | 122 |
1 files changed, 53 insertions, 69 deletions
diff --git a/vendor/smarty/smarty/docs/appendixes/troubleshooting.md b/vendor/smarty/smarty/docs/appendixes/troubleshooting.md index d605dd2bd..8364534af 100644 --- a/vendor/smarty/smarty/docs/appendixes/troubleshooting.md +++ b/vendor/smarty/smarty/docs/appendixes/troubleshooting.md @@ -1,20 +1,18 @@ -Troubleshooting -=============== +# Troubleshooting -Smarty/PHP errors {#smarty.php.errors} -================= +## Smarty/PHP errors Smarty can catch many errors such as missing tag attributes or malformed variable names. If this happens, you will see an error similar to the following: +``` +Warning: Smarty: [in index.tpl line 4]: syntax error: unknown tag - '%blah' + in /path/to/smarty/Smarty.class.php on line 1041 - Warning: Smarty: [in index.tpl line 4]: syntax error: unknown tag - '%blah' - in /path/to/smarty/Smarty.class.php on line 1041 - - Fatal error: Smarty: [in index.tpl line 28]: syntax error: missing section name - in /path/to/smarty/Smarty.class.php on line 1041 - +Fatal error: Smarty: [in index.tpl line 28]: syntax error: missing section name + in /path/to/smarty/Smarty.class.php on line 1041 +``` Smarty shows you the template name, the line number and the error. After @@ -25,96 +23,82 @@ There are certain errors that Smarty cannot catch, such as missing close tags. These types of errors usually end up in PHP compile-time parsing errors. - - Parse error: parse error in /path/to/smarty/templates_c/index.tpl.php on line 75 - - - +`Parse error: parse error in /path/to/smarty/templates_c/index.tpl.php on line 75` + When you encounter a PHP parsing error, the error line number will correspond to the compiled PHP script, NOT the template itself. Usually you can look at the template and spot the syntax error. Here are some common things to look for: missing close tags for -[`{if}{/if}`](#language.function.if) or -[`{section}{/section}`](#language.function.if), or syntax of logic -within an `{if}` tag. If you can\'t find the error, you might have to +[`{if}{/if}`](../designers/language-builtin-functions/language-function-if.md) or +[`{section}{/section}`](../designers/language-builtin-functions/language-function-section.md), +or syntax of logic within an `{if}` tag. If you can\'t find the error, you might have to open the compiled PHP file and go to the line number to figure out where the corresponding error is in the template. +``` +Warning: Smarty error: unable to read resource: "index.tpl" in... +``` +or +``` +Warning: Smarty error: unable to read resource: "site.conf" in... +``` - Warning: Smarty error: unable to read resource: "index.tpl" in... - or - Warning: Smarty error: unable to read resource: "site.conf" in... - -- The [`$template_dir`](#variable.template.dir) is incorrect, doesn\'t +- The [`$template_dir`](../programmers/api-variables/variable-template-dir.md) is incorrect, doesn't exist or the file `index.tpl` is not in the `templates/` directory -- A [`{config_load}`](#language.function.config.load) function is - within a template (or [`configLoad()`](#api.config.load) has been - called) and either [`$config_dir`](#variable.config.dir) is +- A [`{config_load}`](../designers/language-builtin-functions/language-function-config-load.md) function is + within a template (or [`configLoad()`](../programmers/api-functions/api-config-load.md) has been + called) and either [`$config_dir`](../programmers/api-variables/variable-config-dir.md) is incorrect, does not exist or `site.conf` is not in the directory. -<!-- --> +``` +Fatal error: Smarty error: the $compile_dir 'templates_c' does not exist, +or is not a directory... +``` - - Fatal error: Smarty error: the $compile_dir 'templates_c' does not exist, - or is not a directory... - - - -- Either the [`$compile_dir`](#variable.compile.dir)is incorrectly +- Either the [`$compile_dir`](../programmers/api-variables/variable-compile-dir.md)is incorrectly set, the directory does not exist, or `templates_c` is a file and not a directory. -<!-- --> - - - Fatal error: Smarty error: unable to write to $compile_dir '.... - +``` +Fatal error: Smarty error: unable to write to $compile_dir '.... +``` -- The [`$compile_dir`](#variable.compile.dir) is not writable by the +- The [`$compile_dir`](../programmers/api-variables/variable-compile-dir.md) is not writable by the web server. See the bottom of the [installing - smarty](#installing.smarty.basic) page for more about permissions. - -<!-- --> - - - Fatal error: Smarty error: the $cache_dir 'cache' does not exist, - or is not a directory. in /.. + smarty](../getting-started.md#installation) page for more about permissions. +``` +Fatal error: Smarty error: the $cache_dir 'cache' does not exist, +or is not a directory. in /.. +``` - -- This means that [`$caching`](#variable.caching) is enabled and - either; the [`$cache_dir`](#variable.cache.dir) is incorrectly set, +- This means that [`$caching`](../programmers/api-variables/variable-caching.md) is enabled and + either; the [`$cache_dir`](../programmers/api-variables/variable-cache-dir.md) is incorrectly set, the directory does not exist, or `cache/` is a file and not a directory. -<!-- --> - +``` +Fatal error: Smarty error: unable to write to $cache_dir '/... +``` - Fatal error: Smarty error: unable to write to $cache_dir '/... - - - -- This means that [`$caching`](#variable.caching) is enabled and the - [`$cache_dir`](#variable.cache.dir) is not writable by the web +- This means that [`$caching`](../programmers/api-variables/variable-caching.md) is enabled and the + [`$cache_dir`](../programmers/api-variables/variable-cache-dir.md) is not writable by the web server. See the bottom of the [installing - smarty](#installing.smarty.basic) page for permissions. - -<!-- --> - - - Warning: filemtime(): stat failed for /path/to/smarty/cache/3ab50a623e65185c49bf17c63c90cc56070ea85c.one.tpl.php - in /path/to/smarty/libs/sysplugins/smarty_resource.php + smarty](../getting-started.md#installation) page for permissions. - +``` +Warning: filemtime(): stat failed for /path/to/smarty/cache/3ab50a623e65185c49bf17c63c90cc56070ea85c.one.tpl.php +in /path/to/smarty/libs/sysplugins/smarty_resource.php +``` - This means that your application registered a custom error handler - (using [set\_error\_handler()](&url.php-manual;set_error_handler)) + (using [set_error_handler()](https://www.php.net/set_error_handler)) which is not respecting the given `$errno` as it should. If, for whatever reason, this is the desired behaviour of your custom error handler, please call - [`muteExpectedErrors()`](#api.mute.expected.errors) after you\'ve + [`muteExpectedErrors()`](../programmers/api-functions/api-mute-expected-errors.md) after you've registered your custom error handler. -See also [debugging](#chapter.debugging.console). +See also [debugging](../designers/chapter-debugging-console.md). |