chleniang / filesystem-aliyun-oss
TP6 filesystem-aliyun-oss Driver for chleniang/filesystem
v3.0.1
2022-12-20 08:29 UTC
Requires
- aliyuncs/oss-sdk-php: ~2.6
- chleniang/filesystem: ^3.0
This package is auto-updated.
Last update: 2025-03-20 13:11:13 UTC
README
基于
chleniang/filesystem
的阿里云OSS驱动
需求
- php >= 8.0.2 ( league/flysystem ^3.0的要求 )
- ThinkPHP >= 6.0 ( 建议使用6.1 移除了TP framework自带的filesystem )
- chleniang/filesystem
- aliyuncs/oss-sdk-php ~2.6
安装
composer require "chleniang/filesystem-aliyun-oss"
本驱动依赖库
aliyuncs/oss-sdk-php
~2.6
使用
# config/filesystem.php 文件中, 'disks'配置项添加 'aliyun-oss' 配置
// 磁盘列表
'disks' => [
...,
'aliyun' => [ // 磁盘名称,可以任意取(不重复即可)
// 驱动类型,必须是 'aliyun-oss'
'type' => 'aliyun-oss',
// 阿里云主账号AccessKey拥有所有API的访问权限,风险很高。
// 强烈建议您创建并使用RAM账号进行API访问或日常运维 登录 https://ram.console.aliyun.com 创建RAM账号
'accessKeyId' => 'accessKeyIDaccessKeyID',
'accessKeySecret' => 'accessKeySecretaccessKeySecret',
// 访问域名 以杭州为例,"http://oss-cn-hangzhou.aliyuncs.com"
'endpoint' => 'http://oss-cn-xxxxxx.aliyuncs.com',
// 存储空间
'bucket' => '',
// CNAME是指将自定义域名绑定到存储空间上。使用自定义域名时,无法使用listBuckets方法
// 默认false true为开启CNAME
'isCName' => false,
// 默认null from STS
'securityToken' => null,
// 默认null 代理服务器地址,例如 "http://<用户名>:<密码>@<代理ip>:<代理端口>"
'requestProxy' => null,
// Socket层传输数据的超时时间,单位秒; 默认5184000(要用默认值,设置为null即可)
'timeout' => 3600,
// 设置建立连接的超时时间,单位秒; 默认10(要用默认值,设置为null即可)
'connectTimeout' => 10,
// 前缀路径, 此处为迎合TP参数名没有使用 prefix
'root' => '',
]
]
# 使用
\chleniang\filesystem\facade\Filesystem::disk('aliyun')-> ...
阿里云外网访问OSS URL格式
<Schema>://<Bucket>.<外网Endpoint>/<Object>
<Schema>:HTTP或者为HTTPS。
<Bucket>:OSS存储空间名称。
<外网Endpoint>:Bucket所在数据中心供外网访问的Endpoint,各地域Endpoint详情请参见访问域名和数据中心。
<Object>:上传到OSS上的文件的访问路径。
Bucket开启传输加速功能后,会增加如下传输加速Endpoint: > 开启传输加速 <
- 全球加速Endpoint:地址为
oss-accelerate.aliyuncs.com
传输加速接入点分布在全球各地,全球各地的Bucket均可以使用该域名进行传输加速。- 全球加速Endpoint:地址为
oss-accelerate.aliyuncs.com
传输加速接入点分布在全球各地,全球各地的Bucket均可以使用该域名进行传输加速。