Xdebug是PHP的一个扩展，提供了一系列功能来改善开发体验，包括：单步调试，追踪，分析和代码覆盖率分析等功能，目前最新版本为3.4.5

系统版本

Ubuntu 24.04

开发环境

PHP 8.4 - Xdebug
Laravel12
Sail

开发工具

PHPStorm

实现步骤

1. 安装sail

   sail php artisan sail:install
   

2. 发布自定义配置

   sail php artisan sail:publish
   

3. 在.env中添加Xdebug配置

   # ~/project/.env
   ...
   SAIL_XDEBUG_MODE=develop,debug,coverage
   ...
   

4. 在php.ini中添加Xdebug配置

   # ~/project/docker/php8.4/php.ini
   xdebug.mode=${XDEBUG_MODE}
   

5. 启动Sail容器

   sail up -d
   

6. 配置PHPStorm
   6.1 配置CLI解释器
   
   
   
   6.2. 添加服务器
   
   6.3 开启调试侦听
   
   6.4 验证调试器配置
   
   6.5 配置调试端口，填入上一步记下的远程端口，其他配置保持默认即可
   
   6.6 配置DBGp代理
   
7. 安装浏览器插件，在浏览器扩展管理中搜索“Xdebug Helper 不要JetBrains”并点击安装
   
8. 配置IDE key
   
9. 在扩展中激活Debug

10. 在PHPStorm中添加调试配置


11. 添加断点

12. 开始调试
    
    
13. 在浏览器中访问路由http://localhost/test-xdebug，浏览器会弹出调试窗口：
    
    

结语

以上就是在PHPStorm中配置Xdebug的具体实现步骤，欢迎小伙伴们指正~