如何优雅地为LaravelEloquent模型添加灵活的元数据，并使用kodeine/laravel-meta实现属性式访问

<code class="bash">composer require kodeine/laravel-meta</code>

<code class="bash">php artisan make:migration create_posts_meta_table --create=posts_meta</code>

<pre class="brush:php;toolbar:false;"><?php

use Illuminate\Database\Migrations\Migration;
use Illuminate\Database\Schema\Blueprint;
use Illuminate\Support\Facades\Schema;

class CreatePostsMetaTable extends Migration
{
    /**
     * Run the migrations.
     *
     * @return void
     */
    public function up()
    {
        Schema::create('posts_meta', function (Blueprint $table) {
            $table->bigIncrements('id');

            // 外键，关联到你的模型主键
            $table->bigInteger('post_id')->unsigned();
            $table->foreign('post_id')->references('id')->on('posts')->onDelete('cascade');

            $table->string('type')->default('null'); // 用于存储元数据值的类型，可选
            $table->string('key')->index(); // 元数据的键名，例如 'seo_title'
            $table->text('value')->nullable(); // 元数据的值，使用text类型以存储较长内容

            $table->timestamps();
        });
    }

    /**
     * Reverse the migrations.
     *
     * @return void
     */
    public function down()
    {
        Schema::dropIfExists('posts_meta');
    }
}

<code class="bash">php artisan migrate</code>

<pre class="brush:php;toolbar:false;"><?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Kodeine\Metable\Metable; // 引入 Metable Trait

class Post extends Model
{
    use Metable; // 使用 Metable Trait

    // 如果你的元数据表名或外键名不符合约定，可以在此指定
    // protected $metaTable = 'custom_posts_meta';
    // protected $metaKeyName = 'custom_post_id';

    protected $fillable = ['title', 'body'];
}

<pre class="brush:php;toolbar:false;">use App\Models\Post;

$post = Post::find(1);

// 设置元数据：像设置普通属性一样简单
$post->seo_title = '我的精彩博客文章标题';
$post->seo_description = '这是一篇关于Laravel元数据管理的文章，非常实用！';
$post->views_count = 123; // 也可以存储数字

$post->save(); // 调用 save() 方法时，元数据会自动保存到对应的元数据表中

// 获取元数据：同样像获取普通属性一样
echo $post->seo_title; // 输出: 我的精彩博客文章标题
echo $post->views_count; // 输出: 123

// 检查元数据是否存在
if (isset($post->seo_keywords)) {
    echo $post->seo_keywords;
} else {
    echo 'SEO关键词未设置。';
}

// 移除元数据：使用 unset()
unset($post->views_count);
$post->save(); // 保存后，views_count 这条元数据将被删除

// 也可以使用更明确的方法
$post->setMeta('is_featured', true);
$post->getMeta('is_featured', false); // 获取，如果不存在则返回默认值 false
$post->hasMeta('is_featured');
$post->unsetMeta('is_featured');

// 批量设置元数据
$post->setMeta([
    'author_email' => 'author@example.com',
    'publish_date' => '2023-10-27'
]);
$post->save();

// 查询元数据：通过 `meta()` scope 轻松过滤
$popularPosts = Post::meta()
    ->where('posts_meta.key', 'views_count')
    ->where('posts_meta.value', '>', 100)
    ->get();

// 预加载元数据：避免N+1问题
$postsWithMeta = Post::with('metas')->get();
foreach ($postsWithMeta as $post) {
    echo $post->seo_title;
}

<pre class="brush:php;toolbar:false;">class Post extends Model
{
    use Metable;

    protected $defaultMetaValues = [
        'is_published' => true,
        'comment_enabled' => true,
        'default_language' => 'en',
    ];
}

$post = new Post(['title' => 'New Post']);
$post->save();
echo $post->is_published; // 输出: 1 (true)
// 如果你尝试将 'is_published' 设置为 true，对应的元数据行会被删除，因为这与默认值相同
$post->is_published = true;
$post->save(); // 数据库中不会有 is_published 的记录，但访问时仍会返回 true