PHP 程式設計師的調試小結

不言
發布: 2023-03-23 12:06:01
原創
2612 人瀏覽過

大家都知道在開發過程中,程式碼的調式非常重要,對於一些常見錯誤的偵錯技巧有助於提高程式碼編寫的效率。

本文介紹調試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:

複製程式碼 程式碼如下:

display_errors = 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 程式設計師的調試小結的简单 PHP

复制代码 代码如下:

<?php 
print("The next line generates an error.<br>"); 
printaline("PLEASE?"); 
print("This will not be displayed due to the above error."); 
?>
登入後複製


第一个 print() 语句会向 Web 浏览器显示它的内容。但是第二个语句会PHP 程式設計師的調試小結并在 Web 页面上显示。这造成最后一个 print() 语句不起作用,如图 1 所示。
图 1. PHP 程式設計師的調試小結
PHP 程式設計師的調試小結

现在开启了错误报告!接下来,用 print 语句帮助调试应用程序。
介绍 print 语句
因为应用程序中的功能性 bug 不会产生错误,所以在所有调试策略中,关于如何正确地放置和使用 print 或 die 语句来调试 PHP 应用程序的知识是一种很好的资产。可以用 print 语句在代码中缩小对问题语句的定位,这些语句在语法上没有错误,也不是 bug,但是从代码的功能上看是 bug。这些是最难发现和调试的 bug,因为它们不会抛出错误。惟一知道的就是在浏览器上显示的内容不是想要的内容,或者想要保存在数据库中的内容根本没有保存。
假设正在处理通过 GET 请求发送过来的表单数据,想向浏览器显示信息,但是出于某种原因,数据没有正确地提交,或者不能正确地从 GET 请求中读出。要调试这类问题,重要的是用 print() 或 die() 语句知道变量的值是什么。
die() 语句会中止程序执行,并在 Web 浏览器上显示文本。如果不想注释掉代码,而且只想显示到出错之前的信息和出错信息,不想显示后面的信息,那么 die() 语句特别有用。
让我们在 PHP 中用 print 语句来测试这个概念
使用 print 语句进行调试
在我作程序员的那些时候,当我在 Linux® 上开发应用程序时,没有方便的 GUI 可以告诉我 bug 在哪,我迅速地发现我在程序中放的 print 语句越多,我在应用程序中把 bug 的范围缩小到一行的机会越大。请创建另一个 PHP 文件 test2.php,并像清单 2 所示的那样定义它。

清单 2. 显示通过 GET 提交的所有变量

复制代码 代码如下:

<?php 
$j = ""; 
print("Lets retrieve all the variables submitted to this "); 
print("script via a GET request:<br>"); 
foreach($_GET as $key => $i){ 
print("$key=$j<br>"); 
} 
if($_GET[&#39;Submit&#39;] == "Send GET Request") 
$j = "done!<br>"; 
?> 
<form method="GET"> 
Name: <input name="name"><br> 
Email: <input name="email" size="25"><br> 
<input name="Submit" type="submit" value="Send GET Request"> 
</form>
登入後複製


您可能会非常容易地发现清单 2 中的 bug!您很棒!但请注意这是一个非常简单的脚本,只是作为使用 print 语句进行调试而展示的一个例子而已。这个脚本只是提取 GET 请求中的所有变量,如果有,就把它们显示在浏览器上。还提供了一个表单,用 GET 请求向服务器发送变量以进行测试。请看输出,如图 2 所示。
图 2. test2.php 的输出
test2.php 的输出

现在单击 Send GET Request 按钮,请注意只有 <span style="font-family:新宋体">$_GET</span> 请求的键显示在浏览器上,而正确的值都没显示。可以在循环中放一个 print 语句,检验在 <span style="font-family:新宋体">foreach</span> 循环中每个元素中是否确实存在数据。请参阅清单 3。
清单 3. 用 print 语句验证代码的功能

复制代码 代码如下:

... 
foreach($_GET as $key => $i){ 
print("Correct data? " . $_GET[$key] . "<br>"); 
print("$key=$j<br>"); 
} 
...
登入後複製


放进去的 print 语句是粗体。注意,现在已经知道在 Web 浏览器上显示的 $key 值是正确的,但是由于某些原因,值没有正确地显示。请看新的输出,如图 3 所示。
图 3. 修改后的 test2.php 的输出
修改后的 test2.php 的输出

现在已经知道应用程序正确地从 <span style="font-family:新宋体">GET</span> 请求接收到了变量,那么肯定是在代码中有 bug。查看之后注意到,用来显示值的变量 <span style="font-family:新宋体">$j</span> 是错误的。在 <span style="font-family:新宋体">foreach</span> 语句中指定的是 <span style="font-family:新宋体">$i</span>,所以它肯定会有正确的值,但是无意之中输入了 <span style="font-family:新宋体">$j</span>。所以通过把 <span style="font-family:新宋体">$j</span> 替换成 <span style="font-family:新宋体">$i</span>,迅速地修正了错误,重新载入页面之后,就看到了正确的输出,如图 4 所示。


图 4. 修正后的 test2.php 的输出
修正后的 test2.php 的输出

现在可以删除或注释掉刚才添加的 print 语句了,因为已经发现了代码中的 bug。注意,这只是在调试应用程序时可能遇到的许多错误中的一个很小的子集。对于使用数据库时可能遇到的问题,一个好的解决方案是输出 SQL 语句,以确保执行的 SQL 就是想要执行的。

现在要来看看如何使用 Eclipse IDE 和 PHPEclipse 插件及调试器扩展进一步在调试历程中提供帮助。

使用 PHPEclipse

您可能用过 Eclipse,但是可能不熟悉它。请参阅 参考资料 获得 Eclipse 平台的介绍。

用于 Eclipse 的 PHPEclipse 插件是用来开发 PHP 应用程序的一个流行工具。请启动 Eclipse 并把工作区目录指定为 Apache 的 www 目录(在我的机器上是 c:\www)。现在单击 File > New > Project。会弹出 New Project 向导。双击 PHP 文件夹并选择 PHP Project。单击 Next,输入项目名称 debugArticle,并单击 Finish

如果把 Web 服务器设置为在端口 80 上侦听,那么不需要做任何修改。否则,请转到 Navigator 窗口,在 PHP 项目 debugArticle 上右击,选择 Properties,然后单击 PHP Project Settings。单击 Configure Workspace Settings 然后修改合适的 localhost 或者添加 Web 服务器侦听的端口(例如 http://localhost:8080)。单击 Apply 完成设置。

Navigator 窗口应当显示项目和一个 .project 文件。在项目上右击,就像前面做的那样,只是这次选择 New > PHP File。用想要创建的 PHP 文件的名称 test3.php 替换 *.php,然后单击 Finish。在 Eclipse IDE 中应当出现一个新文件。可能需要导航到窗口底部的 PHP 浏览器来查看 PHP 文件的当前输出(参见图 5)。


图 5. Eclipse 的 PHPEclipse 插件
Eclipse 的 PHPEclipse 插件

注意,只有 Windows® 的用户可以像清单 5 所示的那样使用 PHP 浏览器。通过打开独立浏览器窗口并把浏览器指向测试脚本所在目录,也可以使用同样的功能。

现在来演示这个应用程序,证明它的强大能力。

在 “使用调试器” 一节中,将学习如何用 Eclipse、PHPEclipse 和前面下载的调试器 PHP 扩展来调试 PHP 应用程序。先从学习如何使用它的语法解析功能开始。

语法解析和加下划线

先从查看 PHPEclipse 如何提供帮助调试 PHP 应用程序的实时语法解析功能开始。要看这个特性的实际应用,先从在 Eclipse 中定义 test3.php 开始,如下所示。


<?php
print(,"Hello World!");
?>
登入後複製


注意,在清单 4 中加下划线的两个字符在 Eclipse 中加了下划线,提示语法不正确。按 Ctrl+S 保存文件,会在 Eclipse 中显示解析错误:在代码中与解析错误对应的行上会加上红 “x”,如图 6 所示。


图 6. PHP 程式設計師的調試小結
PHP 程式設計師的調試小結

现在演示 PHP 浏览器。这个窗口提供了当前 PHP 脚本的预览,如图 6 所示。

从上面定义的 test3.php 中删除逗号(<span style="font-family:新宋体">,</span>)。按 Ctrl+S 保存文件,然后观察 PHP 浏览器窗口的更新,显示了 Hello World(参见图 7)。


图 7. 在 PHPEclipse 中预览 PHP 脚本
在 PHPEclipse 中预览 PHP 脚本

下面是用调试器在 PHP 中设置断点。

使用调试器

使用调试器,可以设置断点并查看 PHP 代码到所设断点之前的浏览器输出。然后可以继续代码的执行并查看到下一断点之前的浏览器输出,然后再到下一个,直到 PHP 脚本完成。

现在把 “设置” 一节中在 php.ini 中注释掉的行取消注释,并重新启动 Apache。现在装入了调试器,Eclipse 能够和它挂上了。

现在在 Eclipse 中设计调试环境。请创建新的 test4.php 文件,先保持为空。现在单击 Run > Debug。在左侧面板中选择 PHP DBG Script,并单击 New。现在转到 File 选项卡,输入当前项目 debugArticle 以及想要调试的文件 test4.php。现在转到 Environment 选项卡,然后再到 Interpreter 子选项卡。在 PHP 的安装目录中找到 php.exe 文件(我的是 c:\apps\php5.0.3\php.exe)。现在单击 Remote Debug 子选项卡,选择 Remote Debug,如果没有使用 Windows,请取消 “Open with DBGSession URL in internal browser box” 复选框。把 Remote Source 路径设置成与要测试的 PHP 脚本的绝对路径(不是 Web 路径)相同(我的设置是 c:\www\debugArticle\test4.php)。现在单击 Debug

现在应当装入 Debug 透视图,如图 8 所示。否则,请单击 Window > Open Perspective > Other,并选择 Debug


图 8. Eclipse 中的 Debug 透视图
Eclipse 中的 Debug 透视图

现在可以设置断点了。

对于本文中使用的插件和扩展的版本,断点功能是必需的,因为 PHP 在把输出发送到浏览器之前会缓冲它。除此之外,需要做的不仅仅是设置一个断点把当前显示数据刷新到 Web 浏览器,所以要像下面和图 8 所示那样定义 test4.php。


清单 4. 设置和创建断点

<?php
function break-point(){
  ob_flush();
  flush();
  sleep(.1);
  debugBreak();
}
print("This will get shown first, ");
print("as will this<br>");
breakpoint();
print("This won&#39;t get shown until after ");
print("continuing the break-point<br>");
breakpoint();
print("END!");
?
登入後複製


<span style="font-family:新宋体">breakpoint()</span> 函數會把緩衝的輸出和其他緩衝的資料刷新到 Web 瀏覽器。對<span style="font-family:新宋体">sleep(.1)</span> 的呼叫是必要的,這樣程式碼中止於<span style="font-family:新宋体">debugBreak()</span> 之前,伺服器才有足夠的時間把資料刷新到Web 瀏覽器,這個函數是前面下載的PHP 偵錯器擴充功能的內部函數。這樣,呼叫<span style="font-family:新宋体">breakpoint()</span> 會把HTML 區塊、<span style="font-family:新宋体">#print()</span># 和<span style="font-family:新宋体">echo()</span> 語句的資料刷新到瀏覽器,然後中止程式碼執行。

像清單 4 一樣寫完程式碼之後,可以開啟瀏覽器並指向 test4.php,或者可以查看 PHP 瀏覽器視窗(我的是 http://localhost/debugArticle/test4.php)。每次輸入和儲存檔案時,在 PHP 瀏覽器視窗中就已經啟動了偵錯序列。如果不使用 Windows,請透過瀏覽器查看 test4.php。在儲存了檔案之後,用 F8 或點選 Run > Resume 繼續程式碼執行。持續這麼做,直到最後一行輸出是 <span style="font-family:新宋体">END!</span> 為止(參考圖 9、10 和 11)。


圖9.初始的到第一個斷點的PHP 瀏覽器輸出
初始的到第一个断点的 PHP 浏览器输出

##請注意圖9中的Debug 視窗如何把執行顯示為掛起的。


圖10. 第一個斷點之後到第二個斷點之前的PHP 瀏覽器輸出
第一个断点之后到第二个断点之前的 PHP 浏览器输出

圖10 的Debug 視窗仍然把執行顯示為掛起,而第二組資料顯示在PHP 瀏覽器中。


圖11. 完整的PHP 瀏覽器輸出
完整的 PHP 浏览器输出

注意,圖11 的Debug 視窗中的程式碼不再掛起,整個腳本已經執行,如圖11 的PHP 瀏覽器所示。

既然已經看到了用 PHPEclipse 和偵錯器擴充功能進行開發的優勢,那麼很難想像沒有它會怎麼樣。

結束語

現在已經在PHP 的調試技術集中添加了錯誤報告的運用、print 語句、PHPEclipse 和調試器擴展,您可以透過減少每行程式碼的錯誤數量,成為更有效的PHP 編碼人員。請參閱

參考資料 以獲得一些 PHP 教程,可以在上面測試這些新技能。

下載Sample code for PHP Debugging


參考資料


  • 您可以參考本文在developerWorks 全球網站上的

    英文原文

  • 學習如何在基於 Windows 和 UNIX® 的系統上

    安裝 Java

  • 請造訪

    Eclipse.org 以獲得程式設計和如何使用它的全面資訊。

  • Eclipse 平台入門」(developerWorks,2002 年11 月)提供了Eclipse 的歷史和概述,包括如何安裝Eclipse 和插件的細節。

  • 請造訪

    PHPEclipse 學習關於安裝 PHPEclipse 和如何使用它的更多內容。

  • DBG 是一個全功能的 PHP 偵錯器引擎,一個互動的工具,有助於除錯 PHP 腳本。請閱讀

    Installing and configuring the debugger 上的這份教學。

  • 要學習更多關於 Eclipse 的內容,請造訪 developerWorks 的

    Eclipse project resources

  • 要學習更多關於 PHP 的內容,請造訪 developerWorks 的

    PHP project resources

  • 請參閱 PHP 手冊以取得更多關於

    error reporting 的內容。

  • 請閱讀安裝

    PHP and Apache2 on Linux 的操作說明。

  • 請閱讀安裝

    PHP and Apache2 on Windows 的操作說明。

    #

  • 要取得一系列學習PHP 程式設計的developerWorks 教程,請參閱「學習PHP,第1 部分」、學習PHP,第2 部分學習PHP,第3 部分

  • 請密切注意 developerWorks technical events and webcasts

  • 請造訪developerWorks 開放原始碼專區 獲得豐富的how-to 資訊、工具和專案更新,有助於使用開放原始碼技術進行開發並將它們用於IBM 的產品。


取得產品與技術

  • 請從PHP. net 下載最新版本的PHP

  • 請下載最新版本的 Apache 2

  • 請從 Sun 公司下載 Java 技術

  • 請從 Eclipse.org 下載最新版本的 Eclipse

  • 請從 Sourceforge 下載 PHPEclipse。把 Eclipse 解壓縮到 eclipse-install-dir,然後把 PHPEclipse 解壓縮到 eclipse-install-dir。在安裝擴充功能時,要依照 PHPEclipse instructions。但是,在要求在 php.ini 檔案中裝入和配置 PHP 擴充功能的地方註解掉那些行。在準備使用偵錯器時再取消這些行的註解。

  • 訂購免費的SEK for Linux,這套DVD(兩張),包含了來自DB2®、Lotus®、 Rational® 、Tivoli® 和WebSphere® 的用於Linux 的最新IBM 試用軟體。

  • 請用 IBM 試用軟體 改造您的下一個開放原始碼開發項目,可以下載也可以透過 DVD 得到。


#討論

  • #透過參與developerWorks blogs 加入developerWorks 社群。



關於作者



Tyler Anderson 2004 年從Brigham Young 大學畢業,獲得電腦科學學位。現在是他擔任電腦工程碩士生的最後一學期。過去,他作為資料庫程式設計師為 DPMG.com 工作,現在他是位於 Beaverton, Ore 的 Stexar 公司的工程師。

原文網址http://www.ibm.com/developerworks/cn/opensource/os-debug/


#

以上是PHP 程式設計師的調試小結的詳細內容。更多資訊請關注PHP中文網其他相關文章!

相關標籤:
來源:php.cn
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
作者最新文章
最新問題
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板
關於我們 免責聲明 Sitemap
PHP中文網:公益線上PHP培訓,幫助PHP學習者快速成長!