Nginx配置适配原Apache Rewrite规则实现URL路径传参至对应目录index.php
故障根因
- 原配置中
location /块的try_files $uri $uri/ =404逻辑优先级过高,碰到不存在的路径直接返回404,自定义路由规则没有执行机会,导致单段路径访问报错 - 缺少目录请求到对应index.php的转发逻辑,Nginx解析带尾斜杠的目录请求时,没有将请求交给PHP-FPM处理,触发静态文件下载行为
- 路由规则没有做目录层级适配,子目录下的index.php无法复用根目录的路由参数映射逻辑
- 原.htaccess中的拦截规则、xml重写、自定义错误页逻辑没有在Nginx配置中对应落地
可直接套用的修正配置
server { listen 443 ssl; server_name example.com; # 对齐原Apache的AddDefaultCharset UTF-8设置 charset utf-8; ssl_certificate /etc/nginx/ssl/example.com.crt; ssl_certificate_key /etc/nginx/ssl/example.com.key; ssl_protocols TLSv1.2 TLSv1.3; ssl_ciphers HIGH:!aNULL:!MD5; root /var/www/html; index index.php; # 对齐原Apache的Options -Indexes设置,关闭目录索引 autoindex off; # 拦截.ht文件请求,对齐原Apache配置 location ~ /\.ht { deny all; } # 拦截.inc、.tpl后缀请求,跳转到404错误页,对齐原Apache的RedirectMatch规则 location ~ \.(inc|tpl)$ { return 301 /error/404/; } # 对齐原Apache的xml请求重写规则 location = /file1.xml { rewrite ^ /file1.php last; } location = /file2.xml { rewrite ^ /file2.php last; } # 放行assets静态资源目录,不做重写处理,对齐原Apache的RewriteRule放行逻辑 location ^~ /assets/ { try_files $uri =404; } location / { # 路由规则按照请求路径层级匹配,同时兼容带/不带尾部斜杠的请求 # 根目录访问,传递param1=main参数 rewrite ^/?$ /index.php?param1=main last; # 单段路径请求(根目录层级) rewrite ^/([-a-zA-Z0-9_]+)/?$ /index.php?param1=$1 last; # 两段路径请求(根目录层级) rewrite ^/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/?$ /index.php?param1=$1¶m2=$2 last; # 三段路径请求(根目录层级) rewrite ^/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/?$ /index.php?param1=$1¶m2=$2¶m3=$3 last; # 四段路径请求(根目录层级) rewrite ^/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/?$ /index.php?param1=$1¶m2=$2¶m3=$3¶m4=$4 last; # 子目录通用路由规则,匹配folder1、folder2等所有一级子目录下的请求 # 子目录根路径访问,传递param1=main参数 rewrite ^/([^/]+)/?$ /$1/index.php?param1=main last; # 子目录单段路径 rewrite ^/([^/]+)/([-a-zA-Z0-9_]+)/?$ /$1/index.php?param1=$2 last; # 子目录两段路径 rewrite ^/([^/]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/?$ /$1/index.php?param1=$2¶m2=$3 last; # 子目录三段路径 rewrite ^/([^/]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/?$ /$1/index.php?param1=$2¶m2=$3¶m3=$4 last; # 子目录四段路径 rewrite ^/([^/]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/?$ /$1/index.php?param1=$2¶m2=$3¶m3=$4¶m4=$5 last; # 最后兜底处理真实文件的请求 try_files $uri $uri/ =404; } # 自定义错误页映射,对齐原Apache的ErrorDocument配置 error_page 400 /error/400/; error_page 401 /error/401/; error_page 403 /error/403/; error_page 404 /error/404/; error_page 500 /error/500/; # PHP解析配置,确保所有层级的PHP文件都能正确交给PHP-FPM处理 location ~ \.php$ { # 校验PHP文件真实存在,避免非法请求 try_files $uri =404; include snippets/fastcgi-php.conf; fastcgi_pass unix:/var/run/php/php7.4-fpm.sock; } }
关键配置说明
- 所有路由规则兼容带/不带尾部斜杠的请求,解决之前访问带尾斜杠路径触发下载的问题:重写后的请求会直接进入PHP解析流程,不会被当作静态文件返回
- 子目录路由完全适配:当请求访问
/folder1或/folder1/xxx时,会自动匹配到/folder1/index.php,并按照路径顺序传递对应参数,不需要单独为每个子目录写重复规则 - 静态资源优先匹配:assets目录下的静态文件请求直接尝试读取本地文件,不会被重写规则拦截,提升访问速度
- 规则优先级调整:重写规则放在try_files之前执行,解决之前单段路径因为try_files兜底返回404的问题
内容的提问来源于stack exchange,提问作者fustacre
相关产品推荐
相关产品推荐

