phpEnv如何配置Nginx解决FastCGI Sent in Stderr报错-php教程-PHP中文网

“Primary script unknown”错误90%因SCRIPT_FILENAME路径不匹配：需在location ~ .php$块中显式添加fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;，确保root定义在server级、php-fpm用户有目录读取权限，并注意Windows/WSL/Docker路径一致性。

phpenv如何配置nginx解决fastcgi sent in stderr报错

phpEnv 下 Nginx 报 FastCGI sent in stderr: "Primary script unknown"，90% 是 SCRIPT_FILENAME 路径没对上，不是 PHP 没装好、也不是端口不通。

nginx 配置里 `SCRIPT_FILENAME` 必须指向真实文件路径

phpEnv 默认用 fastcgi_params 文件，但它不包含 SCRIPT_FILENAME —— 这个关键参数得手动补上。否则 nginx 传给 php-fpm 的脚本路径是空或错的，php-fpm 根本找不到 index.php。

打开你的 nginx server 块（比如 phpenv/nginx/conf/vhost/your-site.conf）
在 location ~ \.php$ { ... } 块内，确保有这行：
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
不要写成 /scripts$fastcgi_script_name 或硬编码路径（如 /wwwroot/...），$document_root 必须由当前 server 或 location 的 root 指令定义出来
如果 root 写在 location / 里，但没写在 location ~ \.php$ 里，$document_root 在 PHP 块里可能为空——最稳妥是把 root 提到 server 级，或显式复制进 PHP location

phpEnv 的 php-fpm 用户权限必须能读取网站目录

phpEnv 启动的 php-fpm 默认用 www 用户，但 Windows 上没有这个用户，Linux/macOS 上若网站目录属主不是 www（或你改过的用户），就会因权限拒绝导致“脚本未知”。

查当前 php-fpm 进程用户：
ps aux | grep php-fpm | grep -v grep，看输出里 USER 列是什么
检查网站根目录权限：
ls -ld /path/to/your/webroot，确认该目录可被 php-fpm 用户读取（至少 r-x 对目录，r-- 对 .php 文件）
修改 php-fpm 用户（以 Linux 为例）：
编辑 phpenv/php/etc/php-fpm.d/www.conf，改这两行：
user = www → 改成 user = your_username
group = www → 改成 group = staff（macOS）或 www-data（Ubuntu）
改完重启：
phpenv stop php-fpm && phpenv start php-fpm

Windows 下路径分隔符和盘符容易出错

phpEnv 在 Windows 上跑时，$document_root 展开后可能是 C:\www\site\，但 php-fpm（尤其旧版）只认正斜杠 /，且对盘符大小写敏感；更麻烦的是，Windows 的 UNC 路径或长路径嵌套会直接让 php-fpm 返回“unknown”。

Nginx Hosting

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

下载

强制统一用正斜杠：
把 root C:\www\myapp; 改成 root /c/www/myapp;（注意是 /c/ 不是 C:/）
避免深层嵌套路径：
别用 C:\Users\Name\Documents\phpEnv\www\project\public 这种，移到 C:\www\project 级别
如果用了 alias（比如映射 /admin 到子目录），$document_root 不生效，必须显式写死：
fastcgi_param SCRIPT_FILENAME /c/www/admin/public$fastcgi_script_name;

Docker 或 WSL 环境要特别注意路径映射一致性

phpEnv 若跑在 WSL 或 Docker 容器里，宿主机路径和容器内路径不一致时，$document_root 在 nginx 看是 /var/www/html，但 php-fpm 实际挂载的是 /mnt/c/www，两者对不上就必然报错。

确认 nginx 和 php-fpm 看到的路径完全一致：
在 nginx 配置里写 root /var/www/html;，就在 php-fpm 的 www.conf 里配 chroot = /var/www/html（慎用）或确保 php_admin_value[doc_root] 指向同一位置
更简单做法：绕过 $document_root，直接硬编码（仅限调试）：
fastcgi_param SCRIPT_FILENAME /var/www/html$fastcgi_script_name;
WSL 用户检查是否启用了 metadata：在 /etc/wsl.conf 加 [automount] options = "metadata"，否则 chmod 不生效，php-fpm 拒绝读取