phpEnv Nginx设置目录保护及访问密码认证-php教程-PHP中文网

phpenv 的 nginx 默认不包含 ngx_http_auth_basic_module 模块，需先用 nginx.exe -v | findstr "auth_basic" 确认模块存在；配置时须用绝对路径指定 .htpasswd 文件，内容为 apache 兼容的 md5 格式（如 username:$apr1$...），并确保 location 块嵌套合理以避免 php 脚本被下载。

phpenv nginx设置目录保护及访问密码认证

phpEnv 是 Windows 下的集成环境，自带 Nginx，但它的 Nginx 编译时默认不包含 ngx_http_auth_basic_module 模块——这意味着直接写 auth_basic 会报错：unknown directive "auth_basic"。必须确认模块存在，再配置，否则白改配置、白重启。

检查 phpEnv 自带的 Nginx 是否支持 auth_basic

phpEnv 的 Nginx 通常来自精简编译版本，很多去掉了基础认证模块。不能假设它有。

打开命令行，进入 phpEnv 安装目录下的 Nginx 子目录（如 D:\phpEnv\Nginx\）
执行：nginx.exe -V 2>&1 | findstr "auth_basic"
如果无任何输出，说明模块未编译进二进制；如果有 --add-module=... 含 auth_basic 字样，才可继续
更直接的方式：临时在 nginx.conf 里加一行 auth_basic off;，然后运行 nginx.exe -t —— 若报 unknown directive，就坐实缺失

用绝对路径指定 `auth_basic_user_file`，别信相对路径

phpEnv 的工作目录不固定，nginx.conf 里写 auth_basic_user_file .htpasswd; 很可能找不到文件。Nginx 不会自动按 conf 路径解析，而是按启动时的当前工作目录找——而 phpEnv 启动 Nginx 时 cwd 可能是桌面或 phpEnv 根目录。

Nginx Hosting

通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载

务必使用绝对路径，例如：auth_basic_user_file "D:/phpEnv/Nginx/.htpasswd";
路径中所有斜杠用正斜杠 /，反斜杠 \ 在 Windows 下容易被 Nginx 解析出错
确保该文件存在、Nginx 进程有读取权限（建议放 Nginx 目录下，避免 UAC 拦截）
文件内容格式必须为 username:$apr1$xxx$yyy，不能是明文密码，也不能是 SHA 或 bcrypt（Nginx 只认 Apache 兼容的 MD5/Crypt 格式）

在 location 块中启用认证，注意匹配优先级

phpEnv 默认的 Nginx 配置常把 PHP 处理逻辑写在 location ~ \.php$ 里，而根目录保护若写在 location /，会导致 PHP 脚本被下载而非执行——因为认证触发后，Nginx 会跳过后续的 fastcgi_pass 指令。

正确做法：把 auth_basic 放在最外层的 location，但要确保它不覆盖 PHP 处理逻辑
推荐写法（保护整个站点，但不影响 PHP 执行）：

location / {
    auth_basic "Admin Area";
    auth_basic_user_file "D:/phpEnv/Nginx/.htpasswd";
}
location ~ \.php$ {
    include fastcgi.conf;
    fastcgi_pass 127.0.0.1:9000;
}

如果只保护某个子目录（如 /admin/），用前缀匹配：location ^~ /admin/，避免正则干扰
千万别用 location /admin（没结尾斜杠），它会匹配 /adminer.php 这类文件，导致认证弹窗+PHP 下载双失败

生成 .htpasswd 文件：别依赖系统 htpasswd

Windows 下没有预装 htpasswd，phpEnv 也不自带。用 OpenSSL 或在线工具生成，但要注意格式兼容性。

推荐用 PowerShell 快速生成一行（MD5 格式，Nginx 可识别）：

$pw = 'mypass123'; $user = 'admin'; $salt = -join ((65..90) + (97..122) | Get-Random -Count 8 | % {[char]$_}); "$user`:$(openssl passwd -apr1 -salt $salt $pw)" | Out-File -Encoding ASCII "D:\phpEnv\Nginx\.htpasswd"