在开发 laravel 应用时,我经常遇到需要在视图中展示一些经过格式化的数据。例如,我需要将用户的注册时间显示为“X天前”的格式,或者将用户的名字和姓氏拼接成完整的姓名。如果直接在 Blade 模板中编写这些逻辑,会导致模板变得臃肿不堪,难以维护。如果将这些逻辑放在 Model 中,又会使 Model 承担过多的职责,违反了单一职责原则。
这时,laracasts/presenter 就派上了大用场。它允许你创建一个 presenter 类,专门用于处理视图数据的格式化逻辑。
安装 Laracasts/Presenter 非常简单,只需要使用 composer:
composer require laracasts/presenter
接下来,你需要创建一个 Presenter 类。例如,如果你有一个 User 模型,你可以创建一个 UserPresenter 类:
<?php namespace AppPresenters; use LaracastsPresenterPresenter; class UserPresenter extends Presenter { public function fullName() { return $this->entity->first_name . ' ' . $this->entity->last_name; } public function registeredAtHuman() { return $this->entity->created_at->diffForHumans(); } }
在这个 Presenter 类中,你可以定义各种方法来格式化你的数据。$this->entity 属性可以访问到你的模型实例。
然后,在你的模型中使用 LaracastsPresenterPresentableTrait trait,并指定你的 Presenter 类:
<?php namespace AppModels; use IlluminateDatabaseEloquentModel; use LaracastsPresenterPresentableTrait; class User extends Model { use PresentableTrait; protected $presenter = 'AppPresentersUserPresenter'; }
现在,你就可以在你的视图中使用 Presenter 类来格式化数据了:
<h1>Hello, {{ $user->present()->fullName }}</h1> <p>Registered {{ $user->present()->registeredAtHuman }}</p>
$user->present() 方法会返回你的 Presenter 实例,你可以通过它来调用 Presenter 类中定义的方法。
使用 Laracasts/Presenter 的优点:
- 代码清晰: 将视图数据的格式化逻辑从视图和模型中分离出来,使代码更易于阅读和理解。
- 易于维护: 如果你需要修改数据的格式化方式,只需要修改 Presenter 类即可,无需修改视图或模型。
- 可测试性: Presenter 类可以独立进行单元测试,确保数据的格式化逻辑正确无误。
- 提高开发效率: 减少视图模板的复杂度,将视图展示相关的逻辑集中到一个地方,方便团队协作开发
总之,Laracasts/Presenter 是一个非常实用的 Laravel 扩展包,可以帮助你编写更清晰、更易于维护的代码。如果你正在开发 Laravel 应用,强烈建议你尝试使用它。
Composer在线学习地址:学习地址