debian php如何开调试

在 Debian 上给 PHP 开调试，常见有 两种场景：
1️⃣ 开 PHP 错误调试（看报错）
2️⃣ 用 Xdebug 做断点调试（IDE 调试）

下面分别说。

一、开启 PHP 错误调试（最常用）

1. 找到 php.ini

php --ini

一般是：

/etc/php/8.2/cli/php.ini        # 命令行
/etc/php/8.2/apache2/php.ini    # Apache
/etc/php/8.2/fpm/php.ini        # Nginx + PHP-FPM

2. 修改 php.ini

display_errors = On
display_startup_errors = On
error_reporting = E_ALL
log_errors = On
error_log = /var/log/php_errors.log

3. 重启服务

# Apache
systemctl restart apache2

# Nginx + PHP-FPM
systemctl restart php8.2-fpm

二、使用 Xdebug（推荐开发用）

1. 安装 Xdebug

sudo apt update
sudo apt install php-xdebug

2. 配置 Xdebug（PHP 8.0+）

编辑：

/etc/php/8.2/mods-available/xdebug.ini

示例（本地调试）：

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

3. 启用并重启

sudo phpenmod xdebug
sudo systemctl restart apache2   # 或 php8.2-fpm

4. IDE 配置（简要）

• VS Code：装 PHP Debug
• PHPStorm：
  • Languages → PHP → Debug
  • 端口 9003
  • 打断点 → 浏览器访问

三、命令行快速调试

php -d display_errors=1 script.php

四、常见坑

✅ 改错 php.ini（cli / fpm 不是一个）
✅ 没重启服务
✅ Xdebug 版本和 PHP 不匹配

如果你告诉我：

• 用的是 Apache 还是 Nginx
• PHP 版本
• 是想 看报错 还是 断点调试

我可以给你精确配置。