用戶可以用自定義的異常處理類來擴(kuò)展 PHP 內(nèi)置的異常處理類。以下的代碼說明了在內(nèi)置的異常處理類中,哪些屬性和方法在子類中是可訪問和可繼承的。
示例 #1 內(nèi)置的異常處理類
<?php
class Exception implements Throwable
{
protected $message = 'Unknown exception'; // 異常信息
private $string; // __toString 的緩存
protected $code = 0; // 用戶自定義異常錯誤碼
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() 數(shù)組
final public function getPrevious(); // 之前的 exception
final public function getTraceAsString(); // 已格成化成字符串的 getTrace() 信息
// Overrideable
public function __toString(); // 可輸出的格式化后的字符串
}
?>
如果使用自定義的類來擴(kuò)展內(nèi)置異常處理類,并且要重新定義構(gòu)造函數(shù)的話,建議同時調(diào)用 parent::__construct() 來確保所有的變量已賦值。當(dāng)對象要輸出字符串的時候,可以重載 __toString() 并自定義輸出的樣式。
注意:
Exception 對象不能被復(fù)制。嘗試對 Exception 對象復(fù)制 會導(dǎo)致一個
E_ERROR
級別的錯誤。
示例 #2 擴(kuò)展 PHP 內(nèi)置的異常處理類
<?php
/**
* 自定義一個異常處理類
*/
class MyException extends Exception
{
// 重定義構(gòu)造器使 message 變?yōu)楸仨毐恢付ǖ膶傩?br> public function __construct($message, $code = 0, Throwable $previous = null) {
// 這里寫用戶的代碼
// 確保所有變量都被正確賦值
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)建一個類,測試該 exception 類
*/
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:
// 拋出默認(rèn)的異常
throw new Exception('2 is not allowed as a parameter', 6);
break;
default:
// 沒有異常的情況下,創(chuàng)建一個對象
$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;
}
// 繼續(xù)執(zhí)行后續(xù)代碼
var_dump($o); // Null
echo "\n\n";
// 例子 2
try {
$o = new TestException(TestException::THROW_DEFAULT);
} catch (MyException $e) { // 不能匹配異常的種類,被忽略
echo "Caught my exception\n", $e;
$e->customFunction();
} catch (Exception $e) { // 捕獲異常
echo "Caught Default Exception\n", $e;
}
// 執(zhí)行后續(xù)代碼
var_dump($o); // Null
echo "\n\n";
// 例子 3
try {
$o = new TestException(TestException::THROW_CUSTOM);
} catch (Exception $e) { // 捕獲異常
echo "Default Exception caught\n", $e;
}
// 執(zhí)行后續(xù)代碼
var_dump($o); // Null
echo "\n\n";
// 例子 4
try {
$o = new TestException();
} catch (Exception $e) { // 沒有異常,被忽略
echo "Default Exception caught\n", $e;
}
// 執(zhí)行后續(xù)代碼
var_dump($o); // TestException
echo "\n\n";
?>