包简介

Aliyun OSS filesystem adapter for Flysystem.

README 文档

README

Flysystem adapter for the oss storage.

鸣谢

iidestiny/flysystem-oss

安装命令

$ composer require "cjz/laravel-flysystem-oss"

要求 php>=8.1 laravel>=10

配置

在 config/filesystems.php 配置文件中添加你的新驱动

 <?php

return [
   'disks' => [
        'aliyunoss' => [ # 键名可以任意取名
            'driver' => 'oss',
            'access_key' => env('OSS_ACCESS_KEY'),
            'access_secret' => env('OSS_ACCESS_SECRET'),
            'bucket' => 'your_bucket',
            'endpoint' => 'https://oss-cn-shanghai.aliyuncs.com', // OSS 外网节点或自定义外部域名，这里需要自己拼写http和https协议前缀。
            'cdnDomain' => '<CDN domain, cdn域名>', // bucket绑定的cdn地址。
            'prefix' => '',//设置上传的根前缀
        ],
    ]
];

常用方法

use Illuminate\Support\Facades\Storage;

$storage = Storage::disk('aliyunoss'); 

Storage::put('1.txt','内容'); # 上传一个文件
Storage::put('1.txt','内容',[Config::OPTION_VISIBILITY=>Visibility::PRIVATE]);# 上传一个私有文件
$request->file('file')->store('1.mp4',['disk'=>'aliyunoss']);# 上传表单中的文件
Storage::url('1.txt');#获取文件对应的完整url

以上方法可在 laravel 文件存储中查阅查阅

获取官方完整 OSS 处理能力

阿里官方 SDK 可能处理了更多的事情，如果你想获取完整的功能可通过此插件获取，然后你将拥有完整的 oss 处理能力

更多功能请查看官方 SDK 手册：https://help.aliyun.com/document_detail/32100.html?spm=a2c4g.11186623.6.1055.66b64a49hkcTHv

cjz/laravel-flysystem-oss 适用场景与选型建议

cjz/laravel-flysystem-oss 是一款基于 PHP 开发的 Composer 扩展包，目前已累计 7 次下载、GitHub Stars 达 3，最近一次更新时间为 2024 年 09 月 29 日，在 PHP 生态内属于活跃度较高的组件。

它主要适用于以下技术方向：「file」「storage」「oss」「Flysystem」「aliyun」「阿�」等业务场景。在实际项目中，围绕这些方向常见需要落地的问题包括：接口对接、性能调优、并发安全、与既有框架（Laravel / ThinkPHP / Yii / Webman 等）的兼容适配，以及生产环境的日志埋点与稳定性保障。

我们在过去多个企业项目中使用过 cjz/laravel-flysystem-oss 或与其功能相近的方案，如果你在选型或落地过程中遇到问题，例如 版本兼容、二次改造、私有化封装、与内部系统对接、生产 BUG 排查，欢迎联系我们协助评估。

围绕 cjz/laravel-flysystem-oss 我们能提供哪些服务？

定制开发 / 二次开发

基于 cjz/laravel-flysystem-oss 在你已有业务上做功能扩展、字段裁剪、UI 适配、与内部账号 / 权限 / 日志系统的深度对接。

BUG 修复 & 性能优化

线上偶发问题、内存泄漏、慢查询、并发异常等排查修复；针对高流量场景做缓存、队列、索引层面的调优。

项目外包 & 长期维护

承接完整的项目从需求 → 设计 → 开发 → 上线 → 长期运维；也可按月提供技术保姆服务。

yvsm@zunyunkeji.com QQ：316430983 微信：yvsm316 西安尊云信息科技 · 专注 PHP / Go / 分布式系统研发