Differences

This shows you the differences between two versions of the page.

--- pear:rfc:pear2_exception_policy [2009/09/22 16:53] – add global namespace character ashnazg
+++ pear:rfc:pear2_exception_policy [2009/09/22 22:05] – fix typo ashnazg
@@ Line 3: / Line 3: @@
 ==== Document Information ====
   * Title: PEAR2 Exception Policy
-  * Version: 1.0.0
+  * Version: 1.0.1
   * Status: Ratified
   * Type: Informative Document
   * Wiki link: http://wiki.php.net/pear/rfc/PEAR2_Exception_Policy
-  * Last updated: November 12th, 2008
+  * Last updated: September 22nd, 2009
   * Passed:  September 20th, 2009
@@ Line 112: / Line 112: @@
 </code>
+===== Full Code Example =====
+This example contrasts the usage of a base Exception interface with a base Exception class.
+Foo package that uses a base Exception interface:
+<code>
+<?php
+namespace foo;
+interface Exception {}
+class InvalidArgumentException extends \InvalidArgumentException implements Exception {}
+class OutOfBoundsException     extends \OutOfBoundsException     implements Exception {}
+class Foo {
+    public function badArg() {
+        throw new InvalidArgumentException();
+    }
+    public function badBounds() {
+        throw new OutOfBoundsException();
+    }
+}
+?>
+</code>
+Bar package that uses a base Exception class:
+<code>
+<?php
+namespace bar;
+class Exception                extends \Exception {}
+class InvalidArgumentException extends \InvalidArgumentException {}
+class OutOfBoundsException     extends \OutOfBoundsException {}
+class Bar {
+    public function badArg() {
+        throw new InvalidArgumentException();
+    }
+    public function badBounds() {
+        throw new OutOfBoundsException();
+    }
+}
+?>
+</code>
+Test script:
+<code>
+<?php
+echo 'Testing the Exception base INTERFACE ======================' . PHP_EOL;
+require_once 'Foo.php';
+$x = new \foo\Foo();
+try {
+    echo '  * Will catch(\foo\Exception) catch a \foo\InvalidArgumentException ???' . PHP_EOL;
+    $x->badArg();
+} catch (\foo\Exception $e) {
+    echo '    * Caught a \foo\Exception ok, so YES... as expected.' . PHP_EOL;
+}
+echo PHP_EOL;
+echo 'Testing the Exception base CLASS =====================' . PHP_EOL;
+require_once 'Bar.php';
+$y = new \bar\Bar();
+try {
+    echo '  * Will catch(\bar\Exception) catch a \bar\InvalidArgumentException ???' . PHP_EOL;
+    $y->badArg();
+} catch (\bar\Exception $e) {
+    echo '    * Caught a \bar\Exception ok, so YES... this is unexpected!' . PHP_EOL;
+}
+?>
+</code>
+Test results:
+<code>
+Testing the Exception base INTERFACE ======================
+  * Will catch(\foo\Exception) catch a \foo\InvalidArgumentException ???
+    * Caught a \foo\Exception ok, so YES... as expected.
+Testing the Exception base CLASS =====================
+  * Will catch(\bar\Exception) catch a \bar\InvalidArgumentException ???
+PHP Fatal error:  Uncaught exception 'bar\InvalidArgumentException' in /home/ashnazg/exceptions/Bar.php:11
+Stack trace:
+#0 /home/ashnazg/exceptions/test.php(19): bar\Bar->badArg()
+#1 {main}
+  thrown in /home/ashnazg/exceptions/Bar.php on line 11
+</code>

Differences

Page Tools