Symfony 4如何配置路由未匹配时跳转至fallback控制器的兜底规则

Symfony 4 全局兜底路由实现方案 #

Symfony 4完全支持配置未匹配请求的兜底路由，核心原理是将兜底路由的匹配优先级设为最低，所有已定义路由匹配失败后才会触发该路由。

完整可运行示例

1. 创建兜底控制器

// src/Controller/FallbackController.php
namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;

class FallbackController extends AbstractController
{
    /**
     * 所有未匹配的请求都会进入该方法
     */
    public function handleFallback(string $path): Response
    {
        // 自定义处理逻辑示例：返回自定义404页面，附带404状态码
        return $this->render('error/404.html.twig', [
            'requestPath' => $path
        ], new Response('', 404));

        // 其他处理逻辑参考：直接跳转到首页
        // return $this->redirectToRoute('app_home');
    }
}

2. 配置兜底路由

可任选注解或YAML其中一种配置方式：

• 注解配置方式
  在控制器方法上添加路由注解即可：

  /**
   * @Route("{path}", name="app_fallback", requirements={"path"=".*"}, priority=-100)
   */
  public function handleFallback(string $path): Response
  

• YAML配置方式
  在config/routes.yaml文件末尾添加如下配置（无需在控制器写注解）：

  # 注意：该配置必须放在所有路由规则的最下方，优先级设为负数确保最后匹配
  app_fallback:
      path: /{path}
      controller: App\Controller\FallbackController::handleFallback
      requirements:
          path: .*
      priority: -100
  

注意事项

• 若使用的Symfony版本低于4.1不支持priority参数，直接将兜底路由配置放在所有路由规则的最下方即可，Symfony默认按配置顺序从上到下匹配路由。
• 可通过methods参数限制兜底路由支持的请求类型，例如添加methods={"GET"}仅处理GET请求。
• 兜底路由匹配成功后不会再触发Symfony默认的404异常逻辑，所有异常处理可在兜底控制器中自定义实现。

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