如何解决Laravel模型中灵活存储数据的问题？使用spatie/laravel-schemaless-attributes可以！-composer-PHP中文网

如何解决Laravel模型中灵活存储数据的问题？使用spatie/laravel-schemaless-attributes可以！

WBOY

发布： 2025-03-31 14:20:13

原创

429人浏览过

可以通过以下地址学习 Composer：学习地址

在开发 laravel 项目时，常常会遇到需要在模型中存储一些不规则或动态数据的情况。传统的 eloquent 模型要求严格的 schema，这使得灵活存储数据变得困难。最近，我在处理一个项目时遇到了这个问题，尝试了多种方法后，最终通过 spatie/laravel-schemaless-attributes 库解决了这一难题。

问题描述

在我的项目中，需要存储用户的自定义属性，这些属性可能包括各种类型的数据，如字符串、数组、对象等。使用传统的 Eloquent 模型，每次添加新属性都需要修改数据库 schema，这显然不符合灵活性要求。

解决方案

spatie/laravel-schemaless-attributes 库提供了一种在 Eloquent 模型中使用无 schema 属性的方法。它允许你将任意数据存储在一个 JSON 列中，从而实现了类似 NoSQL 的灵活性。

安装

使用 Composer 安装该库非常简单：

composer require spatie/laravel-schemaless-attributes

登录后复制

配置

首先，需要在模型的表中添加一个 JSON 列来存储这些无 schema 属性：

Schema::table('your_models', function (Blueprint $table) {
    $table->schemalessAttributes('extra_attributes');
});

登录后复制

然后，在模型中添加自定义的 cast 和 scope：

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Builder;
use Spatie\SchemalessAttributes\Casts\SchemalessAttributes;

class YourModel extends Model
{
    public $casts = [
        'extra_attributes' => SchemalessAttributes::class,
    ];

    public function scopeWithExtraAttributes(): Builder
    {
        return $this->extra_attributes->modelScope();
    }
}

登录后复制

使用

使用该库后，你可以轻松地添加、获取和更新无 schema 属性：

// 添加属性
$yourModel->extra_attributes->name = 'value';

// 获取属性
$yourModel->extra_attributes->name; // 返回 'value'

// 使用数组方式
$yourModel->extra_attributes['name'] = 'value';
$yourModel->extra_attributes['name']; // 返回 'value'

// 一次设置多个值
$yourModel->extra_attributes = [
   'rey' => ['side' => 'light'],
   'snoke' => ['side' => 'dark']
];

// 使用 set() 方法设置/更新多个值
$yourModel->extra_attributes->set([
   'han' => ['side' => 'light'],
   'snoke' => ['side' => 'dark']
]);

// 使用点符号获取值
$yourModel->extra_attributes->get('rey.side'); // 返回 'light'

// 获取不存在的属性时返回默认值
$yourModel->extra_attributes->get('non_existing', 'default'); // 返回 'default'

// 删除键值对
$yourModel->extra_attributes->forget('key');

登录后复制