ubuntu php如何实现远程调试
在Ubuntu上通过Xdebug实现PHP远程调试:先安装php-xdebug,再配置php.ini中xdebug.mode=debug、client_host(服务器IP)、client_port(默认9003)和idekey(如PHPSTORM)。重启Apache或Nginx及PHP-FPM后,在IDE中设置相同idekey并启动监听,然后在浏览器或命令
在Ubuntu上做PHP远程调试,Xdebug是绕不开的工具。今天就展开聊聊安装和配置的完整流程,整个操作其实很清晰,按下面几步走就能搞定。

第一步:安装Xdebug
打开终端,执行以下命令安装Xdebug:
sudo apt-get update
sudo apt-get install php-xdebug
装好之后,需要进入关键环节——配置。
第二步:配置Xdebug
找到php.ini文件。它的具体位置取决于你用的PHP版本和运行方式。命令行版本通常位于/etc/php/{php_version}/cli/php.ini,PHP-FPM版本则在/etc/php/{php_version}/fpm/php.ini。把{php_version}替换成你实际的PHP版本号,比如7.4。
sudo nano /etc/php/{php_version}/cli/php.ini
在文件末尾添加以下配置:
zend_extension=xdebug.so
xdebug.mode=debug
xdebug.client_host=<你的本地IP地址>
xdebug.client_port=9003
xdebug.idekey=<你的IDE密钥>
这里有两个占位符需要注意:<你的本地IP地址>要填你开发机的IP,<你的IDE密钥>填你IDE里设置的密钥(比如PHPStorm用的那个)。这些参数设置好之后,Xdebug就能在你请求远程服务器时自动启动调试会话。
第三步:重启Web服务器
配置保存后,必须重启服务器才能生效。
如果用的是Apache:
sudo systemctl restart apache2
如果用的是PHP-FPM加Nginx的组合:
sudo systemctl restart php{php_version}-fpm
sudo systemctl restart nginx
别忘了把{php_version}换成你的具体版本号。
第四步:配置IDE
以PHPStorm为例,打开设置找到调试器配置,新建一个Xdebug调试配置,把前面在php.ini里设置的idekey填进去。这样IDE和Xdebug就能通过密钥对上了。
第五步:开始远程调试
一切就绪后,当你访问远程服务器上的PHP页面时,Xdebug会自动触发调试会话。在IDE里你可以像本地调试一样设置断点、单步执行、查看变量,体验和本地开发几乎无异。
最后补充一点:以上步骤适用Ubuntu系统上的PHP CLI和PHP-FPM环境。如果Web服务器用的是Apache或Nginx,配置文件路径和重启命令可能需要相应调整。
IntelliJ IDEA 是 JetBrains 推出的专业集成开发环境,重点服务于 Java、Kotlin 与 JVM 项目开发。软件集成代码补全、静态检查、重构、调试、测试、版本控制及构建工具,并可借助插件扩展语言和框架支持。
JetBrains PyCharm 是面向 Python 开发者的集成开发环境,提供智能补全、代码检查、重构、调试、测试、版本控制及虚拟环境管理功能。Mac 版兼容 Intel 与 Apple 芯片,核心功能可免费使用。
JetBrains WebStorm 是面向 JavaScript、TypeScript 和现代 Web 技术的专业集成开发环境,可智能理解项目结构,提供代码补全、重构、错误检查、运行调试、测试及 Git 工具。
JetBrains IntelliJ IDEA 是以 Java、Kotlin 和 JVM 项目为核心的专业集成开发环境,提供智能补全、代码检查、安全重构、调试、测试、版本控制及构建工具集成。统一发行版的核心功能可免费用于商业和非商业项目,
PhpStorm 是 JetBrains 面向 PHP 与现代 Web 开发打造的专业集成开发环境,提供代码补全、静态检查、重构、调试、测试、数据库、版本控制及前端语言支持。Windows 用户可直接下载安装程序,
PyCharm 是 JetBrains 推出的 Python 集成开发环境,提供智能代码补全、错误检查、重构、调试、测试、Git、终端及 Jupyter Notebook 支持。统一版安装后可体验 30 天 Pro 功能,













