如何高效地为LaravelEloquent模型添加灵活的扩展：使用sofa/eloquence-mutable解决数据处理痛点

<code class="bash">composer require sofa/eloquence-mutable</code>

<pre class="brush:php;toolbar:false;">class User extends Model
{
    public function setNameAttribute($value)
    {
        $this->attributes['name'] = trim($value);
    }

    public function getNameAttribute($value)
    {
        return ucwords($value);
    }
}

<pre class="brush:php;toolbar:false;">use Illuminate\Database\Eloquent\Model;
use Sofa\Eloquence\Mutable\Mutable;

class User extends Model
{
    use Mutable;

    // 定义需要进行属性转换的字段及其转换器
    protected $mutators = [
        'name' => 'title_case', // 在获取时首字母大写
        'email' => ['trim', 'lowercase'], // 在设置时去除空格并转小写
    ];

    // 定义自定义的转换器方法，命名规则为 mutate{Attribute}{MutatorName}
    // 这些方法会在属性被访问或设置时自动调用
    protected function mutateNameTitleCase($value)
    {
        return ucwords($value); // 示例：将值转换为首字母大写
    }

    protected function mutateEmailTrim($value)
    {
        return trim($value); // 示例：去除值两端的空格
    }

    protected function mutateEmailLowercase($value)
    {
        return strtolower($value); // 示例：将值转换为小写
    }
}

// 实际使用
$user = new User();
$user->name = 'john doe'; // 设置时，不会立即触发 title_case
$user->email = '  TEST@EXAMPLE.COM  '; // 设置时，会先 trim 再 lowercase
$user->save(); // 保存到数据库

// 再次获取时
$retrievedUser = User::find($user->id);
echo $retrievedUser->name; // 输出：John Doe (因为 title_case mutator 在获取时被应用)
echo $retrievedUser->email; // 输出：test@example.com (因为 trim 和 lowercase mutator 在设置时被应用)

<pre class="brush:php;toolbar:false;">use Illuminate\Database\Eloquent\Model;
use Sofa\Eloquence\Validable\Validable;

class Post extends Model
{
    use Validable;

    // 直接在模型中定义验证规则
    protected static $rules = [
        'title' => 'required|min:5|max:255',
        'body' => 'required',
        'author_id' => 'required|exists:users,id',
    ];

    // ... 其他模型逻辑
}

// 使用时
$post = new Post(['title' => 'short', 'body' => '']);
if (!$post->isValid()) {
    echo "验证失败！";
    print_r($post->getErrors()->all()); // 获取验证错误信息
} else {
    $post->save();
}

<pre class="brush:php;toolbar:false;">use Illuminate\Database\Eloquent\Model;
use Sofa\Eloquence\Searchable\Searchable;

class Product extends Model
{
    use Searchable;

    // 定义可搜索的字段及其权重
    protected $searchableColumns = [
        'name' => 10, // 名字匹配权重更高
        'description' => 5,
        'category.name' => 3, // 可以搜索关联模型的字段
    ];

    public function category()
    {
        return $this->belongsTo(Category::class);
    }
}

// 使用时
$results = Product::search('red shirt')->get(); // 搜索包含 "red shirt" 的产品
$results = Product::search('apple')->orderBy('relevance', 'desc')->get(); // 按相关性排序