一、使用 Symfony CLI 命令生成控制器
想要快速上手 Symfony 控制器开发，避免手动创建文件和基础配置的繁琐步骤？Symfony 内置的强大命令行工具（CLI）正是你的理想选择。它能在数秒内，为你自动生成一个结构规范、功能完备且开箱即用的控制器类，极大提升开发效率。
操作流程极为简便：首先，请打开终端并确保当前工作目录位于你的 Symfony 项目根目录下。随后，只需执行一条核心命令：php bin/console make:controller DefaultController。
命令成功执行后，系统会自动在项目的 src/Controller/ 目录下，创建名为 DefaultController.php 的控制器文件。打开该文件，你会发现它不仅包含了符合 PSR 标准的命名空间声明，还预先配置了一个带有 @Route(“/”) 注解的 index() 动作方法。相应的路由规则也已自动完成注册，整个过程高效且无误。
在 Symfony 框架中处理 HTTP 请求，控制器是核心入口。如果你刚开始一个 Symfony 项目，创建第一个控制器是首要任务。Symfony 框架设计灵活，为此提供了多种创建方式，开发者可以根据项目需求、开发阶段及个人习惯进行选择。接下来，我们将深入解析四种主流的 Symfony 控制器创建方法。
二、手动创建控制器类文件
如果你希望完全掌控控制器的每一个细节，或者项目环境未安装 Maker Bundle，手动创建是最直接、最基础的方式。这种方法要求你严格遵循 Symfony 的编码约定：控制器类通常应继承 AbstractController 基类（它集成了模板渲染、服务获取等众多快捷方法），或者直接实现 ControllerInterface 接口。
具体实施步骤如下：首先，在 src/Controller/ 目录下，手动新建一个 PHP 文件，例如命名为 HelloController.php。接着，在文件起始位置声明正确的命名空间：namespace App\Controller;。
然后，通过 use 语句引入必要的依赖类，例如：use Symfony\Bundle\FrameworkBundle\Controller\AbstractController; 以及 use Symfony\Component\HttpFoundation\Response;。最后，定义你的控制器类 class HelloController extends AbstractController，并在类内部添加一个带有 @Route(“/hello”) 路由注解的公共方法。至此，一个完全由你自定义的、功能完整的控制器便创建完成了。
三、使用函数式控制器（无类定义）
针对一些逻辑极其简单的场景，例如快速构建原型或实现一个微小的功能端点，Symfony 框架提供了更为灵活的方案——允许你绕过传统的“类”定义，直接使用一个函数（闭包或全局函数）作为控制器。这种方式极大地简化了代码结构。
此方法的核心在于路由配置。你需要编辑项目中的 config/routes.yaml 路由配置文件，添加一个新的路由条目，例如 hello_route:。在该条目下，通过缩进定义 path: /hello-func 和关键的 controller 属性。此处的 controller 属性可以直接指向一个已定义的函数，其引用格式通常为 ‘function: [App\Controller\HelloController, helloAction]’。
当然，前提是你需要在代码的某个位置（例如在 src/Controller/HelloController.php 文件中作为一个独立的函数）正确定义好这个 helloAction() 函数，并确保它返回一个 Symfony 的 Response 对象。这种方法非常轻量级，但通常仅适用于处理最简单、无状态的业务逻辑。
四、通过服务容器注册控制器为服务
最后一种方法是面向复杂场景的“进阶模式”。当你的控制器拥有复杂的依赖关系（例如需要注入日志服务、邮件服务、自定义仓库等），并且你希望它不继承任何基类，以保持其作为“纯粹服务”的独立性时，将其注册为服务容器中的一个服务是更佳的选择。
首先，按照常规方式创建控制器类文件，例如 src/Controller/GreetingController.php，但此次可以选择不继承 AbstractController。在其构造函数中，直接通过类型提示声明所有必需的依赖项，例如 private LoggerInterface $logger;。
接下来是关键配置步骤：在 config/services.yaml 服务配置文件中，将这个控制器类显式定义为一个服务。你可以添加类似 App\Controller\GreetingController: 的配置项，并通过 arguments: [‘@logger’] 等方式为其注入所需的依赖服务实例。
最后，在路由配置中（无论是使用注解还是在 YAML 文件中），通过该服务的 ID 来引用控制器，例如 @Route(“/greet”, controller=”App\Controller\GreetingController::__invoke”)。这样，Symfony 强大的依赖注入容器就会负责实例化你的控制器并自动解析、注入所有声明的依赖，实现了更精细的控制和更松耦合的架构设计。
