在 nginx 中,`try_files` 配合 `fastcgi_pass` 实现动态脚本降级(即优先返回静态文件,若不存在则交由 php-fpm 处理)的核心做法是:将 `try_files` 的最后一个参数设置为指向 fastcgi 后端的路由 uri(如 /index.php),并在对应的 location 块中配置 fastcgi_pass。这样当请求的文件存在时直接输出,不存在时 nginx 会内部重定向到指定的 php 入口文件,从而让动态脚本接管请求。

try_files 如何触发 fastcgi 代理
要实现这种降级机制,必须在 server 或 location 块中正确设置 try_files 指令。该指令按顺序检查文件或目录是否存在,如果所有列出的路径都不存在,它将执行最后一个参数的操作。关键在于,最后一个参数不能是一个不存在的文件路径(这会导致 404),而必须是一个以 = 开头的内部重定向目标,或者一个指向 FastCGI 后端的 URI。
例如,在一个典型的 WordPress 或自定义 PHP 应用中,我们希望先查找静态资源,如果没有找到,就交给 index.php 处理。配置如下:
server {
listen 80;
server_name example.com;
root /var/www/html;
location / {
try_files $uri $uri/ /index.php?$query_string;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php/php-fpm.sock;
fastcgi_index index.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
}
}
在这个配置中,当用户请求 /style.css 时,Nginx 首先检查 $uri(即 /var/www/html/style.css)。如果文件存在,直接返回;如果不存在,检查 $uri/(即目录);如果也不存在,最后执行 /index.php?$query_string。这是一个内部重定向,Nginx 会将请求转发给 location ~ \.php$ 块,进而通过 fastcgi_pass 发送给 PHP-FPM。注意,SCRIPT_FILENAME 参数必须正确设置为实际的文件路径,否则 PHP 将无法找到要执行的脚本。
预期结果:访问存在的静态文件返回文件内容;访问不存在的 URL 则执行 index.php 的逻辑。
如何处理特定后缀的动态脚本
除了通用的根路径降级,有时我们需要对特定类型的动态脚本进行更精细的控制,例如只允许 .php 文件被降级处理,或者在某些子目录下使用不同的入口文件。这时,我们可以结合 location 的正则匹配和 try_files 的具体路径。
假设我们有一个 /api 目录,其中的动态接口由 router.php 处理,而静态资源直接存放。配置如下:
location /api/ {
alias /var/www/api/;
try_files $uri $uri/ /router.php?$query_string;
}
location ~ ^/api/.*\.php$ {
fastcgi_pass unix:/run/php/php-fpm.sock;
fastcgi_index router.php;
include fastcgi_params;
fastcgi_param SCRIPT_FILENAME /var/www/api/router.php;
fastcgi_param PATH_INFO $fastcgi_script_name;
}
这里的关键点在于 alias 的使用以及 SCRIPT_FILENAME 的硬编码。由于 alias 改变了文件系统的映射关系,$document_root$fastcgi_script_name 可能不再准确,因此需要显式指定 SCRIPT_FILENAME 为实际的物理路径。同时,PATH_INFO 变量有助于传递额外的路径信息给 PHP 脚本。
预期结果:请求 /api/data.json 若存在则直接返回;若不存在,则内部重定向到 /api/router.php,由 PHP 处理逻辑。
基于 try_files 最后一个参数为 =404 时的行为分析
当 try_files 的最后一个参数设置为 =404 时,表示如果前面的所有文件和目录都不存在,Nginx 将直接返回 404 错误,而不会进行任何内部重定向或代理。这与设置为具体 URI(如 /index.php)的行为形成鲜明对比,后者会触发后续的 location 匹配和 fastcgi_pass 处理。
考虑以下配置片段:
location /static/ {
root /var/www/html;
try_files $uri $uri/ =404;
}
在这个例子中,如果请求 /static/nonexistent.html,Nginx 会检查 /var/www/html/static/nonexistent.html 和 /var/www/html/static/nonexistent.html/。如果两者都不存在,它不会尝试去调用任何 PHP 脚本,而是立即返回 404 Not Found 响应。这种行为适用于纯静态资源目录,确保不会意外地将静态请求误传给动态后端,从而提高安全性和性能。
与之相对,如果我们将最后一个参数改为 /fallback.php,同样的请求将被内部重定向到 /fallback.php,并进入 fastcgi_pass 流程。因此,选择 =404 还是具体的 URI,取决于是否希望未找到的资源由动态脚本处理。在实际开发中,明确区分静态资源和动态路由的处理逻辑,可以有效避免不必要的 PHP 进程启动,优化服务器资源利用率。











