如何在Laravel中使用Spatie/laravel-medialibrary上传无关联模型的媒体文件

在使用Spatie Laravel Medialibrary关联模型上传文件时，用$model->addMediaFromRequest('file')就能快速实现，但要上传不绑定任何业务模型实例的文件，可以通过创建一个通用占位模型来复用包的所有功能，具体步骤如下：

1. 创建通用占位模型 #

新建一个无业务逻辑的模型，仅用于承载媒体文件的关联：

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Spatie\MediaLibrary\HasMedia;
use Spatie\MediaLibrary\InteractsWithMedia;

class UnattachedMedia extends Model implements HasMedia
{
    use InteractsWithMedia;

    protected $table = 'unattached_media';
    protected $fillable = [];
}

2. 生成对应数据表迁移 #

创建迁移文件来存储这个占位模型的实例：

<?php

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

return new class extends Migration
{
    public function up()
    {
        Schema::create('unattached_media', function (Blueprint $table) {
            $table->id();
            $table->timestamps();
        });
    }

    public function down()
    {
        Schema::dropIfExists('unattached_media');
    }
};

执行迁移：

php artisan migrate

3. 使用占位模型上传文件 #

现在就可以像操作普通关联模型一样上传无绑定的文件：

从请求上传 #

$placeholder = new \App\Models\UnattachedMedia();
$media = $placeholder->addMediaFromRequest('file')
    ->toMediaCollection('unattached'); // 自定义集合名，方便分类管理

// 获取上传后的媒体资源信息
$mediaUrl = $media->getUrl();
$mediaId = $media->id;

从本地文件上传 #

$placeholder = new \App\Models\UnattachedMedia();
$media = $placeholder->addMedia('/path/to/local/file.png')
    ->toMediaCollection('unattached');

4. 后续关联到业务模型（可选） #

如果之后需要将这些无绑定文件关联到具体业务模型，直接更新媒体记录的关联字段即可：

// 假设要关联到Post模型的实例$post
$media->update([
    'model_type' => \App\Models\Post::class,
    'model_id' => $post->id,
]);

// 或者使用包内置方法将媒体资源转移到目标模型
$post->addMedia($media)->toMediaCollection('posts');

这种方式完全复用了Spatie Medialibrary的所有特性（如文件转换、存储策略、媒体管理等），避免了单独实现存储逻辑的重复工作。

内容的提问来源于stack exchange，提问作者Ebrahim Bashirpour