PHP CLI调试首选var_dump加exit快速中断查看变量，日志用error_log写入/tmp；Web调试用tail-f实时监控错误日志；Xdebug 3.0+只需xdebug.mode=debug和xdebug.client_host；权限与SELinux常导致静默失败。
PHP CLI 脚本直接调试：用 var_dump 和 error_log 最快定位问题
Linux 下调试 PHP 脚本，别急着装 Xdebug——多数 CLI 场景下，var_dump 配合终端输出已足够高效。注意两点：var_dump 默认会格式化输出（换行、缩进），在终端里可能被截断或显示错乱；print_r 不带类型信息，容易误判 null 和空数组。
- 用
var_dump($var); exit;快速中断并查看变量结构，加exit防止后续逻辑干扰判断 - 日志写入推荐
error_log(print_r($var, true), 3, '/tmp/php-debug.log');，避免权限问题（/tmp所有用户可写） - CLI 模式下
display_errors默认关闭，不要依赖浏览器看到错误——必须检查php -i | grep display_errors确认值为On或改用php -d display_errors=On script.php
Web 请求调试：用 tail -f 实时盯住 PHP 错误日志
Apache 或 Nginx + PHP-FPM 组合下，错误通常不打屏，全在日志里。关键不是“怎么开日志”，而是“日志在哪、怎么实时看”。不同安装方式路径差异大：
- Ubuntu/Debian 包安装：错误日志通常在
/var/log/apache2/error.log或/var/log/php7.4-fpm.log（版本号随实际变化） - CentOS/RHEL：常见于
/var/log/httpd/error_log或/var/log/php-fpm/www-error.log - 用
tail -f /var/log/php-fpm/www-error.log启动后，另开终端触发页面请求，错误立刻滚动出现 - 确保
log_level = notice（PHP-FPM 配置）或error_reporting = E_ALL（php.ini），否则低级别警告不会记录
启用 Xdebug 远程调试：只配 xdebug.mode=debug 和 xdebug.client_host
新版 Xdebug（3.0+）配置大幅简化，但很多人卡在旧文档的 remote_enable 上——这个选项已废弃。真正起效的是两个参数：
zend_extension=xdebug.so xdebug.mode=debug xdebug.client_host=127.0.0.1 xdebug.client_port=9003 xdebug.start_with_request=trigger
-
xdebug.mode=debug是开关，不设它，其他全无效 -
xdebug.client_host必须是宿主机 IP（Docker 容器内调试时填host.docker.internal，非localhost） -
xdebug.start_with_request=trigger表示需手动触发（如 URL 加?XDEBUG_SESSION_START=1），避免全量请求都连调试器拖慢响应 - 验证是否加载成功：运行
php -m | grep xdebug，再执行php -i | grep xdebug.mode看输出是否为debug
调试时文件权限和 SELinux 常被忽略
明明配置全对，日志不写、Xdebug 连不上、file_put_contents 失败——十次有七次是权限或 SELinux 拦的。尤其 CentOS/RHEL 系统默认开启 SELinux，它会阻止 PHP 进程访问非标准路径（比如你把日志放到 /home/www/logs/）。
立即学习“PHP免费学习笔记（深入）”；
- 先确认 PHP 进程用户：
ps aux | grep php-fpm看 worker 进程跑在哪个用户下（常为www-data或apache或nginx） - 给日志目录赋权：
chown -R www-data:www-data /var/log/myapp/ && chmod 755 /var/log/myapp/ - SELinux 下临时放行：
setsebool -P httpd_can_network_connect 1（允许 PHP-FPM 连 Xdebug）、chcon -R -t httpd_log_t /var/log/myapp/（标记日志目录类型） - 别信
chmod 777——它解决不了 SELinux 限制，反而埋下安全坑
