PHP 调试 - 方式

article/2025/9/28 21:17:55

之前学 Java 的时候,一直使用 IDE 的 console 控制台进行调试。后来搞 PHP 后,习惯在代码里面 echo 和 exit,然后在浏览器刷新看效果,把单步调试、变量值查看等常用的调试方式给忘了。其实通过 IDE 集成的控制台进行调试更高效。

下面的示例都是基于 Windows 下的 LNMP 环境,其安装方式可以 参考这里。

常用调试方式

通过浏览器打印信息进行调试

方法

在代码中添加 echo、var_dump、print_r 和 exit,在浏览器中查看输出。

优缺点

优点:

  • 简单,使用方便,不用安装插件
  • 对于自己写的代码,或比较熟悉的框架,可以这么用

缺点:

  • 对于多分支逻辑,需要加很多代码或尝试多次
  • 对于不熟悉的逻辑,无法反映出完整的执行流程。
  • 有可能将调试语句遗漏在项目中
  • 无法单步执行

技巧

调试时,为了格式化输出变量,往往需要在项目中实现自己的 dump() 函数。利用 Composer,可以全局安装 symfony/var-dumper 包中的 dump() 函数,使所有项目都可以使用,而无需改动项目。

  • 全局安装 symfony/var-dumper 包:
    默认会安装到 ${HOME}/.config/composer 目录
composer global require symfony/var-dumper 
  • 修改 php.ini 文件,执行 PHP 代码之前先 include 指定的文件
auto_prepend_file = ${HOME}/.config/composer/vendor/autoload.php

使用 Xdebug 进行调试

XDebug 是 C/S 结构,其中 Client 是 PHP 中安装的 Xdebug,Server 是 IDE 中安装的插件,使用 DBGP 协议通信。PHP 运行脚本时,通过 Xdebug 插件向 IDE 发送调试信息,并接收 IDE 发过来的控制信号。

需要为 PHP 安装并开启 Xdebug,然后设置 IDE 的 Xdebug 插件,使二者可以通信。

优缺点

  • 支持单步调试和任意变量值的获取
  • 配置复杂,需要 IDE 安装插件
  • 支持跟浏览器的配合,需要请求中携带 XDEBUG_SESSION_START 参数

Web App 调试

对于 web 应用,要开启 Xdebug 调试模式,必须在浏览器发送的请求中添加额外的标志。可以在 GET/POST/Cookie 参数中添加 XDEBUG_SESSION_START=session_name,这样 Xdebug 就明白这个请求需要调试,去连接 IDE。

但每次手工设置也很麻烦,有两种方式简化操作:

  • 使用 IDE 提供的方式。对于 PhpStorm,参考 Debugging PHP Web Applications with Run Debug Configurations。使用时需要配置好 IDE 中的 Web Server,然后设置一个 PHP Web Application,点击 Debug 按钮开始调试,这时 IDE会自动打开浏览器并输好网址,并添加 XDEBUG_SESSION_START=session_name
  • 使用浏览器插件,打开插件的调试开关后,插件可以自动在请求中带上对应的 Cookie。对于 Chrome 可以安装 Xdebug helper。

通过 console 终端进行调试(CLI 方式)

对于非 web 应用,例如定时任务或单元测试,可以直接在控制台进行调试。

PhpStorm 中通过 Alt+F12 快捷键打开命令行终端。但是因为 IDE 中只能显示一个终端,在开启调试后的调试终端会覆盖命令行终端,所以还是单独开一个命令行终端吧(Windows 下可以使用 DOS 窗口或 PowerShell)。

方法及原理

web 应用通过 GET/POST/Cookie 参数标志调试请求,而非 web 应用则通过在命令行终端设置环境变量来开启调试。

两步:

  • 设置环境变量 XDEBUG_CONFIG="idekey=session_name",这个 idekey 需要跟 php.ini 中 Xdebug 部分设置的 idekey 一样。
  • 在命令行终端执行脚本。执行时会唤起 IDE 的 debug 终端,可以单步调试,输出结果实时显示在命令行终端。

这里写图片描述

IDE通常提供快捷操作,对于 PHPStorm 可以参考 Debugging PHP CLI scripts with PhpStorm。

通过 IDE 启动调试后,IDE 会启动 Xdebug 插件监听某个端口(PhpStorm 默认是 9000,但是这跟 PHP-FPM 冲突了,可以改为 9001),获取 PHP 服务器返回的调试信息。

D:\lnmp\php72\php.exe -dxdebug.remote_enable=1 -dxdebug.remote_mode=req -dxdebug.remote_port=9001 -dxdebug.remote_host=127.0.0.1 D:\lihongfeng\workspace\untitled\index.php

设置、查看和释放环境变量

  • Linux
export XDEBUG_CONFIG="idekey=session_name" // 设置环境变量
echo $XDEBUG_CONFIG // 查看环境变量
unset XDEBUG_CONFIG // 删除环境变量
  • Windows
set XDEBUG_CONFIG="idekey=session_name" // 设置环境变量
echo %XDEBUG_CONFIG% // 查看环境变量
set XDEBUG_CONFIG // 查看环境变量
set XDEBUG_CONFIG= // 删除环境变量

http://chatgpt.dhexx.cn/article/L8WdBDc1.shtml

相关文章

使用xdebug调试php详细教程 原创

下载xdebug扩展 将phpinfo()中的信息全部复制到Xdebug中的文本框中,如下图所示:点击“Analyse my phpinfo() output”按钮。 跳转到如下图所示页面,会对本机中的php进行分析,点击“Download php_xdebug-2.7.2-7.2-vc15-x86_64.dll…

Xdebug安装与使用

Xdebug安装与使用 为什么需要Debugger? 很多PHP程序员调试使用echo、print_r()、var_dump()、printf()等,其实对 于有较丰富开发经验的程序员来说这些也已经足够了,他们往往可以在程序执行的过程中,通过输出特定变量的值可以判断程序执行是否…

Git详细教程(五):查看分支、创建分支、合并分支

一、查看分支 查看的git命令如下: git branch 列出本地已经存在的分支,并且当前分支会用*标记 git branch -r 查看远程版本库的分支列表 git branch -a 查看所有分支列表(包括本地和远程,remotes/开头的表示远程分支&#xff09…

git的分支与合并的两种方法

git的分支与合并的两种方法 如何将两个分支合并到一起。就是说我们新建一个分支,在其上开发某个新功能,开发完成后再合并回主线。 1. git merge 咱们先来看一下第一种方法 —— git merge 在 Git 中合并两个分支时会产生一个特殊的提交记录&#x…

Git合并分支代码到主分支的方法总结

目录 一、简介 二、实现步骤 一、简介 在使用Git开发过程中,我们一般都是在develop开发分支上进行开发,应该比较少会在master分支上直接开发的,一般如果开发分支进行了一次大版本的更新并且经过测试后,我们就需要将代码同步到m…

Git整合分支的两种方法——合并(git merge)与变基(git rebase)的区别

转载者总结了下原文的关键句,补充了几个相关链接,得到本文。 文章目录 Git整合分支的两种方法1、合并(git merge)2、变基(git rebase) 用例子理解 合并(git merge)与变基(git rebase)的区别合并&#xff08…

git 分支合并(dev合并到master分支)

前景:在项目开发中,经常会多分支协作开发,所以就会遇到分支合并等问题。以下用例是将dev分支合并到master分支 1. 对当前dev分支的本地代码进行储存 1.1 如当前代码未编辑完,不想提交,即可将当前dev分支的代码暂存 gi…

Git 分支合并代码

Git 分为哪几个区: https://blog.csdn.net/qq_36672905/article/details/82776283 Git的区域分为 工作区、暂存区、本地仓库区 工作区(work directory):一般就是我们项目的根目录。 本地仓库(repository&#xff0…

git将一个分支的提交合并到另一个分支

git将一个分支的提交合并到另一个分支 Git合并指定文件到另一个分支。 经常被问到如何从一个分支合并特定的文件到另一个分支。其实,只合并你需要的那些commits,不需要的commits就不合并进去了。 1. 合并某个分支上的单个commit 首先,用g…

Git分支合并到另外一个分支

注意:不能在分支节点再新建分支节点,及时新建了成功了,分支节点也是基于master去建立的。(已验证) 下面来提一个需求: 需要新建两个分支,一个是test1另外一个是test2,首先在test1上开发&#…

git查看分支、创建分支、合并分支

一、查看的git命令如下: git branch 列出本地已经存在的分支,并且当前分支会用*标记 git branch -r 查看远程版本库的分支列表 git branch -a 查看所有分支列表(包括本地和远程,remotes/开头的表示远程分支) git bran…

git合并分支总结(一看就懂哟)

1.主分支:在本地先拉取最新代码,提交(commit)到本地,推送(push)到云端 --下图是idea中提交到本地,未推送到云端的提示: 2.小分支:在本地先拉取最新代码&…

git如何把其他分支的合并到主分支上,主分支的合并到其他分支上

master:主分支 other:其他分支 首先查看分支 git branch如果分支在主分支上忽略此步,如果不在切换分支 git checkout other在other分支上拉取代码 git pull最重要的一步,拉完代码后,在切换到master分支上&#xff…

git merge合并分支

一、本文是从master分支拉出的two,然后合并回master 1、切换到master分支:git checkout master 2、创建并切换到two分支:git checkout -b two 3、将two分支push到远程仓库(与本地仓库同步):git push ori…

git分支的合并

原文: http://gitbook.liuhui998.com/3_3.html http://gitbook.liuhui998.com/5_3.html 一、如何分支的合并 在git中,可以使用 git merge 和 git rebase 两个命令来进行分支的合并。 git merge 和 git rebase 在大体上都差不多,下文主要以g…

Git提交本地代码至分支及合并分支到总分支

Git提交本地代码至分支 前言一、查看分支二、本地新建分支三、切换到新分支四、创建并切换分支五、将新分支推送到gitlab六、删除分支七、git 提交本地代码至新分支八、将分支代码合并到总分支 前言 git版本控制工具和svn差不多,可选择的远程库有github、gitlab、g…

git怎么合并两个分支

git怎么合并分支代码 1.git 命令 注意: 第一步你得把当前分支合到远程分支去才能有下面的操作 另外我是将develop分支代码合并到release分支去1.推完代码到远程仓库查看本地分支(如果推错分支代码那么请将分支切到刚刚推送上去代码的分支在来进行下面的操作) git branch2.切…

【剑指offer】【java】变态跳台阶

题目 一只青蛙一次可以跳上1级台阶,也可以跳上2级……它也可以跳上n级。求该青蛙跳上一个n级的台阶总共有多少种跳法。 思路 1.这里计算的是跳法数 而不是跳的次数 2.用递归解决 代码 public class Solution {public int JumpFloorII(int target) {if (target…

接了个变态需求:生成 Excel + PDF 导出,用 Java 怎么实现?

一、序言 Excel、PDF的导出、导入是我们工作中经常遇到的一个问题,刚好今天公司业务遇到了这个问题,顺便记个笔记以防下次遇到相同的问题而束手无策。 公司有这么两个需求: 需求一、给了一个表单,让把查出来的数据组装到表单中…

Java面试题目和答案

Java面向对象有哪些特征,如何应用 ​ 面向对象编程是利用类和对象编程的一种思想。万物可归类,类是对于世界事物的高度抽象 ,不同的事物之间有不同的关系 ,一个类自身与外界的封装关系,一个父类和子类的继承关系&…