12. 结论
本文档描述了使用 [Symfony] 框架开发一个 MVC Web 应用程序的过程:这是一个 HTML 页面由服务器使用 [Twig] 视图生成、没有浏览器端 [JavaScript] 框架的应用程序。它分步遵循了 [Laravel] 课程,而该课程本身又建立在 [Flask]、[Spring MVC]、[ASP.NET Core MVC] 和 [NestJS] 课程之上:从操作和路由到视图、表单、国际化、安全和数据访问,最后是一个综合案例研究。
因此,同样的 28 个示例和同一个应用程序,使用六个框架编写:[TypeScript] 版、[C#] 版、[Java] 版、[Python] 版,以及两个 [PHP] 版。概念是相同的;只有名称和机制不同。[Laravel] 与 [Symfony]([PHP] 世界的两大主要框架)之间的对应关系:
[Laravel] | [Symfony] |
[bootstrap/app.php]、服务提供者、 | ([src/Kernel.php])、Bundle、已编译的容器([config/services.yaml]、[#[Autowire]]) |
[composer.json]、[vendor] 文件夹、[php artisan] | [composer.json]、[vendor] 文件夹、[php bin/console] |
文件 [.env]、[config] 文件夹([PHP] 文件)、函数 [env] 和 [config] | 文件 [.env]、[config/packages] 文件夹(YAML 文件)、[%env(...)%]、容器设置 |
[routes/web.php]、命名路由、路由组 | 控制器属性 [#[Route]],用于操作和类 |
[view]、[redirect]、[route] | [render]、[redirectToRoute]、[generateUrl] ([AbstractController]);视图中的 [path] |
对象 [Request]、约束([whereNumber])、模型绑定 | 对象 [Request]、[requirements] ([{id<\d+>}])、参数解析器、[#[MapQueryString]]、[#[MapRequestPayload]] |
[Validator]、表单请求([FormRequest])、规则、[$errors]、[old()] | Validator 组件(属性约束)、Form 组件(类型、[handleRequest]、[isValid]) |
视图 [Blade]、[{{ }}]、[@foreach]、[@if] | 视图 [Twig]、[{{ }}]、[{% for %}]、[{% if %}] |
[@extends] 和 section、[@include]、组件([<x-...>]) | [{% extends %}] 和块、[{% include %}]、宏 |
视图合成器([View::composer]) | [Twig] 的全局变量、[Twig] 扩展(函数、过滤器) |
会话闪现数据([session()->flash]、[with]) | 闪现消息([addFlash]、[app.flashes])、基于文件的会话 |
(全局、组、路由)、[terminate] 方法 | 内核事件监听器([kernel.request]、[kernel.controller]、[kernel.response]、[kernel.terminate]……) |
[withExceptions]、[render]、[abort] | 监听器:[kernel.exception]、[HttpException]、[createNotFoundException] |
守卫([Auth::viaRequest])、中间件 [auth]、[Gate]、外观 [Hash] | 防火墙、身份验证器、[access_control]、[#[IsGranted]]、投票器、哈希([security.yaml]) |
[PreventRequestForgery] 中间件、[@csrf] 指令(419 响应) | Form 组件令牌、[csrf_token()] 和 [isCsrfTokenValid] (403 响应,在我们的应用程序中为 419) |
[RateLimiter] (外观) | 组件 [RateLimiter] (限制器在 [framework.yaml] 中声明) |
文件夹 [lang]、函数 [__()]、[App::setLocale] | 文件夹 [translations] (YAML、ICU)、过滤器 [trans]、[TranslatorInterface]、查询语言 |
[Carbon] ([isoFormat])、[Number] | 扩展 [intl]:[IntlDateFormatter]、[NumberFormatter] |
缓存([Cache]、[Cache::lock]) | Cache 组件(PSR-6 和 contracts)、Lock 组件 |
[Eloquent]:Active Record 模型、关系([belongsTo]、[with]) | [Doctrine]:Data Mapper 实体、实体管理器、DQL 和 QueryBuilder、关系([ManyToOne]、[OneToOne]) |
[DB::transaction(...)] | [wrapInTransaction(...)]、[flush] |
[WHERE version = ?] 和 [version + 1],写入 DAO 层 | [#[ORM\Version]],由 [Doctrine] 管理([OptimisticLockException]) |
[php artisan serve] | [php -S localhost:8000 -t public],或 [symfony server:start] |
关于 [Laravel],需要注意的要点是:
- [Symfony] 是一组独立的组件,组装成Bundle。每个组件都是自包含的,[Laravel] 使用了其中的几个([HttpFoundation]、[HttpKernel]、[Routing]、[Console]……):上一课的读者会在这里认出相同的对象:[Request] 和 [Response]。名为 [Symfony] 的应用程序只安装其所需的组件:示例一开始只有 [framework-bundle],然后逐个添加 [Twig]、验证、表单、安全和 [Doctrine];
- 一切都通过服务容器 和 依赖注入进行:没有外观或全局函数,而是将服务传给构造函数并按类型声明(自动装配)。一个类的依赖在其构造函数中始终可见。容器会被编译 为 [PHP] 代码并缓存:这抵消了每次请求都重新构建应用程序的开销(示例 01);
- 请求的处理由一系列内核事件 组成,监听器对这些事件作出响应:语言、安全、应用程序控制(通行证)和错误页面都在这里处理。这一机制比 [Laravel] 中的中间件更明确:每个监听器选择自己的事件和优先级,命令 [debug:event-dispatcher] 会显示所有监听器的顺序;
- 配置是显式的,位于 YAML(或 [PHP])文件中,这些文件描述每个 Bundle:防火墙、访问规则、限制器和会话、[Doctrine]。命令 [debug:router]、[debug:container] 和 [debug:config] 会显示 [Symfony] 所解释的内容;
- [PHP] 属性描述代码:路由([#[Route]])、约束([#[Assert\NotBlank]])、实体([#[ORM\Column]])、监听器([#[AsEventListener]])、权限([#[IsGranted]])和注入([#[Autowire]])。我们甚至自己编写了一些([#[Timed]], [#[RegistrationPassRequired]]);
- 表单是对象,由类来描述,例如:字段、约束、值转换、输入重新显示、错误消息和防 CSRF 令牌。对于小型表单,这比 [Laravel] 中的表单请求代码更多,而对于大型表单则少得多:一个主题([Bootstrap] 5)以相同的方式为所有字段设置样式;
- 安全是一个功能完备的组件:防火墙、验证用户的身份验证器、访问规则、角色层级和投票器。我们使用一个只有几十行的身份验证器,使其适应了我们的需求(Cookie 中的 JWT 令牌),同时没有丢失任何其他功能:[access_control]、[#[IsGranted]]、视图中的 [is_granted] ;
- [Doctrine] 遵循Data Mapper 模式:实体是普通的 [PHP] 对象,它们并不知道数据库的存在;由实体管理器 读取它们、跟踪其变化,并在 [flush] 时将它们在单个事务中一并写入。它比 [Eloquent] 的 Active Record 更抽象,清晰地将对象与其记录分离,并支持乐观锁等机制。与 [Eloquent] 一样,通过 SQL 命令日志可以验证发送给数据库的内容;
- [Twig] 视图有自己的语言,它比 [PHP] 在 [Blade] 视图中的用法更有限:视图只能显示提供给它的数据。这既是约束,也是保证:逻辑保留在类中。它们被编译为 [PHP] 并缓存,并自动对其显示的内容进行转义。
案例研究表明,没有必不可少的 [JavaScript] 的经典 HTML 应用程序,仍然是简单而稳健的解决方案:每个页面就是一个 URL,浏览器的“后退”按钮可以正常工作,并且服务器掌控一切。有限地使用 [JavaScript] (确认窗口)可以改善用户体验,而不是运行所必需的。[Symfony] 也可以支持交互性更强的应用程序,既可以不离开 [Twig] ([Symfony UX]:[Turbo]、[Stimulus]、Live Components),也可以配合浏览器端的 [JavaScript] 框架,为其提供 JSON API([API Platform]):这将在其他文档中介绍。
如需进一步了解,请参阅 [Symfony] 文档(symfony.com/doc),特别是专门介绍服务容器、内核事件、表单、安全和 [Doctrine] 的页面,以及 [Twig] 的文档(twig.symfony.com)、[Doctrine] 的文档(doctrine-project.org)、[PHP] 的文档(php.net/manual/en),并将本应用程序与其对应版本 [Laravel]、[Flask]、[Spring MVC]、[ASP.NET Core MVC]、和 [NestJS] 进行比较。