PHP调试配置可复用：一、PHPStorm中保存调试配置为共享模板；二、分离Xdebug配置至独立ini文件并通过include切换；三、Docker Compose中固化Xdebug环境变量与路径映射；四、phpdbg导出变量快照与调用栈供离线分析。
如果您在PHP开发中频繁切换调试环境，手动重复配置Xdebug或PHPStorm等工具的调试参数会降低效率。以下是保存和复用PHP调试会话配置的具体方法：
一、保存IDE中的调试配置为模板
主流PHP IDE（如PHPStorm）支持将已配置的调试运行配置导出为可复用的模板，避免每次新建项目时重新设置断点监听端口、路径映射等参数。
1、在PHPStorm中点击顶部菜单栏的 Run → Edit Configurations…。
2、在左侧列表中选中当前有效的PHP Web Page或PHP Script调试配置。
立即学习“PHP免费学习笔记（深入）”；
3、点击右上角的“Save as Template”按钮，并为模板命名，例如Standard_Xdebug_v3。
4、勾选“Share template”选项，使该模板对所有新项目生效。
二、导出并复用Xdebug配置文件
Xdebug的启用状态、远程主机、端口、IDE密钥等参数集中定义在php.ini中；通过分离配置块并使用include机制，可实现多环境快速切换。
1、在php.ini末尾添加：include="/path/to/xdebug_dev.ini"。
2、创建独立配置文件xdebug_dev.ini，内容包含：xdebug.mode=debug、xdebug.client_host=127.0.0.1、xdebug.client_port=9003、xdebug.idekey=PHPSTORM。
3、为测试环境另建xdebug_test.ini，修改client_host为测试服务器IP，并调整idekey为TESTIDE。
4、切换环境时仅需修改php.ini中的include路径，然后重启PHP服务。
三、使用Docker Compose固化调试配置
在容器化开发中，将Xdebug配置与PHP镜像绑定，配合IDE自动识别，可实现跨机器一致的调试会话复用。
1、在docker-compose.yml的PHP服务下添加环境变量：XDEBUG_MODE=debug、XDEBUG_CLIENT_HOST=host.docker.internal、XDEBUG_CLIENT_PORT=9003。
2、挂载自定义php.ini文件到容器内/usr/local/etc/php/conf.d/docker-xdebug.ini路径。
3、在PHPStorm中配置Deployment映射时，启用"Use path mappings"，并确保容器内路径与本地项目路径严格对应。
4、首次成功调试后，PHPStorm自动生成.idea/workspace.xml中的serverConfig节点，该节点含主机名、端口、路径映射规则，可直接复制到其他项目中复用。
四、序列化PHP调试上下文至文件
在命令行调试（如使用phpdbg）时，可通过脚本捕获当前断点、变量快照及执行栈，生成可加载的调试会话文件。
1、在phpdbg交互模式中执行：set exec -c /tmp/debug_session.php，指定待调试脚本。
2、触发断点后，输入命令：dump -v > /tmp/session_vars.json，导出变量状态。
3、使用bt > /tmp/stack_trace.txt保存调用栈信息。
4、编写PHP解析脚本读取session_vars.json，调用var_dump(json_decode(file_get_contents(...)))还原关键变量值用于离线分析。
