Zend Framework含特殊字符URL不匹配路由问题求助

这个问题我之前也碰到过，本质是Literal路由的严格匹配特性和部分浏览器对?的编码行为冲突了。当浏览器把?编码成%3F后，服务器会把/search%3Fq=test整个当成请求路径，而不是/search加上查询参数q=test——你的Literal路由只匹配精确的/search路径，自然就返回404了。

下面给你两个可行的解决方案，从简单到灵活：

方案一：在路由前修正URI编码（推荐） #

你可以在Zend MVC的路由匹配流程之前，添加一个事件监听器，把路径中的%3F替换回?，这样既能让查询参数被正确解析，又能让路由匹配上/search。

在你的模块Module.php里修改onBootstrap方法：

public function onBootstrap(MvcEvent $e)
{
    $eventManager = $e->getApplication()->getEventManager();
    $eventManager->attach(MvcEvent::EVENT_ROUTE, function(MvcEvent $e) {
        $request = $e->getRequest();
        if ($request instanceof \Zend\Http\Request) {
            $uri = $request->getUri();
            $path = $uri->getPath();
            
            // 检查路径中是否包含编码的?，并分割为路径和查询参数
            if (strpos($path, '%3F') !== false) {
                list($newPath, $queryString) = explode('%3F', $path, 2);
                $uri->setPath($newPath);
                $uri->setQuery($queryString);
                $request->setUri($uri);
            }
        }
    }, 100); // 设置较高优先级，确保在路由匹配前执行
}

这段代码会在路由匹配前触发，把编码的查询参数分隔符还原，修正后的请求就能被你的Literal路由正确匹配，同时q=test这类参数也能正常被控制器获取。

方案二：改用Segment路由替代Literal路由 #

如果你不想修改事件监听，也可以把Literal路由换成Segment路由，让它能匹配/search后面跟着的任意内容（包括编码的%3F），再手动把路由参数转换成查询参数。

修改你的路由配置：

'searchResultPage' => array(
    'type' => 'Zend\Mvc\Router\Http\Segment',
    'options' => array(
        'route' => '/search[/:queryPart]',
        'defaults' => array(
            'controller' => 'Application\Controller\Index',
            'action' => 'searchResultPage',
            'queryPart' => ''
        ),
        'constraints' => array(
            'queryPart' => '.*' // 允许任意字符
        )
    ),
),

然后在控制器的searchResultPage方法里处理参数：

public function searchResultPageAction()
{
    $queryPart = $this->params()->fromRoute('queryPart', '');
    $request = $this->getRequest();
    
    // 如果存在编码的查询参数部分，解析并合并到请求查询参数中
    if (!empty($queryPart)) {
        parse_str($queryPart, $queryParams);
        $request->getQuery()->merge($queryParams);
    }
    
    // 后续正常获取查询参数即可
    $q = $this->params()->fromQuery('q', '');
    // ... 你的业务逻辑
}

这个方案不需要修改全局事件，但需要额外处理路由参数，把它转换成标准查询参数格式。

注意事项 #

• 方案一能从根源解决问题，不仅适用于这个路由，其他路由遇到类似编码问题也能自动处理。
• 测试时要覆盖不同浏览器和移动设备，确保修正后的请求能正确匹配路由并获取参数。

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