phpEnv不支持PHP_AUTH_USER/PW自动注入，因其采用Nginx+PHP-FPM架构，而该机制仅在Apache模块模式下有效；Nginx默认剥离Authorization头，需手动配置透传或由Nginx接管Basic认证。
phpEnv 本身不支持 PHP 的和自动注入机制 —— 因为它默认以 CGI/FastCGI 模式运行 PHP，而该机制仅在 Apache 模块（mod_php）下有效。
为什么 phpEnv 下直接用 header() 发送 WWW-Authenticate 无效
你在 phpEnv 中写类似这样的代码：
会发现浏览器根本不弹登录框，或者始终进不到
分支。原因很直接：
phpEnv 使用的是 Nginx + PHP-FPM 架构，不是 Apache + mod_php
、
这些变量由 Apache 在模块模式下自动解析 Authorization 头并注入
，Nginx 不做这件事
Nginx 默认会剥离 Authorization 头（出于安全考虑），除非显式配置透传
phpEnv 中启用 HTTP Basic 认证的正确做法
必须让 Nginx 接管认证逻辑，PHP 只负责业务。这是最稳定、也唯一能落地的方式：
立即学习
“
PHP免费学习笔记（深入）
”；
编辑 phpEnv 对应站点的 Nginx 配置文件（通常在
）
在
块内添加
和
生成
文件（可用
命令或在线工具）
确保 Nginx 能读取该文件路径（注意 Windows 权限和反斜杠转义）
示例配置片段：
PHP 8.5.5
PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑，通过深度错误修复、底层性能微调以及安全加固，旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范，不包含破坏性变更。
下载
⚠️ 注意：
必须写绝对路径；Windows 下路径分隔符建议用正斜杠或双反斜杠
如果非要 PHP 层解析 Authorization 头（不推荐但可行）
你得手动从
或
中提取并解码 Base64 凭据：
Nginx 需先透传 Authorization 头：在 server 或 location 块中加
和
（视实际代理方式）
部分 Windows 环境下
为空，需改用
并检查
键
Basic 认证字符串形如
，需用
解出
密码比对必须用
（若存哈希）或恒定时间比较函数（防时序攻击）
简短示意：
容易被忽略的关键点
很多人卡在最后一步：Nginx 配置 reload 后没生效。常见原因包括：
phpEnv 控制面板里「重启 Nginx」按钮实际只发了 soft-reload，未重载 vhost 配置 —— 建议手动执行
或完全停止再启动
文件编码是 UTF-8 无 BOM，否则 Nginx 可能解析失败
phpEnv 的 Nginx 版本较老（如 1.14），不支持某些新指令，
路径中不要含中文或空格
浏览器缓存了失败的认证状态，换隐身窗口或清空「HTTP 认证缓存」再试（Chrome 地址栏输
→ 勾选「密码和表单数据」）
PHP_AUTH_USERPHP_AUTH_PW$_SERVER['PHP_AUTH_USER']PHP_AUTH_USERPHP_AUTH_PW$_SERVERphpEnv\nginx\vhosts\your-site.conflocationauth_basicauth_basic_user_file.htpasswdhtpasswdlocation / {
auth_basic "Restricted Area";
auth_basic_user_file "D:/phpEnv/nginx/.htpasswd";
# 其他原有配置...
}auth_basic_user_file$_SERVER['HTTP_AUTHORIZATION']getallheaders()fastcgi_pass_request_headers on;proxy_pass_request_headers on;$_SERVER['HTTP_AUTHORIZATION']getallheaders()AuthorizationBasic dXNlcjpwYXNzbase64_decode()user:passpassword_verify()$headers = getallheaders();
if (isset($headers['Authorization']) && strpos($headers['Authorization'], 'Basic ') === 0) {
$cred = base64_decode(substr($headers['Authorization'], 6));
list($user, $pass) = explode(':', $cred, 2);
if ($user === 'admin' && hash_equals('5e884898da28047151d0e56f8dc6292773603d0d6aabbdd62a11ef721d1542d8', $pass)) {
// 允许访问
return;
}
}
header('WWW-Authenticate: Basic realm="Login Required"');
http_response_code(401);
exit;nginx -s reload.htpasswdauth_basic_user_filechrome://settings/clearBrowserData