如何在 Nginx 中正确区分同名 PHP 文件与目录的访问路径

本文详解如何配置 nginx，使 `/service`（无尾斜杠）优先匹配 `service.php`，而 `/service/`（有尾斜杠）才进入 `service/` 目录，避免因 `try_files` 中 `$uri/` 顺序导致的意外目录跳转。

在典型的 nginx + php-FPM 环境中，当存在同名文件与目录（如 service.php 和 service/）时，用户常遇到一个隐蔽但关键的问题：访问 http://example/service（无尾斜杠）本意是执行 service.php，却意外被重定向至 service/index.php —— 这并非重定向（301/302），而是由 try_files 的内部路径解析逻辑直接触发的内部跳转。

根本原因在于你当前配置中的这一行：

location / {     try_files $uri $uri/ @extensionless-php; }

Nginx 按从左到右严格顺序尝试每个选项：

• $uri → 检查是否存在 service（文件或符号链接）→ 否（service 是目录，不是普通文件）；
• $uri/ → 检查 service/ 是否为有效目录 → 是 → 立即内部跳转至该目录，并触发 index 指令（即 index.php），完全跳过后续的 @extensionless-php 阶段；
• 因此 rewrite ^(.*)$ $1.php last; 永远不会执行，service.php 被静默忽略。

✅ 正确解法是：移除 $uri/，强制将“无尾斜杠”请求交由 @extensionless-php 处理，仅让显式带尾斜杠的请求（如 /service/）才匹配目录行为。

立即学习“PHP免费学习笔记（深入）”；

以下是优化后的完整 server 块配置（兼容 ubuntu 20.04 / Nginx 1.18 / PHP 8.1）：

server {     listen 80 default_server;     listen [::]:80 default_server;      root /var/www/html;     index index.php index.html index.htm index.nginx-debian.html;     server_name _;      location / {         # 关键修改：移除 $uri/，确保 /service 不被误判为目录         try_files $uri @extensionless-php;     }      location ~ .php$ {         try_files $uri =404;         fastcgi_pass unix:/var/run/php/php-fpm.sock;         include fastcgi_params;         fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;     }      location @extensionless-php {         # 先检查 .php 文件是否存在，再执行 rewrite         if (-f $request_filename.php) {             rewrite ^(.*)$ $1.php last;         }         # 可选：若不存在对应 .php 文件，则返回 404（避免错误透传）         return 404;     }      location ~ /.ht {         deny all;     } }

? 关键增强说明：

• try_files $uri @extensionless-php;：跳过目录检查，所有非精确文件匹配均交由 @extensionless-php 处理；
• if (-f $request_filename.php)：在重写前主动验证 service.php 是否真实存在，避免将 /nonexistent 错误重写为 /nonexistent.php 并返回空响应；
• return 404 作为兜底：提升健壮性，防止无效请求静默失败。

⚠️ 注意事项：

• 不要使用 if 在 location / 外层（Nginx 官方明确警告其危险性），此处位于命名 location 内是安全且推荐的用法；
• 若需支持 /service/ 访问目录，浏览器或客户端必须显式携带尾斜杠（如 curl http://example/service/），Nginx 不会自动补全；
• 修改后务必执行 sudo nginx -t && sudo systemctl reload nginx 验证并重载配置；
• 此方案不依赖 autoindex 或额外重定向，全程为内部 URI 重写，性能无损。

总结：Nginx 的 try_files 是“短路求值”，顺序即逻辑。要实现文件与同名目录的共存访问，核心是打破 $uri/ 对目录的过早捕获，将决策权交还给可编程的命名 location。这不仅是配置技巧，更是理解 Nginx 请求处理生命周期的关键实践。