ThinkPHP在Linux下的调试技巧有哪些

Linux下 ThinkPHP 调试技巧

一 基础环境与权限

• 确认运行环境：在服务器上执行php -v检查版本，按需安装常用扩展（如php-fpm、php-mysql、php-mbstring、php-xml、php-curl），确保与项目要求一致。
• Web 服务与重写：
  • Nginx 示例：
    • location ~ .php$：使用 fastcgi_pass 指向 127.0.0.1:9000 或 unix:/var/run/php/phpX.Y-fpm.sock；
    • 开启 PATH_INFO：将 SCRIPT_FILENAME 指向实际 PHP 文件，PATH_INFO 传入路径信息；
    • 路由回退：使用 try_files $uri $uri/ /index.php?$query_string;。
  • Apache：启用 mod_rewrite 并确保 .htaccess 的 RewriteRule 正确。
• 目录权限：确保 Runtime/ 可写（开发环境可临时设为777，生产环境请改为更安全权限并考虑将 RUNTIME_PATH 移到非 Web 目录）。
• URL 重写要点：ThinkPHP 为单入口，需正确配置重写规则，否则路由无法到达入口文件。

二 开启调试模式与页面 Trace

• 入口文件开启：在 index.php 定义 define(‘APP_DEBUG’, true);；上线前关闭或设为 false。
• 调试模式收益：开启详细日志、关闭模板缓存（模板修改即时生效）、记录 SQL、关闭字段缓存、严格检查文件大小写（提前暴露 Linux 大小写问题）、页面 Trace 辅助定位。
• 页面 Trace 配置：
  • 全局开关：‘SHOW_PAGE_TRACE’ => true；
  • 自定义标签：‘TRACE_PAGE_TABS’ => array(‘base’,‘file’,‘think’,‘error’,‘sql’,‘debug’)；
  • 运行时间/性能：可开启 ‘SHOW_RUN_TIME’、‘SHOW_ADV_TIME’、‘SHOW_DB_TIMES’、‘SHOW_USE_MEM’ 等面板查看关键指标。
• 应用状态：通过 ‘APP_STATUS’ => ‘debug’|‘test’ 加载对应环境的配置文件（如 debug.php/test.php），便于分离开发与测试配置。

三 日志与 SQL 跟踪

• 日志配置：
  • 部署模式也记录日志：‘LOG_RECORD’ => true；
  • 记录级别：‘LOG_LEVEL’ => ‘EMERG,ALERT,CRIT,ERR,WARN,NOTICE,INFO,DEBUG’（其中 SQL 级别仅在调试模式生效）。
• 手动记录：
  • 内存记录：Log::record(‘msg’, ‘WARN’)（请求结束自动写入）；
  • 实时写入：Log::write(‘msg’, ‘WARN’)（不受级别限制，适合关键告警）。
• SQL 调试：
  • 获取最近 SQL：M(‘User’)->getLastSql()；
  • 获取数据库错误：M(‘User’)->getDbError()；
  • 性能打点：使用 G(‘begin’); … G(‘end’); 计算区间耗时（秒）与内存（KB），定位慢点。

四 变量输出与断点调试

• 变量输出：使用框架友好的 dump($var, $echo, $label, $strict) 替代 var_dump/print_r，便于在浏览器直观查看结构与类型。
• Xdebug + IDE 断点调试（以 PhpStorm 为例）：
  • 安装并启用 Xdebug，在 php.ini 配置 xdebug.remote_port；
  • PhpStorm 设置中把调试端口与 php.ini 保持一致；
  • 新建项目、配置服务器与索引文件，启动调试会话（如设置断点后访问对应 URL），即可单步、观察变量与调用栈。

五 常见问题快速定位清单

• 路由 404/白屏：检查 Nginx try_files 或 Apache .htaccess 是否将请求转发到 index.php；确认 PATH_INFO 正确传递。
• 权限错误：确认 Runtime/ 及子目录可写；必要时调整 RUNTIME_PATH 到非 Web 可写目录。
• SQL 报错或无数据：用 getLastSql()/getDbError() 立即查看执行语句与错误；在调试模式或配置 LOG_RECORD/LOG_LEVEL 下查看 SQL 日志。
• 页面 Trace 不显示：确认 APP_DEBUG = true 且 SHOW_PAGE_TRACE = true；如使用 APP_STATUS，确保对应配置文件已加载。
• 大小写/路径问题：Linux 环境开启调试模式后会进行严格文件大小写检查，文件名与类名大小写不一致会直接暴露。
• 性能瓶颈：用 G(‘begin’)/G(‘end’) 对关键代码段打点，定位耗时与内存消耗。