PHP在CLI和Web模式下实为两个平行宇宙：环境变量（如$_SERVER）、配置文件、生命周期、时区、超时及内存限制均不同，需分别配置与调试。
PHP在命令行（CLI）和网页（Web）两种模式下，看似跑同一份代码，实则活在两个平行宇宙里——变量、配置、生命周期、甚至时间感都不同。很多“本地能跑、线上崩”“浏览器正常、定时任务报错”的奇怪BUG，根源就在这里。
$_SERVER 和环境变量根本不是一回事
Web模式下，$_SERVER 是 Web 服务器（如 Nginx/Apache）注入的请求上下文数据，比如 $_SERVER['HTTP_HOST']、$_SERVER['REMOTE_ADDR']、$_SERVER['SERVER_ADDR']，这些在 CLI 下全不存在，直接读会触发 Undefined index 警告或返回 null。
CLI 模式更信任 getenv() 或系统命令：
- 获取当前用户名：用
getenv('USER') ?: exec('whoami')，别硬写$_SERVER['USER'] - 获取本机 IP：
$_SERVER['SERVER_ADDR']在 CLI 下永远为空；改用exec('hostname -I | awk \'{print $1}\')（Linux）或解析gethostbyname(gethostname())并注意 /etc/hosts 映射陷阱 - 读取自定义环境变量：CLI 下 $_ENV 默认不自动填充，需在 php.ini 中设
variables_order = "EGPCS"，或直接用getenv('MY_ENV')更稳妥
配置文件完全独立，openssl、xdebug 都可能只活一半
CLI 和 Web 使用的 php.ini 不是同一个文件。Ubuntu/Debian 下常见路径：
立即学习“PHP免费学习笔记（深入）”；
- CLI：/etc/php/8.2/cli/php.ini
- Apache：/etc/php/8.2/apache2/php.ini
- PHP-FPM：/etc/php/8.2/fpm/php.ini
这意味着：
- 你在 Apache 的 php.ini 里打开了
extension=openssl，但composer install仍报 SSL 握手失败？——因为 composer 走 CLI，得去 cli/php.ini 里也开一遍 - Xdebug 在浏览器里能断点，命令行
php artisan tinker却不生效？——检查php --ini加载的是哪个 ini，再确认里面是否启用zend_extension=xdebug且xdebug.mode=debug - 用
php -m查扩展，用php -i | grep 'Loaded Configuration File'锁定实际生效的配置路径
超时、内存、时区，全靠手动对齐
Web 环境默认有 max_execution_time = 30，超时就 500；CLI 默认不限时，脚本能跑一整天——这既是优势也是隐患。
其他关键差异：
-
时区：Web 可能继承系统或 Apache 设置，CLI 几乎总是空的。务必在脚本开头加
date_default_timezone_set('Asia/Shanghai'); -
内存限制：CLI 的
memory_limit常比 Web 环境宽松，但批量处理大文件时仍可能爆掉，建议显式调高：ini_set('memory_limit', '512M'); -
输出缓冲：CLI 默认关闭
output_buffering，echo 立即可见；Web 下常开启，导致var_dump不立刻输出，调试时记得ob_flush(); flush(); -
session 和 $_COOKIE：CLI 下
$_SESSION、$_COOKIE全是空数组，它们依赖 HTTP 请求头，而 CLI 没有请求
调试必须分环境验证
别信“我在浏览器里测过了”。每个 BUG 都要分别在两个环境里复现并对比：
- 查 CLI 实际配置：
php --ini、php -i | grep -E "(max_execution_time|memory_limit|error_log|date.timezone)" - 查 Web 实际配置：建个
info.php，内容为<?php phpinfo(); ?>，浏览器访问后搜索对应项 - 统一入口判断模式：
if (php_sapi_name() === 'cli') { /* CLI 专用逻辑 */ } else { /* Web 专用逻辑 */ } - 日志路径别混用：CLI 的
error_log默认不写到 Web 的日志目录，用php -d error_log=/tmp/cli.log script.php强制指定更可靠
