三、 拋出異常

你可能已經從上面的代碼中注意到，你捕獲的是一個稱為QueryException(我們將在后面實現這個對象)的異常。一個異常類似于一個錯誤，然而卻更具有一般性。描述一個異常的最好的方法是使用emergency。盡管一個emergency可以不會是“致命的”，但是還是必須處理它。當在PHP中拋出一個異常時，執行的當前范圍很快地被終止，不管它是一個函數，try..catch塊還是腳本本身。然后，該異常遍歷調用棧—終止每個執行范圍，直到或者在一個try..catch塊中捕獲它或者它到達調用棧的頂部—此時它將生成一個致命錯誤。

異常處理是PHP 5中的另外一個新特征，當與OOP聯用時，它能夠實現良好地控制錯誤處理和報告。一個try..catch塊是一種處理異常的重要機制。一旦被捕獲，腳本將會從異常被捕獲和被處理的代碼的下一行繼續執行。

如果查詢失敗，你需要改變你的execute函數以拋出一個異常。你將拋出一個稱為QueryException的定制異常對象—導致錯誤的DBQuery對象被傳遞給它。

列表3.拋出一個異常。

/**

*執行當前查詢

*

* 執行當前查詢—用提供的參數代替任何點位符

* .

*

* @參數： mixed $queryParams，... 查詢參數

* @返回：資源A—參考描述執行查詢的資源。

*/

public function execute($queryParams = '')

{

//例如: SELECT * FROM table WHERE name=:1S AND type=:2I AND level=:3N

$args = func_get_args();

if ($this->stored_procedure) {

/*調用compile函數以得到查詢*/

$query = call_user_func_array(array($this， 'compile')， $args);

} else {

/*一個存儲過程沒被初始化，因此，作為一種標準查詢來執行之*/

$query = $queryParams;

}

$result = $this->db->query($query);

if (! $result) {

throw new QueryException($this);

}

$this->result = $result;

/* 注意現在我們怎么返回對象本身，這使我們能夠從這個函數的返回結果中調用成員函數

*/

return $this;

}

四、 使用繼承拋出定制異常

在PHP中，你可以拋出任何對象作為一個異常;但是，首先該異常應該繼承自PHP的內置異常類。通過創建你自己的定制異常，你可以記錄其它有關于該錯誤的信息，例如在一個日志文件中創建一個入口，或做你喜歡做的任何事情。你的定制異常將要做如下幾件事情：

· 記錄由查詢產生的來自DB對象的錯誤消息。

· 給出查詢錯誤發生所在行代碼的準確細節—通過檢查調用棧。

· 顯示錯誤消息和查詢文本—當被轉換成一個字符串時。

為了得到錯誤信息和查詢文本，需要對DBQuery對象作多處更改。

1. 一個新的protected屬性—compiledQuery—需要被添加到類中。

2. compile()函數使用查詢文本更新查詢compiledQuery屬性。

3. 應該加入一個檢索編譯的查詢文本的函數。

4. 還應該加入一個函數—它得到當前的與DBQuery對象相關聯的DB對象。

列表4.拋出一個異常。

class DBQuery

{

/**

*在調用compile()或execute()之后存儲查詢的編譯版本

*

* @var string $compiledQuery

*/

protected $compiledQuery;

/**

* 返回編譯的查詢而不執行它。

* @參數：mixed $params，...查詢參數

* @返回：字符串—編譯的查詢

*/

public function compile($params='')

{

if (! $this->stored_procedure) {

throw new Exception("存儲過程沒被初始化.");

}

/*代替參數*/

$params = func_get_args(); //得到函數參數

$query = preg_replace("/(?compile_callback($params， 1， "2")'， $this->query);

return ($this->compiledQuery = $this->add_strings($query)); //把字符串放回查詢中

}

public function getDB()

{

return $this->db;

}

public function getCompiledQuery()

{

return $this->compiledQuery;

}

}

現在，你可以實現QueryException類。注意你是如何遍歷調用棧以在腳本中查找實際導致錯誤的位置的。這正好適用于當拋出異常的DBQuery對象是一個繼承自DBQuery對象的子類的情況。

列表5:QueryException類。

/**

*查詢異常

*

*當試圖執行一個查詢時，如果一個錯誤發生，將由{@link DBQuery}對象拋出錯誤

*/

class QueryException extends Exception

{

/**

* 查詢文本

*

* @var字符串$QueryText;

*/

protected $QueryText;

/**

*來自數據庫的錯誤號/代碼

*

* @var字符串$ErrorCode

*/

protected $ErrorNumber;

/**

*來自數據庫的錯誤消息

*

* @var字符串$ErrorMessage

*/

protected $ErrorMessage;

/**

*類構造器

*

* @參數：DBQuery $db，是拋出異常的查詢對象

*/

public function __construct(DBQuery $query)

{

/*得到調用棧*/

$backtrace = $this->GetTrace();

/*把行和文件設置到錯誤實際發生的位置*/

if (count($backtrace) > 0) {

$x = 1;

/*如果查詢類被繼承，那么我們需要忽略由子類所進行的調用*/

while((! isset($backtrace[$x]['line'])) ||

(isset($backtrace[$x]['class']) && is_subclass_of($backtrace[$x]['class']， 'DBQuery')) ||

(strpos(strtolower(@$backtrace[$x]['function'])， 'call_user_func')) !== false ) {

/*循環執行，只要沒有行號或調用的函數是DBQuery類的一個子類*/

$x;

/*如果我們到達棧底，那么我們使用第一個調用者*/

if (($x) >= count($backtrace)) {

$x = count($backtrace);

break;

}

}

/*如果上面的循環至少執行一次，那么我們可以把它減1以查找實際的引起錯誤的代碼行

*/

if ($x != 1) {

$x -= 1;

}

/*最后，我們可以設置文件和行號，這應該可以反映出引起錯誤的SQL語句*/

$this->line = $backtrace[$x]['line'];

$this->file = $backtrace[$x]['file'];

}

$this->QueryText = $query->getCompiledQuery();

$this->ErrorNumber = $query->getDB()->errno();

$this->ErrorMessage = $query->getDB()->error();

/*調用超類的異常構造器*/

parent::__construct('Query Error'， 0);

}

/**

*得到查詢文本

*

* @返回字符串查詢文本

*/

public function GetQueryText()

{

return $this->QueryText;

}

/**

*得到錯誤號

*

* @返回字符串錯誤號

*/

public function GetErrorNumber()

{

return $this->ErrorNumber;

}

/**

*得到錯誤消息

*

* @返回字符串錯誤消息

*/

public function GetErrorMessage()

{

return $this->ErrorMessage;

}

/**

*當對象被轉換為一個字符串時調用。

* @返回字符串

*/

public function __toString()

{

$output = "Query Error in {$this->file} on line {$this->line}nn";

$output .= "Query: {$this->QueryText}n";

$output .= "Error: {$this->ErrorMessage} ({$this->ErrorNumber})nn";

return $output;

}

}

至此，在本節開始看到的代碼可以工作了。

五、 結論

在本文中，你看到了代理是怎樣把與查詢相聯系的DB接口映射到針對一個特定的查詢結果上的操作。DBQuery對象暴露相同的函數，例如fetch_assoc()，作為DB對象。然而，這些都是針對單個查詢起作用。你還學習了如何使用定制異常來給出詳細信息—一個錯誤發生在何時何地，以及它們怎樣更好地控制錯誤的處理。