如何在Laravel的Cloudder库中添加版本更新后不丢失的自定义方法
给Cloudder包添加可持久化自定义方法的实现方案
核心原则
别直接改vendor目录下Cloudder的源文件——这地方的所有内容,只要你跑一次composer update、升级个包版本,就会被完全覆盖,你临时加的自定义代码百分百会丢。
所有自定义逻辑直接写在你自己项目的app目录下,和第三方包的代码做物理隔离,从根源上避免被版本更新冲掉的问题。
两种可落地的实现方式
方案1:宏扩展(适合核心类已支持Macroable的场景,改动最小)
大部分成熟的Laravel第三方包的核心类都会引入Laravel内置的Macroable trait,支持不修改源码直接绑定自定义方法:
- 不需要新建额外的类,直接在项目默认的
App\Providers\AppServiceProvider的boot()方法中写入宏绑定逻辑即可 - 代码示例:
use JD\Cloudder\Cloudder; public function boot() { // 绑定自定义方法宏 Cloudder::macro('uploadLargeVideo', function ($source, $publicId = null, $uploadOptions = [], $tags = []) { $options = array_merge($uploadOptions, ['resource_type' => 'video']); return $this->upload_large($source, $publicId, $options, $tags); }); }
- 调用方式和原包自带方法完全一致:不管是通过门面
Cloudder::uploadLargeVideo()调用,还是通过容器依赖注入拿到Cloudder实例后调用,行为都和原生方法没有区别。
方案2:容器扩展绑定(通用兼容方案,不受trait限制)
如果Cloudder核心类没有引入Macroable trait,就用Laravel容器的extend能力做扩展,所有场景都能用:
- 在项目自己的
app目录下新建扩展子类,比如app/Extensions/CloudderExtended.php,让这个类继承原Cloudder包的核心类,然后把你要加的uploadLargeVideo方法直接写在这个子类里:
namespace App\Extensions; use JD\Cloudder\Cloudder; class CloudderExtended extends Cloudder { public function uploadLargeVideo($source, $publicId = null, $uploadOptions = array(), $tags = array()) { $options = array_merge($uploadOptions, ['resource_type' => 'video']); return $this->upload_large($source, $publicId, $options, $tags); } }
- 在
AppServiceProvider的register()方法中,通过容器扩展逻辑把原来绑定的Cloudder实例替换成你自己的扩展子类实例:
public function register() { $this->app->extend('cloudder', function ($originalInstance, $container) { // 复用原实例的所有初始化配置,不需要重新写一遍参数注入逻辑 return new CloudderExtended( $originalInstance->getApi(), $originalInstance->getUploader(), $originalInstance->getConfig() ); }); }
效果说明
不管用上面哪种方案,你的自定义代码都完全存在于自己项目的app目录下,和vendor目录的第三方包代码完全隔离:
- 不管Cloudder包本身怎么升级,只要原包的
upload_large方法还存在,你的uploadLargeVideo方法就不会失效 - 不管Laravel框架版本、PHP版本怎么升级,只要语法兼容,自定义方法就一直可用
- 不存在被版本更新自动移除的风险,因为你从来没有修改过vendor目录的文件
内容的提问来源于stack exchange,提问作者jawad ali
相关产品推荐
相关产品推荐

