documentation/manual/en/module_specs/Zend_Exception.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <sect1 id="zend.exception.using">
   4     <title>Using Exceptions</title>
   5
   6     <para>
   7         <classname>Zend_Exception</classname> is simply the base class for all exceptions thrown
   8         within Zend Framework.
   9     </para>
  10
  11     <example id="zend.exception.using.example">
  12         <title>Catching an Exception</title>
  13
  14         <para>
  15             The following code listing demonstrates how to catch an exception thrown in a Zend
  16             Framework class:
  17         </para>
  18
  19         <programlisting language="php"><![CDATA[
  20 try {
  21     // Calling Zend_Loader::loadClass() with a non-existant class will cause
  22     // an exception to be thrown in Zend_Loader:
  23     Zend_Loader::loadClass('nonexistantclass');
  24 } catch (Zend_Exception $e) {
  25     echo "Caught exception: " . get_class($e) . "\n";
  26     echo "Message: " . $e->getMessage() . "\n";
  27     // Other code to recover from the error
  28 }
  29 ]]></programlisting>
  30     </example>
  31
  32     <para>
  33         <classname>Zend_Exception</classname> can be used as a catch-all exception class in a
  34         catch block to trap all exceptions thrown by Zend Framework classes. This can
  35         be useful when the program can not recover by catching a specific exception type.
  36     </para>
  37
  38     <para>
  39         The documentation for each Zend Framework
  40         component and class will contain specific information on which methods
  41         throw exceptions, the circumstances that cause an exception to be thrown,
  42         and the various exception types that may be thrown.
  43     </para>
  44 </sect1>
  45 <!--
  46 vim:se ts=4 sw=4 et:
  47 -->