怎样调试debian php

在 Debian 上调试 PHP，通常分为环境检查、错误日志、运行时调试、性能分析几个层面。下面按“从入门到进阶”的方式说明。

一、先确认基础环境

1. 查看 PHP 是否安装

php -v
which php

如果没装：

sudo apt update
sudo apt install php php-cli

2. 查看 PHP 配置文件位置

php --ini

常见路径：

• CLI：/etc/php/*/cli/php.ini
• Web（Apache/Nginx + FPM）：/etc/php/*/fpm/php.ini

二、开启错误显示（最常用）

1. 修改 php.ini

display_errors = On
error_reporting = E_ALL
log_errors = On

CLI 调试：

php -d display_errors=1 script.php

2. Web 环境注意

• Apache：sudo systemctl restart apache2
• Nginx + PHP-FPM：

sudo systemctl restart php*-fpm
sudo systemctl restart nginx

三、查看错误日志（很重要）

PHP 错误日志

error_log = /var/log/php_errors.log

创建并授权：

sudo touch /var/log/php_errors.log
sudo chown www-data:www-data /var/log/php_errors.log

查看：

tail -f /var/log/php_errors.log

Web 服务器日志

• Apache：/var/log/apache2/error.log
• Nginx：/var/log/nginx/error.log

四、命令行调试（快速）

1. 直接运行

php index.php

2. 打印变量

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

3. 语法检查

php -l file.php

五、使用 Xdebug（专业调试）

1. 安装 Xdebug

sudo apt install php-xdebug

确认：

php -m | grep xdebug

2. 配置 Xdebug（CLI 示例）

/etc/php/*/cli/conf.d/20-xdebug.ini

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

3. IDE 调试

• VS Code：安装 PHP Debug
• PhpStorm：配置 Xdebug + 监听 9003

六、性能与问题定位

1. 查看 PHP 模块

php -m

2. 性能分析（Xdebug 或 Tideways）

xdebug.mode=profile

生成 cachegrind 文件，用：

sudo apt install kcachegrind

3. 内存/超时问题

memory_limit = 256M
max_execution_time = 30

七、常见问题速查

如果你能说明：

• 是 CLI / Apache / Nginx
• 是 报错 / 卡死 / 性能问题

我可以给你更精确的调试步骤。