Ubuntu怎么调试PHP代码

ubuntu

小樊

2026-09-04 13:32:33

栏目: 编程语言

在 Ubuntu 上调试 PHP 代码，常见方式有日志调试、Xdebug 断点调试、命令行调试等。下面按“从简单到专业”给你一套实用方案。

一、最基础：查看错误和日志（先保证能看见错误）

1. 打开 PHP 错误显示（开发环境）

编辑 php.ini（位置通常是 /etc/php/8.x/cli/php.ini 或 /etc/php/8.x/apache2/php.ini）：

display_errors = On
error_reporting = E_ALL
log_errors = On

重启服务：

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

2. 快速调试函数

var_dump($var);
print_r($var);
exit;

二、命令行调试（最快）

适合 CLI 脚本：

php -l file.php      # 语法检查
php file.php         # 直接运行

三、使用 Xdebug（推荐，断点调试）

1. 安装 Xdebug

sudo apt update
sudo apt install php-xdebug

确认：

php -m | grep xdebug

2. 配置 Xdebug（php.ini）

示例（PHP 8.x）：

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

重启：

sudo systemctl restart apache2

3. 用 VS Code 调试

安装扩展：PHP Debug
launch.json 示例：

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

浏览器访问页面，VS Code 打断点即可

四、Web 环境常用组合

Apache + PHP
Nginx + PHP-FPM
Docker + PHP + Xdebug（最干净）

五、进阶（不常用）

phpdbg（命令行断点）

phpdbg -e file.php

六、调试建议

✅ 开发环境开 Xdebug
❌ 生产环境关 Xdebug（严重影响性能）
✅ 用日志 + 断点结合

如果你告诉我：

用的是 Apache / Nginx / Docker
是 Web 项目还是 CLI 脚本
用 VS Code / PHPStorm

我可以直接给你针对性配置步骤。