温馨提示×

怎样调试debian php程序

小樊
48
2026-09-26 08:29:20
栏目: 编程语言

在 Debian 上调试 PHP 程序,通常可以从环境配置、错误显示、日志、调试工具几个方面入手。下面按“从简单到专业”的方式说明。


一、确认 PHP 运行环境

先确认你用的是哪种方式运行 PHP:

php -v

常见运行方式:

  • CLI(命令行):php script.php
  • Apache + mod_php
  • Nginx + PHP-FPM

查看 PHP 配置文件位置:

php --ini

二、开启错误显示(开发环境)

1. 修改 php.ini

通常位置:

/etc/php/8.2/cli/php.ini
/etc/php/8.2/apache2/php.ini
/etc/php/8.2/fpm/php.ini

修改或确认以下配置:

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

重启服务:

# Apache
sudo systemctl restart apache2

# PHP-FPM
sudo systemctl restart php8.2-fpm

三、查看 PHP 错误日志

1. 查看错误日志位置

php -i | grep error_log

常见位置:

/var/log/php_errors.log
/var/log/apache2/error.log
/var/log/nginx/error.log

实时查看:

tail -f /var/log/php_errors.log

四、使用 var_dump / error_log 调试

最简单方式:

var_dump($variable);
exit;

或写入日志:

error_log(print_r($data, true));

五、使用 Xdebug(强烈推荐)

1. 安装 Xdebug

sudo apt update
sudo apt install php-xdebug

2. 配置 Xdebug(示例 php.ini)

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

重启服务后检查:

php -m | grep xdebug

3. 使用编辑器调试

  • VS Code:安装 PHP Debug
  • PhpStorm:直接支持 Xdebug

六、命令行调试(无 Web)

php -d display_errors=1 script.php

或使用 lint 检查语法:

php -l file.php

七、常见问题排查

  • 白屏:一般是致命错误,看日志
  • 权限问题:www-data 无法写文件
  • 依赖问题:用 Composer
composer install

如果你能告诉我:

  • Debian 版本
  • PHP 版本
  • Web 服务器(Apache / Nginx)
  • 是 CLI 还是网页程序

我可以给你更具体的调试步骤。

0 踩