Symfony框架下如何为带#片段的URI定义路由并提取参数

问题原因 #

你写的路由无法生效的核心原因是：URL 中的 # 是片段标识符（hash 部分），默认不会被客户端发送到服务端，服务端收到的请求路径仅包含 # 前的 /ontologies/hda/0.1，自然无法匹配带 #Domaine/{id} 的路由规则。

解决方案 #

方案1：可调整URI格式/要求请求方转义# #

将遗留 URI 中的 # 转义为 %23，转义后 %23 会被当做路径的一部分发送到服务端，此时路由可以按如下方式定义：

/**
 * @Route("/ontologies/hda/0.1%23Domaine/{id}", requirements={"id"=".+"})
 */

其中 requirements={"id"=".+"} 配置用于允许 id 参数包含任意特殊字符（包括斜杠、下划线等），避免 Symfony 默认路由规则截断参数。

方案2：必须兼容原有带#的遗留URI #

如果不能修改已有的数据集URI，需要兼容原生带#的访问请求，因为服务端无法直接获取#后的内容，可以采用两种处理方式：

1. 定义匹配#前路径的通用路由，返回前端脚本读取片段参数：

   /**
    * @Route("/ontologies/hda/0.1", name="hda_ontology_base")
    */
   public function handleOntology(Request $request)
   {
       // 返回HTML页面，内置JS读取location.hash的内容，将#后的参数提交到后端业务接口
   }
   

2. 符合语义网规范的哈希URI处理方案：
   将带#的词汇URI和实际资源路径做303重定向映射，比如http://data.giving.eu/ontologies/hda/0.1#Domaine/arts-du-langage对应的资源，通过路径/ontologies/hda/0.1/Domaine/{id}提供，此时路由可以直接写为：

   /**
    * @Route("/ontologies/hda/0.1/Domaine/{id}", requirements={"id"=".+"})
    */
   

   访问原哈希URI时返回303响应指向对应的路径资源即可兼容人类访问和机器爬取场景。

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