Résumé du débogage pour les programmeurs PHP

不言
Libérer: 2023-03-23 12:06:01
original
2612 Les gens l'ont consulté

Tout le monde sait que le débogage du code est très important pendant le processus de développement. Les compétences en débogage de certaines erreurs courantes peuvent aider à améliorer l'efficacité de l'écriture du code.

Cet article couvre différentes manières de déboguer les applications PHP, notamment l'activation du rapport d'erreurs dans Apache et PHP, et la recherche de la source de bogues plus difficiles en plaçant stratégiquement les instructions d'impression dans un simple script PHP. Vous découvrirez également le plug-in PHPEclipse pour Eclipse, un environnement de développement flexible doté de capacités d'analyse syntaxique en temps réel, ainsi que l'extension du débogueur DBG pour PHPEclipse.
Introduction
Il existe de nombreuses techniques de débogage PHP qui peuvent faire gagner beaucoup de temps lors du codage. Une technique de débogage efficace mais basique consiste à activer le rapport d’erreurs. Une autre technique, légèrement plus avancée, consiste à utiliser des instructions print, qui peuvent aider à identifier les bogues plus difficiles à trouver en affichant ce qui apparaît réellement à l'écran. PHPEclipse est un plug-in Eclipse qui met en évidence les erreurs de syntaxe courantes et peut être utilisé conjointement avec le débogueur pour définir des points d'arrêt.

Configuration
Pour apprendre les concepts décrits dans cet article, PHP, un serveur Web et Eclipse sont requis. L'extension du débogueur prend en charge la version PHP V5.0.3.
Nous avons besoin d'un serveur Web pour analyser les pages créées avec PHP et les afficher au navigateur. Apache2 est utilisé dans cet article. Cependant, n’importe quel serveur Web suffira.
Pour profiter de certaines techniques de débogage décrites dans cet article, vous devez installer Eclipse V3.1.1 et le plug-in PHPEclipse V1.1.8. Étant donné qu'Eclipse nécessite la technologie Java™, téléchargez-la également.
Nécessite également le module d'extension du débogueur PHP. L'installer est un peu délicat. Veuillez suivre attentivement les instructions d'installation de l'extension du débogueur. Maintenant, commentez les lignes du fichier php.ini qui nécessitent que l'extension PHP soit chargée et configurée. Décommentez-le lorsque vous devez utiliser le débogueur.
Veuillez consulter les ressources pour les informations de téléchargement. Parlons maintenant des messages d'erreur.

Messages d'erreur
Les messages d'erreur sont votre première ligne de défense en tant que développeur. Personne ne souhaite développer du code en PHP sur un serveur qui n'est pas configuré pour afficher des messages d'erreur. Cependant, n'oubliez pas que lorsque vous avez débogué votre code et que vous êtes prêt à l'exécuter, vous devez vous assurer que le rapport d'erreurs est désactivé, car vous ne voulez pas que les visiteurs de votre site voient des messages d'erreur, car cela leur donnera suffisamment d'informations pour exploiter le code. les faiblesses du site et pirater le site.
Les messages d'erreur peuvent également être très utiles, car ils affichent la bonne ligne de code qui a généré ou généré l'erreur. De cette façon, le débogage consiste à rechercher dans le navigateur le numéro de ligne où l'erreur générée apparaît et à inspecter cette ligne dans le code. Plus tard, vous verrez que le plug-in PHPEclipse peut être d'une grande aide lors du développement et du débogage en soulignant les erreurs de syntaxe à la volée et en marquant les erreurs de syntaxe avec un "x" rouge lors de l'enregistrement du fichier.
Voyons d'abord comment activer le rapport d'erreurs et définir le niveau de rapport d'erreurs dans le fichier php.ini. Vous apprendrez ensuite comment remplacer ces paramètres dans les fichiers de configuration d'Apache.
Rapport d'erreurs pour PHP
Il existe de nombreux paramètres de configuration dans le fichier php.ini. Vous devriez déjà avoir votre fichier php.ini configuré et placé dans le répertoire approprié, comme indiqué dans les instructions d'installation de PHP et Apache 2 sur Linux (voir Ressources). Il existe deux variables de configuration dont vous devez être conscient lors du débogage d'applications PHP. Voici les deux variables et leurs valeurs par défaut :

Copiez le code Le code est le suivant :

display_errors = Off 
error_reporting = E_ALL
Copier après la connexion

En les recherchant dans le php Fichier .ini, Les valeurs par défaut actuelles de ces deux variables peuvent être trouvées. Le but de la variable display_errors est évident : elle indique à PHP s'il doit afficher les erreurs. La valeur par défaut est Désactivé. Cependant, pour faciliter le processus de développement, définissez cette valeur sur On :

Copier le code Le code est le suivant :

display_errors = On
Copier après la connexion


error_reporting La valeur par défaut de la variable est E_ALL. Ce paramètre affichera tout, des mauvaises pratiques de codage aux astuces inoffensives en passant par les erreurs. E_ALL est un peu trop granulaire à des fins de développement, car il affiche également des astuces à l'écran pour de petites choses (telles que des variables non initialisées), ce qui gâche la sortie du navigateur. Je veux seulement voir les erreurs et les mauvaises pratiques de codage, mais pas les astuces inoffensives. Veuillez donc remplacer la valeur par défaut de error_reporting par la valeur suivante :

Copiez le code Le code est le suivant :

error_reporting = E_ALL & ~E_NOTICE
Copier après la connexion


重新启动 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
Copier après la connexion


这会覆盖在 php.ini 文件中为 display_errors 已经设置的标志,以及 error_reporting 的值。值 2039 代表 E_ALL & ~E_NOTICE。如果愿意采用 E_ALL,请把值设为 2047。同样,还是要重启 Apache。
接下来,要在服务器上测试错误报告。
测试错误报告
如果启动了错误报告,会节约许多时间。PHP 中的错误会指向代码中的错误。请创建一个简单的 PHP 文件 test.php,并像清单 1 所示一样定义它。
清单 1. 一个Résumé du débogage pour les programmeurs PHP的简单 PHP

复制代码 代码如下:

<?php 
print("The next line generates an error.<br>"); 
printaline("PLEASE?"); 
print("This will not be displayed due to the above error."); 
?>
Copier après la connexion


第一个 print() 语句会向 Web 浏览器显示它的内容。但是第二个语句会Résumé du débogage pour les programmeurs PHP并在 Web 页面上显示。这造成最后一个 print() 语句不起作用,如图 1 所示。
图 1. Résumé du débogage pour les programmeurs PHP
Résumé du débogage pour les programmeurs 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>
Copier après la connexion


您可能会非常容易地发现清单 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>"); 
} 
...
Copier après la connexion


放进去的 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!");
?>
Copier après la connexion


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


图 6. Résumé du débogage pour les programmeurs PHP
Résumé du débogage pour les programmeurs 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!");
?
Copier après la connexion
La fonction


<span style="font-family:新宋体">breakpoint()</span> vide la sortie mise en mémoire tampon et les autres données mises en mémoire tampon vers le navigateur Web. L'appel à <span style="font-family:新宋体">sleep(.1)</span> est nécessaire pour que le serveur ait suffisamment de temps pour actualiser les données du navigateur Web avant que le code ne se termine à <span style="font-family:新宋体">debugBreak()</span>. Cette fonction est une fonction interne de l'extension du débogueur PHP téléchargée précédemment. De cette façon, l'appel de <span style="font-family:新宋体">breakpoint()</span> videra les données du bloc HTML, des instructions <span style="font-family:新宋体">print()</span> et <span style="font-family:新宋体">echo()</span> vers le navigateur, puis abandonnera l'exécution du code.

Après avoir écrit le code comme dans le listing 4, vous pouvez ouvrir un navigateur et pointer sur test4.php, ou vous pouvez afficher une fenêtre de navigateur PHP (la mienne était http://localhost/debugArticle/test4 .php). Chaque fois qu'un fichier est saisi et enregistré, la séquence de débogage est déjà lancée dans la fenêtre du navigateur PHP. Si vous n'utilisez pas Windows, consultez test4.php via votre navigateur. Après avoir enregistré le fichier, continuez l'exécution du code avec F8 ou cliquez sur Exécuter > Continuez ainsi jusqu'à ce que la dernière ligne de sortie soit (voir les figures 9, 10 et 11). <span style="font-family:新宋体">END!</span>


Figure 9. Sortie initiale du navigateur PHP jusqu'au premier point d'arrêt
初始的到第一个断点的 PHP 浏览器输出

Veuillez noter la figure 9 Comment afficher l'exécution comme suspendu dans la fenêtre de débogage.


Figure 10. Sortie du navigateur PHP après le premier point d'arrêt et avant le deuxième point d'arrêt
第一个断点之后到第二个断点之前的 PHP 浏览器输出

La fenêtre de débogage dans la figure 10 affiche toujours l'exécution comme en attente, tandis que le deuxième ensemble de données est affiché dans le navigateur PHP.


Figure 11. Sortie complète du navigateur PHP
完整的 PHP 浏览器输出

Notez que le code dans la fenêtre de débogage de la figure 11 ne Raccrochez et l'intégralité du script a été exécutée, comme le montre la figure 11 dans le navigateur PHP.

Maintenant que vous avez vu les avantages de développer avec PHPEclipse et l’extension du débogueur, il est difficile d’imaginer vivre sans.

Conclusion

Maintenant que l'utilisation des rapports d'erreurs, des instructions d'impression, des extensions PHPEclipse et du débogueur a été ajoutée à l'ensemble de technologies de débogage de PHP, vous pouvez réduire le nombre de lignes de code par nombre d'erreurs et devenez un codeur PHP plus efficace. Voir

Ressources pour quelques tutoriels PHP sur lesquels vous pouvez tester ces nouvelles compétences.

Télécharger un exemple de code pour le débogage PHP


Documents de référence

Apprendre

  • Vous pouvez vous référer au

    texte original en anglais de cet article sur le site mondial DeveloperWorks.

  • Découvrez comment

    installer Java sur les systèmes Windows et UNIX®.

  • Visitez

    Eclipse.org pour des informations complètes sur la programmation et comment l'utiliser.

  • "

    Getting Started with the Eclipse Platform " (developerWorks, novembre 2002) fournit un historique et un aperçu d'Eclipse, y compris comment l'installer. Détails d'Eclipse et du plugin.

  • Veuillez visiter

    PHPEclipse pour en savoir plus sur l'installation de PHPEclipse et comment l'utiliser.

  • DBG est un moteur de débogage PHP complet, un outil interactif qui aide à déboguer les scripts PHP. Veuillez lire ce tutoriel sur

    Installation et configuration du débogueur.

  • Pour en savoir plus sur Eclipse, visitez les

    Ressources du projet Eclipse sur DeveloperWorks.

  • Pour en savoir plus sur PHP, visitez les

    ressources du projet PHP de DeveloperWorks.

  • Veuillez vous référer au manuel PHP pour plus d'informations sur le

    rapport d'erreurs.

  • Veuillez lire les instructions d'installation de

    PHP et Apache2 sur Linux.

  • Veuillez lire les instructions d'installation de

    PHP et Apache2 sur Windows.

  • Pour une série de didacticiels DeveloperWorks sur l'apprentissage de la programmation PHP, voir "Apprendre PHP, partie 1", Apprendre PHP, partie 2 et Apprenez PHP, partie 3.

  • Veuillez prêter une attention particulière aux événements techniques et webcasts developerWorks.

  • Veuillez visiter la Open Source Zone de DeveloperWorks pour obtenir de riches informations pratiques, des outils et des mises à jour de projets pour vous aider à utiliser la technologie open source. et utilisez-les dans les produits IBM.


Obtenez des produits et des technologies de PHP net pour télécharger la dernière version de PHP
.

  • Veuillez télécharger la dernière version de
    Apache 2
    .

  • Veuillez télécharger la
    technologie Java
    de Sun.

  • Veuillez télécharger la dernière version de
    Eclipse
    sur Eclipse.org.

  • Veuillez télécharger
    PHPEclipse
    depuis Sourceforge. Extrayez Eclipse dans le répertoire d'installation d'Eclipse, puis extrayez PHPEclipse dans le répertoire d'installation d'Eclipse. Lors de l'installation de l'extension, suivez les

    instructions PHPEclipse
  • . Cependant, commentez les lignes où il est nécessaire de charger et de configurer l'extension PHP dans le fichier php.ini. Décommentez ces lignes lorsque vous êtes prêt à utiliser le débogueur.

  • Commandez le SEK gratuit pour Linux
    , cet ensemble de DVD (deux pièces), comprenant des logiciels de DB2®, Lotus®, Rational ® , Tivoli® et WebSphere®, le dernier logiciel d'essai IBM pour Linux.

  • Transformez votre prochain projet de développement open source avec le
    Logiciel d'essai IBM
    , disponible en téléchargement ou sur DVD.



  • Discuter


Participer via les blogs developerWorks
Rejoignez la communauté DeveloperWorks.

À propos de l'auteur



Tyler Anderson est diplômé de l'Université Brigham Young en 2004 avec un diplôme en informatique. Il en est actuellement à son dernier semestre en tant qu'étudiant en master d'ingénierie informatique. Dans le passé, il a travaillé pour DPMG.com en tant que programmeur de bases de données, et il est désormais ingénieur chez Stexar Corporation à Beaverton, Oregon.

Adresse d'origine


Tyler Anderson 2004 年从 Brigham Young 大学毕业,获得计算机科学学位。现在是他作为计算机工程硕士生的最后一学期。过去,他作为数据库程序员为 DPMG.com 工作,现在他是位于 Beaverton, Ore 的 Stexar 公司的工程师。

http://www.ibm.com/developerworks/cn/opensource/os-debug/


Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!

Étiquettes associées:
source:php.cn
Déclaration de ce site Web
Le contenu de cet article est volontairement contribué par les internautes et les droits d'auteur appartiennent à l'auteur original. Ce site n'assume aucune responsabilité légale correspondante. Si vous trouvez un contenu suspecté de plagiat ou de contrefaçon, veuillez contacter admin@php.cn
Tutoriels populaires
Plus>
Derniers téléchargements
Plus>
effets Web
Code source du site Web
Matériel du site Web
Modèle frontal
À propos de nous Clause de non-responsabilité Sitemap
Site Web PHP chinois:Formation PHP en ligne sur le bien-être public,Aidez les apprenants PHP à grandir rapidement!