怎样开启ubuntu php调试

ubuntu

小樊

2026-10-07 07:58:02

栏目: 编程语言

在 Ubuntu 上开启 PHP 调试，通常有两种常见场景：

开启 PHP 错误显示（基础调试）
使用 Xdebug 进行断点调试（专业调试）

下面分别说明。

一、开启 PHP 错误调试（最简单）

1. 修改 php.ini

找到你的 php.ini（通常是 /etc/php/8.x/cli/php.ini 或 /etc/php/8.x/apache2/php.ini）

php --ini

编辑文件：

sudo nano /etc/php/8.x/apache2/php.ini

修改以下内容：

display_errors = On
display_startup_errors = On
error_reporting = E_ALL
log_errors = On

2. 重启服务

Apache：

sudo systemctl restart apache2

Nginx + PHP-FPM：

sudo systemctl restart php8.x-fpm

二、使用 Xdebug 进行断点调试（推荐）

1. 安装 Xdebug

sudo apt update
sudo apt install php-xdebug

查看是否安装成功：

php -m | grep xdebug

2. 配置 Xdebug（PHP 8.0+）

编辑 Xdebug 配置文件（示例路径）：

sudo nano /etc/php/8.x/mods-available/xdebug.ini

写入：

zend_extension=xdebug

[xdebug]
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1
xdebug.client_port=9003
xdebug.idekey=PHPSTORM

3. 重启 PHP 服务

sudo systemctl restart apache2
# 或
sudo systemctl restart php8.x-fpm

4. 验证 Xdebug

php -i | grep xdebug

三、配合 IDE 使用（以 VS Code 为例）

1. 安装扩展

PHP Debug（by Xdebug）

2. 配置 launch.json

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Listen for Xdebug",
      "type": "php",
      "request": "launch",
      "port": 9003
    }
  ]
}

3. 浏览器触发

访问页面
IDE 打断点
自动进入调试

四、常见问题

❌ Xdebug 不生效

确认 php -m 中有 xdebug
确认 Web 和 CLI 使用的是同一个 PHP

❌ 端口被占用

修改 client_port

如果你告诉我：

Ubuntu 版本
PHP 版本
使用 Apache / Nginx
用 VS Code 还是 PHPStorm

我可以给你精准配置步骤。