Skip to content

12. 结论

本文档介绍了使用 [Laravel] 框架开发 MVC Web 应用程序的过程:这个应用程序的 HTML 页面由服务器使用 [Blade] 视图生成,没有浏览器端的 [JavaScript] 框架。它分步跟随 [Flask] 课程,而该课程本身又建立在 [Spring MVC]、[ASP.NET Core MVC]、和 [NestJS] 课程之上:从动作和路由到视图、表单、国际化、安全和数据访问,最后是一个完整的案例研究。

这样,同样的 28 个示例和同一个应用程序已使用五种框架编写完成:使用 [TypeScript]、[C#]、[Java]、[Python] 以及 [PHP]。概念是相同的;只有名称和机制不同。[Flask] 与 [Laravel] 之间的对应关系:

[Flask]
[Laravel]
工厂函数 [create_app],存放在 [app.extensions] 中的条目
[bootstrap/app.php]、服务提供者、容器([$singletons],由工厂注入)
[requirements.txt]、虚拟环境、[pip]
[composer.json]、[composer.lock]、文件夹 [vendor]、[Composer]
[config.py]、变量 [FLASK_...] ([app.config])
文件 [.env]、文件夹 [config]、函数 [env] 和 [config]
蓝图、[@bp.get]、[@bp.post]
[routes/web.php]、控制器、命名路由、路由组
[render_template]、[redirect]、[url_for]
[view]、[redirect]、[route]
[request.args]、[request.form]、转换器([<int:id>])
对象 [Request]、动作参数、约束([whereNumber])、模型绑定
[Pydantic];[WTForms]:验证器、[form.validate()]、[form.errors]
[Validator]、表单请求([FormRequest])、规则、[$errors]、[old()]
视图 [Jinja2]、[{{ }}]、[{% for %}]、[{% if %}]
视图 [Blade]、[{{ }}]、[@foreach]、[@if]
[{% extends %}] 和块、[{% include %}]、宏
[@extends] 和部分、[@include]、组件([<x-...>])
上下文处理器([@app.context_processor])
视图合成器([View::composer])
闪现消息([flash]),存放在签名的会话 Cookie 中
会话闪现数据([session()->flash]、[with]),会话存储在文件或加密的 Cookie 中
[before_request]、[after_request]、[teardown_request]
中间件(全局、组、路由)、方法 [terminate]
[@app.errorhandler]
[withExceptions]、[render]、[abort]
[before_request] 和手写的装饰器([PyJWT]、[bcrypt])
守卫([Auth::viaRequest])、中间件 [auth]、[Gate]、门面 [Hash] ([firebase/php-jwt])
[CSRFProtect] ,来自 [Flask-WTF]
[PreventRequestForgery] 中间件、[@csrf] 指令(419 响应)
JSON 字典、手写函数 [t(...)]
文件夹 [lang]、函数 [__()]、[App::setLocale]
[Babel]
[Carbon] ([isoFormat])、[Number] (扩展 [intl])
内存中的字典、[threading.Lock]
缓存([Cache]、[Cache::lock])、[RateLimiter]
[SQLAlchemy]:映射实体、[select(...)]、会话
[Eloquent]:模型、查询构建器、关联([belongsTo]、[with])
[with sessions.begin() as session:]
[DB::transaction(...)]
[version_id_col],由 [SQLAlchemy] 管理
[WHERE version = ?] 和 [version + 1],写在 DAO 层中
[python app.py] 在调试模式下(自动重新加载)
[php artisan serve] (无需重新加载任何东西:每个请求都会重新读取代码)
WSGI 服务器:[Waitress]、[Gunicorn]
Web 服务器([nginx]、[Apache])和 [PHP-FPM]

关于 [Flask],需要注意的要点有:

  • [Laravel] 是一个全栈框架:路由、视图、验证、会话、缓存、身份验证、翻译、数据访问、邮件发送、任务队列……一切都已提供,而且一切都被设计为协同工作。这与微框架 [Flask] 正好相反:要编写的代码少得多,但要学习的框架更大,许多事情会“自动”发生(会话、加密的 Cookie、防 CSRF 令牌、输入错误之后返回表单)。关于请求生命周期的一章,以及用 [curl] 对请求进行的分析,就是为了让这些过程变得可见;
  • [PHP] 应用程序会在每个请求时重新构建 (示例 01):内存中的任何内容都不会从一个请求保留到下一个请求。任何需要持久保留的内容,都放入会话(单个用户)、缓存(所有用户)、数据库或 Cookie 中。反过来,代码更改无需重启即可生效,失败的请求也绝不会影响后续的请求;
  • 服务容器 创建控制器、中间件和服务,并根据它们的构造函数类型为它们提供依赖项:依赖注入是该框架的核心,正如在 [Spring] 或 [ASP.NET Core] 中所见;
  • 门面 ([Cache::]、[DB::]、[Auth::]、[Hash::]……)和全局函数([view]、[redirect]、[session]、[config]、[__]……)让你可以在任何地方用一行代码访问服务。这非常方便;但这也是隐藏类的依赖项的一种方式,而构造函数注入则会让这些依赖项显而易见;
  • 几乎一切都是中间件:Cookie、会话、防 CSRF 保护、身份验证、授权,以及我们自己的检查(语言、角色、通行证)。同一种机制用于所有请求、一组路由或单个路由;
  • [PHP] 是一种具有运行时类型检查的语言:参数、属性和结果的声明类型([int]、[?Client]、[Collection])在每次调用时都会被检查。自第 8 版起,诸如 [readonly] 类、枚举、构造函数属性提升、具名参数以及空安全运算符([?->])使它成为一门富有表现力且安全的语言;
  • [Eloquent] 遵循 Active Record 模式:模型可以读取和写入自己([Doctor::find(1)], [$doctor->save()]),只需很少的代码。它的查询与其生成的 SQL 非常相似,而监视查询([DB::listen])可以让你验证发送给数据库的内容。必须考虑预加载关联([with]);否则,你很快就会再次遇到“N+1 查询”问题;
  • [Blade] 视图会被编译为 [PHP] 并缓存:它们速度很快,会自动转义所显示的内容,而且它们的组件([<x-field>])使表单保持简洁。

案例研究表明,不依赖 [JavaScript] 的经典 HTML 应用程序仍然是一种简单而稳健的解决方案:每个页面就是一个 URL,浏览器的“后退”按钮可用,并且一切都由服务器控制。对 [JavaScript] 的有限使用(确认窗口)改善了用户体验,而对功能并非必需。[Laravel] 还可以支持交互性更强的应用程序,既可以不离开 [PHP]([Livewire]),也可以配合浏览器端的 [JavaScript] 框架([Inertia],搭配 [Vue.js] 或 [React]):这将在其他文档中介绍。

如需进一步了解,请查阅 [Laravel] 文档(laravel.com/docs),特别是专门介绍请求生命周期、服务容器、验证、[Blade] 和 [Eloquent] 的页面,以及 [PHP] 的文档(php.net/manual/en),[Composer] 一节(getcomposer.org/doc),并将这个应用程序与它的对应版本 [Flask]、[Spring MVC]、[ASP.NET Core MVC]、和 [NestJS] 进行比较。