TYPO3 9：如何用RouteEnhancers配置带参数的页面额外路由？

可以通过RouteEnhancers实现该需求，TYPO3 9的路由增强器支持自定义匹配规则，能直接将指定格式的URL映射到对应页面，同时保留原URL中的参数且不触发301重定向。

具体配置示例 #

在你的站点配置文件（config/sites/[你的站点标识]/config.yaml）中添加以下RouteEnhancers配置：

routeEnhancers:
  CustomPageRouteEnhancer:
    type: Simple
    routePath: '/{randomLetter},{pageSlug},{randomNumber}.html'
    requirements:
      randomLetter: '[a-zA-Z]+'
      randomNumber: '\d+'
      pageSlug: 'page|anotherpage'
    _arguments:
      pageSlug: 'page'

配置说明 #

• type: Simple：选用简单路由增强器，适配静态页面的URL映射场景
• routePath：定义待匹配的URL结构，三个占位符分别对应需求中的任意字母、页面slug、任意数字
• requirements：对占位符做格式约束：
  • randomLetter: '[a-zA-Z]+'：确保该位置仅匹配任意大小写字母组合
  • randomNumber: '\d+'：确保该位置仅匹配任意数字组合
  • pageSlug: 'page|anotherpage'：限定仅匹配指定的现有页面slug（可根据需求新增更多slug，用|分隔）
• _arguments：将pageSlug占位符映射到TYPO3内部的page参数，让系统能正确识别并渲染对应的页面

关键注意点 #

• 确保现有页面的slug与配置中pageSlug的取值完全一致（比如page对应www.mypage.com/page/）
• 该配置不会触发301重定向，浏览器地址栏将保留原始的{randomLetter},{pageSlug},{randomNumber}.html格式URL，满足JavaScript对参数的读取需求
• 如果后续需要支持更多页面，只需在pageSlug的正则规则中添加对应的页面slug即可

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