Ubuntu上PHP代码如何调试

在Ubuntu上调试PHP代码

在Ubuntu环境下调试PHP代码，其实并没有想象中那么复杂。核心思路通常是借助Xdebug扩展，再配合一款顺手的集成开发环境（IDE），比如Visual Studio Code或者PhpStorm。下面，我们就来拆解一下具体的设置和调试步骤，整个过程清晰明了，跟着做就行。

方法一：使用Visual Studio Code和Xdebug

对于喜欢轻量级、高定制化工具的开发者来说，Visual Studio Code（VSCode）搭配Xdebug是个绝佳组合。具体怎么操作呢？我们一步步来看。

1. 安装Xdebug

   万事开头先安装。打开终端，运行下面这两条命令，更新软件包列表并安装Xdebug扩展：

   sudo apt-get update
   sudo apt-get install php-xdebug

2. 配置Xdebug

   安装好了，还得告诉PHP怎么用它。这就需要配置php.ini文件。首先，用下面的命令找到你的php.ini文件在哪：

   php --ini

   找到文件后，用编辑器打开它，在末尾添加以下几行核心配置：

   zend_extension=xdebug.so
   xdebug.mode=debug
   xdebug.client_host=127.0.0.1
   xdebug.client_port=9003
   xdebug.start_with_request=yes

   添加完成后，记得保存并关闭文件。

3. 重启Web服务器

   配置生效的关键一步，就是重启你的Web服务器。根据你用的是Apache还是Nginx，选择对应的命令执行：

   sudo systemctl restart apache2

   或者

   sudo systemctl restart nginx

4. 安装Visual Studio Code扩展

   接下来，转到VSCode的战场。在扩展市场里，搜索并安装这两个必备插件：

   • PHP Intelephense：提供强大的代码智能感知和导航。
   • PHP Debug：这是连接VSCode和Xdebug的桥梁。

5. 配置Visual Studio Code

   插件装好，还得进行最后一步对接配置。在你的项目根目录下，找到（或创建）.vscode/launch.json文件，然后把下面的配置粘贴进去：

   {
     "version": "0.2.0",
     "configurations": [{
       "name": "Listen for Xdebug",
       "type": "php",
       "request": "launch",
       "port": 9003,
       "pathMappings": {
         "/var/www/html": "${workspaceFolder}"
       }
     }]
   }

   这里有个细节需要注意：pathMappings里的远程路径（/var/www/html）需要根据你服务器的实际项目路径进行调整，确保它能和本地的${workspaceFolder}正确对应上。

6. 调试代码

   大功告成，现在可以开始享受调试的乐趣了。在VSCode里打开你的PHP文件，在想暂停的代码行左侧点击设置断点。然后，点击左侧活动栏的调试图标，再点击绿色的“开始调试”按钮。当程序运行到你设置的断点时，执行就会自动暂停。这时，变量值、调用堆栈等信息一目了然，排查问题自然得心应手。

方法二：使用PhpStorm和Xdebug

如果你是一位追求高效、依赖强大IDE的PHP开发者，那么PhpStorm无疑是专业之选。用它来搭配Xdebug，调试体验会更加流畅。

1. 安装Xdebug

   这一步和上面完全一样，参照方法一的第1步，在终端里安装Xdebug扩展即可。

2. 配置Xdebug

   同样，配置php.ini文件的步骤也和方法一的第2步一致，确保Xdebug被正确启用和配置。

3. 重启Web服务器

   别忘了，修改配置后必须重启Web服务器（Apache或Nginx），让改动生效。

4. 配置PhpStorm

   打开PhpStorm，进入File > Settings > Languages & Frameworks > PHP > Servers。点击+号添加一个新服务器，填写名称、主机名（通常是localhost）和端口（如80）。关键是务必勾选Use path mappings，并正确设置你项目的本地路径与服务器上远程路径的映射关系。

5. 配置调试器

   接着，转到File > Settings > Languages & Frameworks > PHP > Debug。在这里，确保Xdebug的相关选项是启用的，并且检查调试端口（默认9003）是否与php.ini中的设置一致。

6. 调试代码

   配置完毕，调试就很简单了。在PhpStorm中打开目标PHP文件，点击行号区域设置断点。然后，点击工具栏上的调试图标，并启动调试。当代码执行到断点处时，程序会暂停，IDE下方会自动弹出调试工具窗口，所有的变量状态和执行流程都清晰可见。

总的来说，无论你选择灵活轻便的Visual Studio Code，还是功能全面的PhpStorm，只要按照上述步骤配置好Xdebug，在Ubuntu上调试PHP代码都会变得非常直观和高效。关键在于确保每一步的配置准确无误，尤其是路径映射和端口设置，这两点往往是成功连接调试器的关键所在。