在 Laravel 项目开发中，我们经常需要对 Eloquent 模型进行扩展，以实现诸如灵活搜索、属性映射、元数据管理等功能。如果手动实现这些功能，不仅代码量大，而且容易出错。幸运的是，
sofa/eloquence-base
库提供了一系列强大的 Eloquent ORM 扩展，可以帮助我们轻松应对这些挑战。
sofa/eloquence-base
是一组为 Laravel Eloquent ORM 提供的扩展包，旨在简化和增强模型的功能。它包含以下几个核心扩展：
- Base (Searchable): 提供强大的搜索功能，可以轻松实现全文搜索，甚至可以搜索关联模型的数据。
- Validable: 让模型具备自验证能力，方便进行数据验证。
- Mappable: 允许将模型属性映射到不同的数据表字段或关联模型，实现灵活的数据结构。
- Metable: 提供元数据支持，可以方便地为模型添加额外的属性信息。
- Mutable: 灵活的属性获取和设置修改器，快速设置。
- Mutator: 基于管道的属性修改器。
使用 Composer 安装
sofa/eloquence-base
非常简单：
<pre class="brush:php;toolbar:false;">composer require sofa/eloquence-base
例如，要为一个
Post
模型添加搜索功能，只需在模型中使用
Searchable
trait，并定义
$searchable
属性：
<pre class="brush:php;toolbar:false;">namespace appModels; use IlluminateDatabaseEloquentModel; use SofaEloquenceSearchable; class Post extends Model { use Searchable; protected $searchable = [ 'columns' => [ 'posts.title' => 10, 'posts.content' => 5, 'author.name' => 2, // 搜索关联模型 author 的 name 字段 ], 'joins' => [ 'author' => ['posts.author_id', 'authors.id'], ], ]; public function author() { return $this->belongsTo(Author::class); } }
然后，就可以使用
search()
方法进行搜索：
<pre class="brush:php;toolbar:false;">$posts = Post::search('关键词')->get();
sofa/eloquence-base
极大地简化了 Eloquent 模型的扩展过程，它提供的各种扩展功能可以帮助我们更高效地开发 Laravel 应用。通过使用
sofa/eloquence-base
，我们可以避免重复编写代码，提高开发效率，并保持代码的整洁和可维护性。