Debian PHP代码调试技巧

一、基础配置与工具

1. 错误报告与日志

   • 开发环境：在 php.ini 中设置 error_reporting=E_ALL | E_STRICT 和 display_errors=On，直接显示错误。
   • 生产环境：设置 display_errors=Off，启用 log_errors=On 并指定日志路径（如 /var/log/php_errors.log），避免敏感信息泄露。

2. Xdebug 安装与配置

   • 安装：sudo apt-get install php-xdebug。
   • 配置 php.ini：添加以下内容（根据 PHP 版本调整路径）：

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

     重启 Apache/Nginx/PHP-FPM 生效。
   • IDE 集成：在 PhpStorm/VS Code 中配置 Xdebug 监听端口（默认 9003），设置断点即可调试。

二、常用调试技巧

1. 代码级调试

   • 打印变量：用 var_dump($variable) 或 print_r($array) 查看变量值和结构。
   • 中断执行：用 die() 或 exit() 强制停止代码执行，定位问题位置。
   • 异常捕获：用 try-catch 块捕获异常，避免程序崩溃。

2. 性能与复杂度分析

   • 使用 Blackfire 或 XHProf 分析函数调用耗时、内存占用，优化性能瓶颈。

3. 环境隔离

   • 开发与生产环境分离配置，避免生产环境直接显示错误。

三、进阶工具与实践

• 日志记录：用 error_log() 函数或 Monolog 库记录关键信息，便于追踪问题。
• 命令行调试：通过 php -d display_errors=1 script.php 直接运行脚本并显示错误。

参考来源：