Magento 2如何为自定义路由添加.html后缀？

嘿，这个需求其实在Magento 2里可以通过几种方式实现，我给你拆解下最常用的两种方案，你可以根据自己的场景选择：

如果希望/filter/路由下的所有请求都强制使用.html后缀，直接修改自定义模块的路由配置文件就行：

1. 找到你的模块路由文件：app/code/[Vendor]/[Module]/etc/frontend/routes.xml
2. 在<route>节点里添加suffix=".html"属性，修改后的配置如下：

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:App/etc/routes.xsd">
    <router id="standard">
        <route id="filter" frontName="filter" suffix=".html">
            <module name="[Vendor]_[Module]" />
        </route>
    </router>
</config>

3. 执行以下命令刷新配置和缓存：

bin/magento cache:clean config
bin/magento cache:flush

这样配置后，原来的/filter/search就只能通过/filter/search.html访问了，系统会自动解析后缀并路由到对应的控制器方法。

如果需要同时支持带.html和不带后缀的URL，或者需要更精细的控制，可以自定义一个路由处理器：

1. 创建Router类文件：app/code/[Vendor]/[Module]/Controller/Router.php

<?php
namespace [Vendor]\[Module]\Controller;

use Magento\Framework\App\ActionFactory;
use Magento\Framework\App\RequestInterface;
use Magento\Framework\App\ResponseInterface;
use Magento\Framework\UrlInterface;
use Magento\Framework\App\RouterInterface;

class Router implements RouterInterface
{
    protected $actionFactory;
    protected $response;
    protected $url;

    public function __construct(
        ActionFactory $actionFactory,
        ResponseInterface $response,
        UrlInterface $url
    ) {
        $this->actionFactory = $actionFactory;
        $this->response = $response;
        $this->url = $url;
    }

    public function match(RequestInterface $request)
    {
        $pathInfo = $request->getPathInfo();
        
        // 检查URL是否以.html结尾
        if (strpos($pathInfo, '.html') !== false) {
            // 移除.html后缀
            $newPath = rtrim($pathInfo, '.html');
            $request->setPathInfo($newPath);
            
            // 匹配filter路由
            if (strpos($newPath, '/filter/') === 0) {
                // 根据你的实际控制器和动作名称调整下面的参数
                $request->setModuleName('filter')
                        ->setControllerName('index')
                        ->setActionName('search');
                
                return $this->actionFactory->create(
                    \Magento\Framework\App\Action\Forward::class,
                    ['request' => $request]
                );
            }
        }
        
        // 不匹配则返回null，交给其他路由处理
        return null;
    }
}

2. 在app/code/[Vendor]/[Module]/etc/frontend/di.xml里注册这个Router：

<?xml version="1.0"?>
<config xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="urn:magento:framework:ObjectManager/etc/config.xsd">
    <type name="Magento\Framework\App\RouterList">
        <arguments>
            <argument name="routerList" xsi:type="array">
                <item name="custom_filter_router" xsi:type="array">
                    <item name="class" xsi:type="string">[Vendor]\[Module]\Controller\Router</item>
                    <item name="disable" xsi:type="boolean">false</item>
                    <item name="sortOrder" xsi:type="string">10</item> <!-- 确保在标准路由之前执行 -->
                </item>
            </argument>
        </arguments>
    </type>
</config>

3. 执行命令更新配置和缓存：

bin/magento setup:di:compile
bin/magento cache:flush

如果你需要在模板或代码里生成带.html的链接，可以使用UrlBuilder的_suffix参数：

// 在控制器或块中
$searchUrl = $this->urlBuilder->getUrl('filter/search', ['_suffix' => '.html']);

在模板里可以这样写：

<?= $block->getUrl('filter/search', ['_suffix' => '.html']) ?>

内容的提问来源于stack exchange，提问作者John