电商平台商品路径重写需将静态URL(如/goods-123.html)精准映射至对应PHP脚本(如/goods.php?id=123),限定location范围避免干扰,使用last标志确保重写后重新匹配PHP处理块,并配合root或alias正确指向站点目录。

电商平台商品路径重写,核心是把用户看到的静态 URL(比如 /goods-123.html)内部映射到真实的 PHP 脚本(比如 /goods.php?id=123),同时保持前端体验简洁、利于 SEO。Nginx 本身不执行 PHP,只做路径转换,所以重写必须精准、可扩展,且不能影响其他类型页面(如文章、分类、搜索等)。
明确 location 范围,避免全局干扰
不要在 server 块顶层直接写 rewrite,应限定在具体子路径下,例如 ECShop 部署在 /ecshop/ 下:
- 用
location /ecshop { ... }包裹所有相关规则,确保只对该目录生效 - 避免使用模糊的
location / { ... },否则可能误匹配后台、API 或静态资源路径 - 如果项目部署在根目录(
/),则用location / { ... },但需格外注意顺序和优先级
商品页重写:提取 ID 并转给 goods.php
典型静态路径如 /goods-123.html → 内部调用 /goods.php?id=123:
- 正则写法:
rewrite ^/goods-(\d+)\.html$ /goods.php?id=$1 last; -
\d+匹配 1 位及以上数字,比\d{1,7}更通用;若确定 ID 不超 7 位,也可保留限制 - 结尾用
last表示重写后重新匹配 location,确保能进入 PHP 处理块(如location ~ \.php$) - 注意:如果路径含前缀(如
/ecshop/goods-123.html),正则要带前缀:^/ecshop/goods-(\d+)\.html$,replacement 对应写成/ecshop/goods.php?id=$1
同步支持文章、分类等其他页面
单一商品重写不够,后台开启“简单重写”后,系统还会生成 article-45.html、category-8-b2-attr123.html 等路径:
- 文章页:
rewrite ^/article-(\d+)\.html$ /article.php?id=$1 last; - 分类页(含品牌、价格、属性等参数):
rewrite ^/category-(\d+)(?:-b(\d+))?(?:-min(\d+))?(?:-max(\d+))?(?:-attr([\w.]+))?(?:-(\d+))?-(?:\w+)-(\w+)\.html$ /category.php?id=$1&brand=$2&price_min=$3&price_max=$4&filter_attr=$5&page=$6&sort=$7&order=$8 last; - 实际中建议拆解为多条简化规则,或用更宽松的捕获(如
^/category-(.+)\.html$)配合后端解析,避免正则过长难维护
注意 flag 选择与 location 协同
rewrite 后的行为直接影响能否正确执行 PHP:
- 用
last:重写后终止当前 location 匹配,重新发起 URI 匹配——这是最常用的选择,确保/goods.php?id=123能被location ~ \.php$捕获并交给 fastcgi 处理 - 别用
break:它只终止 rewrite 执行,不重新匹配,可能导致路径没进 PHP 块而返回源码或 404 - 不用
redirect或permanent:那是对外跳转(301/302),会暴露真实地址,破坏伪静态效果 - 确保 location 内有 root 或 alias 正确指向站点文件目录,例如
root /var/www/html;或alias /var/www/html/ecshop;


















