PHP出錯介面

在web 上所有常見的錯誤之一就是無效的連結。一旦從其它網站上出現了無效的連結，你會重新安排你
的網站。人們會將他們喜歡的網站存成書籤，如果在三個月後再次訪問時，僅僅發現的是'404 Not Fount '
時，將不會給他們任務協助，告訴他們如何從你的網站去尋找原始的資訊。讓我們解決這個問題，或者至少
給你的使用者一個友好的協助，一旦他們遇到'a 404' 錯誤時，能夠得到一些痕迹。你可以建立普通的頁面來
報告在處理你的頁面時所遇到的所有的錯誤。

PHP 與Apache一起可以很自由地讓你建立自已的出錯頁面，但是需要重新進行配置，並且要編少量的代
碼。先讓我們學習配置部分。

Apache的ErrorDocument指示用來指出在出現錯誤時Apache應重新導向到哪一個文檔（或URI）。它允許你
為每一個你的使用者可能遇到的錯誤碼指定一個資源。通過在你的伺服器配置中增加一個ErrorDocument 404
/error.php指示。這個將在使用者訪問一個不存在的頁面時，重新導向到'error.php'中，下面我們就會寫出
'error.php'頁面。不要忘了重新啟動Apache以使改動生效。

接著，我們寫出一個簡單的error.php：

你所請求的檔案 (<?=$REDIRECT_URL?> ) 在這個伺服器上不存在。
請尋找你想要的檔案從 <A HREF="/">前頁</A>。

現在試著讀取一個在你伺服器上不存在的頁面，怎麼樣，你可以看到error.php了，它有著一個良好和
友好的訊息，並且還有一個到前頁的連結。

讓我們把它擴充一下。正如你所見，我在error.php中使用了REDIRECT_URL變數。這個變數是Apache在
執行了一個ErrorDocument指示時所設定的，並且給出了一種可能來找到原始的資源。在這種情況下，Apache
還設定了一些別的變數，所有的變數可以在這裡找到。使用這些變數可能建立一個很好的出錯頁面，用於給
使用者一個不錯與友好的出錯頁面，而代替Apache給出的預設頁面。

從PHP頁面中輸出錯誤
從一個PHP頁面輸出錯誤與類比Apache對ErrorDocument指示所做的很象，你只要簡單地將使用者重新導向，
通過使用query-string變數，而Apache則通常是設定在環境變數裡面。這樣就可以使用同一個出錯頁面來處
理各種錯誤。下面是一個例子：

<?php

function throw_error($message) {
$error_page = "/err/error.php";

$error_url = $error_page;
$error_url .= "?REDIRECT_ERROR_NOTES=$message";
$error_url .= "&REDIRECT_URL=" . $GLOBALS["PHP_SELF"];
$error_url .= "&REDIRECT_REQUEST_METHOD=$REQUEST_METHOD";
$error_url .= "&REDIRECT_STATUS=501";
Header("Status: 501");
Header("Location: $error_url");
exit;
}

ob_start();
// 使用輸出緩衝以便在這頁中的任何地方輸出錯誤

if(!condition) {
throw_error("the condition failed");
}

ob_end_flush();
// 頁面處理完畢，重新整理輸出緩衝
?>
使用PHP4的輸出緩衝特性對產生一般的出錯報告功能也會有協助。但是在你確認整個出錯頁面處理完畢
時，不要忘記重新整理緩衝區，你可以在你的代碼中的任可地方通過Header調用來進行重新導向。