You need to enable JavaScript to run this app. Nginx配置适配原Apache Rewrite规则实现URL路径传参至对应目录index.php
优惠活动
大模型
产品
解决方案
定价
更多

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&param2=$2 last;
        # 三段路径请求(根目录层级)
        rewrite ^/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/?$ /index.php?param1=$1&param2=$2&param3=$3 last;
        # 四段路径请求(根目录层级)
        rewrite ^/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/?$ /index.php?param1=$1&param2=$2&param3=$3&param4=$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&param2=$3 last;
        # 子目录三段路径
        rewrite ^/([^/]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/?$ /$1/index.php?param1=$2&param2=$3&param3=$4 last;
        # 子目录四段路径
        rewrite ^/([^/]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/([A-Za-z0-9-]+)/?$ /$1/index.php?param1=$2&param2=$3&param3=$4&param4=$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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.05 13:54:07