PHP 8.1怎么配置Nginx的location块？-php教程-PHP中文网

nginx 的 location ~ \.php$ 块必须独立存在于 server 级别，正确配置 fastcgi_pass、script_filename 和 path_info，否则将导致 php 文件下载、502、500 或路由失效等问题。

php 8.1怎么配置nginx的location块？

location ~ .php$ 块必须存在且位置正确

没有这个块，Nginx 就不会把 .php 请求转发给 PHP-FPM，浏览器会直接下载 PHP 文件或返回 404。它不能放在 location / 内部，也不能写成 location ^~ .php$（前缀匹配不适用）——必须用正则匹配形式。

常见错误现象：访问 http://localhost/info.php 显示源码、空白页、或 502 Bad Gateway。

确保该块在 server 块一级，与 location / 并列
检查是否重复定义了多个 location ~ .php$，Nginx 只会生效最后一个
若使用自定义 root 路径（如 root /var/www/myapp;），SCRIPT_FILENAME 必须能拼出真实文件路径，否则报 500 或 “No input file specified”

fastcgi_pass 必须与 php-fpm.sock 路径或端口严格一致

fastcgi_pass 的值不是固定写法，它取决于你的 PHP-FPM 实际监听方式。Ubuntu/Debian 系统通常走 Unix socket（如 unix:/run/php/php8.1-fpm.sock），CentOS/RHEL 多用 127.0.0.1:9000；Windows 下 Nginx + PHP-CGI 则必须用 127.0.0.1:9000，不能用 socket。

容易踩的坑：

PHP-FPM 配置里 listen = /var/run/php/php8.1-fpm.sock，但 Nginx 写成了 /run/php/php8.1-fpm.sock（少了一级目录）→ 报错 connect() to unix:/run/php/php8.1-fpm.sock failed (2: No such file or directory)
PHP-FPM 运行用户（如 www-data）对 socket 文件无读写权限 → 502
Windows 下忘记启动 php-cgi.exe -b 127.0.0.1:9000，只配了 Nginx → 502

PATH_INFO 支持需显式开启（ThinkPHP/Laravel 路由依赖）

默认配置下，index.php/abc 这类带 PATH_INFO 的 URL 会被当成静态路径处理，导致 Laravel 或 ThinkPHP 的路由失效。这不是 bug，是 Nginx 默认不拆分 SCRIPT_NAME 和 PATH_INFO。

Nginx Config Linter

对 Nginx 配置文件进行语法检查、验证和安全、性能审计。

下载

解决方法是在 location ~ .php$ 块内添加两行：

fastcgi_split_path_info ^(.+.php)(/.+)$;
fastcgi_param PATH_INFO $fastcgi_path_info;

注意：fastcgi_split_path_info 是正则表达式，必须和实际 URL 结构匹配；如果用了 try_files fallback 方式（如 Laravel 推荐写法），这行可省略，但 SCRIPT_FILENAME 必须仍指向 index.php。

try_files + fastcgi_param SCRIPT_FILENAME 是更健壮的组合

相比老旧的 if (!-f $request_filename) { rewrite ... }，现代 PHP 框架推荐用 try_files 做入口统一 fallback，避免 if 性能问题和重写陷阱。

典型写法：

location / {
    try_files $uri $uri/ /index.php?$query_string;
}
location ~ .php$ {
    include fastcgi_params;
    fastcgi_pass unix:/run/php/php8.1-fpm.sock;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}

关键点：

$document_root$fastcgi_script_name 中的 $document_root 必须和当前 server 块的 root 一致，否则 SCRIPT_FILENAME 指向错误路径
不要漏掉 include fastcgi_params;，它提供了基础的 FastCGI 参数（如 CONTENT_TYPE、REQUEST_METHOD）
Windows 下 $document_root 若含盘符（如 D:/www），需确保路径分隔符为正斜杠，且 PHP 能识别该路径