本文介紹調試 PHP 應用程式的各種方法,包括在 Apache and PHP 中開啟錯誤報表,以及通過在一個簡單的 PHP 指令碼中放置策略性的 print 語句,找到更困難的 bug 的源頭。還會介紹用於 Eclipse 的 PHPEclipse 外掛程式,這是一個靈活的開發環境,具有即時文法解析能力,還會介紹 PHPEclipse 的 DBG 調試器擴充。
簡介
有許多 PHP 調試技術可以在編碼的時候節約大量時間。一個有效卻很基本的調試技術就是開啟錯誤報表。另一個略微進階一點的技術包括使用 print 語句,通過顯示在螢幕上實際出現的內容,有助於精確地找出更難發現的 bug。PHPEclipse 是一個 Eclipse 外掛程式,能夠強調常見的語法錯誤,可以與調試器結合起來用於設定斷點。
設定
要學習本文描述的概念,需要 PHP、Web 服務器和 Eclipse。調試器擴充支援的 PHP 版本是 V5.0.3。
我們需要一個 Web 服務器來解析用 PHP 建立的頁面並把它們顯示到瀏覽器。本文中使用的是 Apache2。但是,任何 Web 服務器都可以滿足要求。
要利用本文中介紹的一些調試技術,需要安裝 Eclipse V3.1.1 和外掛程式 PHPEclipse V1.1.8。由於 Eclipse 要求 Java? 技術,所以還要下載它。
還需要 PHP 的調試器擴充模組。安裝它略有些麻煩。請仔細跟隨安裝調試器擴充的操作說明。現在,先在 php.ini 檔案中注釋掉那些要求裝入和配置 PHP 擴充的行。在需要使用調試器的時候,再取消注釋。
請參閱 參考資料 獲得下載資訊。現在介紹出錯訊息。
出錯訊息
出錯訊息是作為開發人員的第一道防線。誰都不想在一台沒有配置成顯示出錯訊息的伺服器上用 PHP 開發代碼。但是,請記住,當代碼調試完成,準備啟動並執行時候,應當確保關閉了錯誤報表,因為不希望網站的訪問者看到出錯訊息,因為這會給他們提供足夠的資訊來利用網站的弱點並黑掉網站。
也可以用出錯訊息為自己服務,因為它們會顯示拋出或建置錯誤的正確程式碼。這樣,調試就變成在瀏覽器上查看產生的錯誤所顯示的行號,並在代碼中檢查這一行。稍後,將會看到 PHPEclipse 外掛程式通過即時地給語法錯誤加底線並在儲存檔案時用紅色 “x” 標註語法錯誤,可在開發和調試過程中提供極大的協助。
先來看如何在 php.ini 檔案中開啟錯誤報表並設定錯誤報表的層級。然後將學習如何在 Apache 的設定檔中覆蓋這些設定。
PHP 的錯誤報表
php.ini 檔案中有許多配置設定。您應當已經設定好自己的 php.ini 檔案並把它放在合適的目錄中,就像在 Linux 上安裝 PHP 和 Apache 2 的文檔說明中所示的那樣(請參閱 參考資料)。在調試 PHP 應用程式時,應當知道兩個組態變數。下面是這兩個變數及其預設值:
display_errors = Off error_reporting = E_ALL |
通過在 php.ini 檔案中搜尋它們,可以發現這兩個變數當前的預設值。display_errors 變數的目的很明顯 —— 它告訴 PHP 是否顯示錯誤。預設值是 Off。但是,要讓開發過程更加輕鬆,請把這個值設為 On:
error_reporting 變數的預設值是 E_ALL。這個設定會顯示從不良編碼實踐到無害提示到出錯的所有資訊。E_ALL 對於開發過程來說有點太細,因為它在螢幕上為一些小事(例如變數未初始化)也顯示提示,會搞糟瀏覽器的輸出。我只想看到錯誤和不良編碼實踐,但是不想看到無害的提示。所以,請用以下值代替 error_reporting 的預設值:
error_reporting = E_ALL & ~E_NOTICE |
重新啟動 Apache,就全部設定好了。接下來,將學習如何在 Apache 上做同樣的事。
伺服器上的錯誤報表
依賴於 Apache 正在做的工作,在 PHP 中開啟錯誤報表可能沒法工作,因為在電腦上可能有多個 PHP 版本。有時很難區分 Apache 正在使用哪個 PHP 版本,因為 Apache 只能查看一個 php.ini 檔案。不知道 Apache 正在使用哪個 php.ini 檔案配置自己是一個安全問題。但是,有一種方法可以在 Apache 中配置 PHP 變數,從而保證設定了正確的出錯層級。
而且,最好知道如何在伺服器端設定這些組態變數,以否決或搶佔 php.ini 檔案,從而提供更進階別的安全性。
在配置 Apache 時,應該已經接觸過 /conf/httpd.conf 中 http.conf 檔案中的基本配置。
要做在 php.ini 檔案中已經做過的事,請把下列各行添加到 httpd.conf,覆蓋任何 php.ini 檔案:
php_flag display_errors on php_value error_reporting 2039 |
這會覆蓋在 php.ini 檔案中為 display_errors 已經設定的標誌,以及 error_reporting 的值。值 2039 代表 E_ALL & ~E_NOTICE。如果願意採用 E_ALL,請把值設為 2047。同樣,還是要重啟 Apache。
接下來,要在伺服器上測試錯誤報表。
測試錯誤報表
如果啟動了錯誤報表,會節約許多時間。PHP 中的錯誤會指向代碼中的錯誤。請建立一個簡單的 PHP 檔案 test.php,並像清單 1 所示一樣定義它。
清單 1. 一個建置錯誤的簡單 PHP
"); printaline("PLEASE?"); print("This will not be displayed due to the above error."); ?> |
第一個 print() 語句會向 網頁瀏覽器顯示它的內容。但是第二個語句會建置錯誤並在 Web 頁面上顯示。這造成最後一個 print() 語句不起作用, 1 所示。
圖 1. 建置錯誤
現在開啟了錯誤報表!接下來,用 print 語句協助調試應用程式。
介紹 print 語句
因為應用程式中的功能性 bug 不會產生錯誤,所以在所有調試策略中,關於如何正確地放置和使用 print 或 die 語句來調試 PHP 應用程式的知識是一種很好的資產。可以用 print 語句在代碼中縮小對問題語句的定位,這些語句在文法上沒有錯誤,也不是 bug,但是從代碼的功能上看是 bug。這些是最難發現和調試的 bug,因為它們不會拋出錯誤。惟一知道的就是在瀏覽器上顯示的內容不是想要的內容,或者想要儲存在資料庫中的內容根本沒有儲存。
假設正在處理通過 GET 請求發送過來的表單資料,想向瀏覽器顯示資訊,但是出於某種原因,資料沒有正確地提交,或者不能正確地從 GET 請求中讀出。要調試這類問題,重要的是用 print() 或 die() 語句知道變數的值是什麼。
die() 語句會中止程式執行,並在 網頁瀏覽器上顯示文本。如果不想注釋掉代碼,而且只想顯示到出錯之前的資訊和出錯資訊,不想顯示後面的資訊,那麼 die() 語句特別有用。
讓我們在 PHP 中用 print 語句來測試這個概念
使用 print 語句進行調試
在我作程式員的那些時候,當我在 Linux? 上開發應用程式時,沒有方便的 GUI 可以告訴我 bug 在哪,我迅速地發現我在程式中放的 print 語句越多,我在應用程式中把 bug 的範圍縮小到一行的機會越大。請建立另一個 PHP 檔案 test2.php,並像清單 2 所示的那樣定義它。
清單 2. 顯示通過 GET 提交的所有變數
http://www.bkjia.com/PHPjc/508474.htmlwww.bkjia.comtruehttp://www.bkjia.com/PHPjc/508474.htmlTechArticle本文介紹調試 PHP 應用程式的各種方法,包括在 Apache and PHP 中開啟錯誤報表,以及通過在一個簡單的 PHP 指令碼中放置策略性的 print 語句,找... |