frankenphp 下 $_server 缺失或不可靠的变量包括：script_filename（为空或指向worker脚本）、document_root（未设置）、path_info（几乎总为空）、https/http_x_forwarded_proto（需配置反代头才可靠）；request_uri可能不包含查询字符串；且$_server在进程生命周期内不刷新，导致环境误判、ip获取错误等问题，应优先使用laravel请求实例方法替代。
FrankenPHP 下 $_SERVER 缺失的常见变量有哪些
FrankenPHP 不是传统 CGI/FPM 模型，它基于 Caddy 的 HTTP/2 与 PHP 线程直连机制，$_SERVER 不再由 Web 服务器（如 Nginx/Apache）填充，而是由 FrankenPHP 自行注入——这意味着部分传统变量根本不会出现，或值为 null/''。最常“消失”的有：
-
$_SERVER['SCRIPT_FILENAME']：FrankenPHP 不走文件系统路径路由，该值通常为空或指向内部 worker 脚本（如vendor/bin/frankenphp-worker.php），不可用于__DIR__推导 -
$_SERVER['DOCUMENT_ROOT']：未设置，FrankenPHP 不依赖文档根概念，静态资源由 Caddy 直接服务 -
$_SERVER['REQUEST_URI']：存在但可能不包含查询字符串（尤其在 Caddy 重写后），且不保证与原始请求完全一致 -
$_SERVER['PATH_INFO']：几乎总是为空，FrankenPHP 默认不解析 PATH_INFO，需显式在 Caddyfile 中启用php_path_info -
$_SERVER['HTTPS']和$_SERVER['HTTP_X_FORWARDED_PROTO']：若未配置反向代理头转发，这两者都不可靠；应改用request()->secure()
为什么不能直接读 $_SERVER 来判断环境
FrankenPHP 启动的是固定线程池，所有请求共享同一进程生命周期，$_SERVER 在首次初始化后就“冻结”了——后续请求不会刷新它。比如你在第一次请求中设置了 $_SERVER['APP_ENV'] = 'local'，第二次请求时这个值还在，但实际环境可能已变。
更危险的是，Caddy 的中间件链（如重写、头注入）可能在 FrankenPHP 读取前就修改了原始请求，导致 $_SERVER 与真实上下文脱节。所以：
- 别在
bootstrap/app.php或服务提供者register()中依赖$_SERVER['HOST']做多租户切换 - 避免用
$_SERVER['REMOTE_ADDR']获取客户端 IP——它可能是 Caddy 的本地地址（如127.0.0.1），应改用request()->ip()并确保 Caddy 配置了trusted_proxies -
$_SERVER['argv']和$_SERVER['argc']在 HTTP 请求中无意义，FrankenPHP 不模拟 CLI 环境
哪些 $_SERVER 变量还能安全用
FrankenPHP 明确保留并动态更新的变量极少，目前稳定可用的只有：
-
$_SERVER['REQUEST_METHOD']：基本可靠，但建议仍用request()->method() -
$_SERVER['SERVER_NAME']：等于 Caddy 配置中的hostname，静态不变 -
$_SERVER['SERVER_PORT']：由 Caddy 监听端口决定，启动后固定 -
$_SERVER['HTTP_*']系列（如HTTP_USER_AGENT,HTTP_ACCEPT）：来自原始请求头，只要 Caddy 没过滤就可用
注意：$_SERVER['HTTP_HOST'] 虽存在，但若 Caddy 启用了 host 匹配或 TLS SNI 路由，它可能被重写，不能用于生成绝对 URL。
迁移时最该检查的三处代码
搜你项目里所有直接读 $_SERVER 的地方，重点盯这三类：
- URL 构建逻辑：把
$_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI']换成request()->fullUrl() - 环境检测：把
if ($_SERVER['APP_ENV'] === 'production')改为读config('app.env')或app()->environment() - 路径推导：把
dirname($_SERVER['SCRIPT_FILENAME'])换成base_path()或public_path()——FrankenPHP 下SCRIPT_FILENAME已无业务意义
真正麻烦的不是变量“少了”，而是某些变量看似存在却长期不变、或被中间层污染。别猜，用 dd(request()->allHeaders(), request()->server()); 在请求中实测一次，比查文档快得多。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
