Laravel Nova 自定义字段CRUD如何对接spatie/media-library
Laravel Nova 自定义字段对接 spatie/media-library 实现富文本图片CRUD
无需重写Nova资源的整套控制器逻辑
Nova的自定义字段本身内置了完整的生命周期挂载能力,不需要全局修改资源的创建、更新、删除流程,只要在字段定义阶段直接绑定对应逻辑即可,这也是多数入门教程没覆盖到的核心能力点——多数教程只讲解了自定义字段的前端Vue组件开发,没有涉及后端逻辑的挂载方式。
可直接使用的字段生命周期钩子
每个Nova自定义字段都支持链式绑定三个核心回调,覆盖完整的CRUD流程:
store():资源创建流程触发,可拿到当前待保存的模型实例、前端提交的原始字段值update():资源更新流程触发,可拿到模型原有属性、前端提交的新字段值delete():资源删除流程触发,可拿到待删除的模型实例
所有回调的执行都嵌套在Nova默认的数据库事务中,任意环节抛出异常都会触发整体回滚,不会出现文本和图片存储不同步的脏数据问题。
对接spatie/media-library的具体逻辑实现
结合你原有前端的base64提交逻辑,三个回调内的处理逻辑可以完全复用你现有控制器的代码,不需要重写图片存储流程:
- 创建流程(store回调内)
- 从前端提交的原始富文本中,通过正则提取所有格式为
data:image/*;base64,*的图片源 - 对每一张提取到的base64内容解码生成临时文件,通过spatie/media-library的接口挂载到当前模型的指定图片集合下
- 将富文本中原有的base64字符串,替换为媒体库生成的公开访问路径
- 返回替换完成后的纯文本内容,存到模型对应的数据库字段中
- 从前端提交的原始富文本中,通过正则提取所有格式为
- 更新流程(update回调内)
- 先取出模型字段的原有值,和新提交的富文本做引用比对
- 提取旧文本中所有关联的媒体库图片路径,和新文本中保留的图片路径做差集,将没有被新文本引用的媒体文件从磁盘和数据库中删除
- 复用创建流程的逻辑,处理新提交内容中夹带的未上传base64图片,生成替换完成的最终文本存库
- 删除流程(delete回调内)
- 直接调用spatie/media-library的集合清理方法,将当前模型关联的、属于该富文本编辑器的所有媒体文件全部清除,避免残留孤立的磁盘文件
实际字段定义示例
在Nova资源的fields()方法中,只要链式绑定对应回调即可,不需要改动其他资源逻辑:
QuillMediaEditor::make('文章内容', 'body') ->store(function (Request $request, $model) { // 复用原有控制器的base64图片解析、存储逻辑 $cleanContent = resolve(RichTextMediaProcessor::class) ->processNewImages($model, $request->input('body')); return ['body' => $cleanContent]; }) ->update(function (Request $request, $model) { $oldContent = $model->getOriginal('body'); // 复用原有控制器的媒体同步、孤立图片清理逻辑 $cleanContent = resolve(RichTextMediaProcessor::class) ->syncExistingImages($model, $oldContent, $request->input('body')); return ['body' => $cleanContent]; }) ->delete(function (Request $request, $model) { // 直接清理该模型关联的富文本图片集合 $model->clearMediaCollection('rich_editor_images'); return true; });
注意事项
- 所有处理逻辑可以抽成独立的服务类复用,不用把代码全堆在Nova资源文件里,和你原有前端控制器的处理逻辑可以共享同一份代码
- 绑定的回调会自动接入Nova默认的权限校验、字段验证流程,和原生字段的行为保持一致,不需要额外做权限适配
内容的提问来源于stack exchange,提问作者Jan
相关产品推荐
相关产品推荐

