用戶(hù)可以用自定義的異常處理類(lèi)來(lái)擴展 PHP 內置的異常處理類(lèi)。以下的代碼說(shuō)明了在內置的異常處理類(lèi)中，哪些屬性和方法在子類(lèi)中是可訪(fǎng)問(wèn)和可繼承的。
示例 #1 內置的異常處理類(lèi)
<?php
class Exception implements Throwable
{
protected $message = 'Unknown exception'; // 異常信息
private $string; // __toString 的緩存
protected $code = 0; // 用戶(hù)自定義異常錯誤碼
protected $file; // 發(fā)生異常的源文件名
protected $line; // 發(fā)生異常的源代碼行號
private $trace; // backtrace
private $previous; // 如果是嵌套異常，則是之前的 exception
public function __construct($message = '', $code = 0, Throwable $previous = null);
final private function __clone(); // 禁止克隆異常。
final public function getMessage(); // 異常信息
final public function getCode(); // 異常錯誤碼
final public function getFile(); // 發(fā)生異常的源文件名
final public function getLine(); // 發(fā)生異常的源代碼行號
final public function getTrace(); // backtrace() 數組
final public function getPrevious(); // 之前的 exception
final public function getTraceAsString(); // 已格成化成字符串的 getTrace() 信息
// Overrideable
public function __toString(); // 可輸出的格式化后的字符串
}
?>
如果使用自定義的類(lèi)來(lái)擴展內置異常處理類(lèi)，并且要重新定義構造函數的話(huà)，建議同時(shí)調用 parent::__construct() 來(lái)確保所有的變量已賦值。當對象要輸出字符串的時(shí)候，可以重載 __toString() 并自定義輸出的樣式。
注意:
Exception 對象不能被復制。嘗試對 Exception 對象復制 會(huì )導致一個(gè)
E_ERROR級別的錯誤。
示例 #2 擴展 PHP 內置的異常處理類(lèi)
<?php
/**
* 自定義一個(gè)異常處理類(lèi)
*/
class MyException extends Exception
{
// 重定義構造器使 message 變?yōu)楸仨毐恢付ǖ膶傩?br> public function __construct($message, $code = 0, Throwable $previous = null) {
// 這里寫(xiě)用戶(hù)的代碼
// 確保所有變量都被正確賦值
parent::__construct($message, $code, $previous);
}
// 自定義字符串輸出的格式
public function __toString() {
return __CLASS__ . ": [{$this->code}]: {$this->message}\n";
}
public function customFunction() {
echo "A custom function for this type of exception\n";
}
}
/**
* 創(chuàng )建一個(gè)類(lèi)，測試該 exception 類(lèi)
*/
class TestException
{
public $var;
const THROW_NONE = 0;
const THROW_CUSTOM = 1;
const THROW_DEFAULT = 2;
function __construct($avalue = self::THROW_NONE) {
switch ($avalue) {
case self::THROW_CUSTOM:
// 拋出自定義異常
throw new MyException('1 is an invalid parameter', 5);
break;
case self::THROW_DEFAULT:
// 拋出默認的異常
throw new Exception('2 is not allowed as a parameter', 6);
break;
default:
// 沒(méi)有異常的情況下，創(chuàng )建一個(gè)對象
$this->var = $avalue;
break;
}
}
}
// 例子 1
try {
$o = new TestException(TestException::THROW_CUSTOM);
} catch (MyException $e) { // 捕獲異常
echo "Caught my exception\n", $e;
$e->customFunction();
} catch (Exception $e) { // 被忽略
echo "Caught Default Exception\n", $e;
}
// 繼續執行后續代碼
var_dump($o); // Null
echo "\n\n";
// 例子 2
try {
$o = new TestException(TestException::THROW_DEFAULT);
} catch (MyException $e) { // 不能匹配異常的種類(lèi)，被忽略
echo "Caught my exception\n", $e;
$e->customFunction();
} catch (Exception $e) { // 捕獲異常
echo "Caught Default Exception\n", $e;
}
// 執行后續代碼
var_dump($o); // Null
echo "\n\n";
// 例子 3
try {
$o = new TestException(TestException::THROW_CUSTOM);
} catch (Exception $e) { // 捕獲異常
echo "Default Exception caught\n", $e;
}
// 執行后續代碼
var_dump($o); // Null
echo "\n\n";
// 例子 4
try {
$o = new TestException();
} catch (Exception $e) { // 沒(méi)有異常，被忽略
echo "Default Exception caught\n", $e;
}
// 執行后續代碼
var_dump($o); // TestException
echo "\n\n";
?>