smarty/docs/en/appendixes/troubleshooting.xml

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision$ -->
 <chapter id="troubleshooting">
  <title>Troubleshooting</title>
  <para></para>
  <sect1 id="smarty.php.errors">
   <title>Smarty/PHP errors</title>
   <para>
    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:
   </para>
   <example>
    <title>Smarty errors</title>
    <screen>
<![CDATA[
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
]]>
    </screen>
   </example>
   <para>
    Smarty shows you the template name, the line number and the error.
    After that, the error consists of the actual line number in the Smarty
    class that the error occured.
   </para>
      
   <para>
    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.
   </para>

   <example>
    <title>PHP parsing errors</title>
    <screen>
<![CDATA[
Parse error: parse error in /path/to/smarty/templates_c/index.tpl.php on line 75
]]>
    </screen>
   </example>
      
   <para>
    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
    <link linkend="language.function.if">{if}{/if}</link> or
    <link linkend="language.function.if">{section}{/section}</link>,
    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.
   </para>
   <para>
   See also
   <link linkend="chapter.debugging.console">debugging</link>,
   <link linkend="variable.error.reporting">$error_reporting</link>
   and
   <link linkend="api.trigger.error">trigger_error()</link>.
   </para>
  </sect1>
</chapter>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->