随着互联网技术的不断发展,云存储服务越来越受到人们的重视。阿里云对象存储(OSS)是一个安全、稳定、高扩展性的云端存储服务,用于存储海量数据。本文将介绍如何使用ThinkPHP6框架实现阿里云OSS文件上传和下载操作。
一、创建阿里云OSS Bucket
首先,需要在阿里云官网上创建一个用于存储文件的Bucket。Bucket相当于云端的文件夹,用于存储上传到阿里云OSS的文件。Bucket的创建方式不在本文的介绍范围之内,读者可在阿里云官网平台查阅相关教程。
创建完毕后,需要获取以下三个参数:
1、AccessKeyId:访问OSS的用户ID。
2、AccessKeySecret:访问OSS的用户密钥。
3、Endpoint:OSS服务的地址。
这些参数将在后续代码实现中使用。
二、安装阿里云OSS SDK
在使用阿里云OSS SDK之前,需要安装它。可以使用composer进行安装,命令如下:
composer require aliyuncs/oss-sdk-php
安装完毕后,需要在config目录下创建oss.php配置文件。配置文件中需要包含以下三个参数:
'accessKeyId' => '阿里云AccessKeyId',
'accessSecret' => '阿里云AccessKeySecret',
'endpoint' => 'OSS服务地址',
为了方便配置参数的获取,也可以在.env文件中定义这些参数,在config目录下创建一个oss.php配置文件,如下所示:
'accessKeyId' => env('OSS_ACCESS_KEY_ID'),
'accessSecret' => env('OSS_ACCESS_KEY_SECRET'),
'endpoint' => env('OSS_ENDPOINT'),
三、文件上传操作
在完成了阿里云OSS SDK的安装和参数的配置后,就可以开始进行文件上传操作了。在controller中创建upload方法,代码如下:
use OSSOssClient;
use OSSCoreOssException;
public function upload()
{ $accessKeyId = config('oss.accessKeyId'); $accessKeySecret = config('oss.accessSecret'); $endpoint = config('oss.endpoint'); $bucket = 'your_bucket_name'; // 创建OSSClient实例 try { $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint); } catch (OssException $e) { printf(__FUNCTION__ . "阿里云OSS连接失败:error[%s]
", $e->getMessage());
return; } // 获取文件 $file = request()->file('file'); if (!$file) { return "上传文件不能为空"; } // 上传文件 $fileName = $file->getOriginalName(); $filePath = $file->getRealPath(); try { $result = $ossClient->uploadFile($bucket, $fileName, $filePath); } catch (OssException $e) { return "文件上传失败"; } if (isset($result['oss-request-url'])) { return "文件上传成功"; } else { return "文件上传失败"; } }
在方法中首先获取之前创建Bucket时的三个参数,然后创建OSSClient实例。接着通过request()->file('file')获取上传的文件,使用getOriginalName()方法获取上传文件的原名称,使用getRealPath()方法获取上传文件的临时文件路径。最后,使用uploadFile()方法将文件上传到阿里云OSS。
四、文件下载操作
与文件上传操作类似,文件下载操作也需要使用阿里云OSS SDK。在controller中创建download方法,代码如下:
use OSSOssClient;
use OSSCoreOssException;
public function download()
{ $accessKeyId = config('oss.accessKeyId'); $accessKeySecret = config('oss.accessSecret'); $endpoint = config('oss.endpoint'); $bucket = 'your_bucket_name'; // 创建OSSClient实例 try { $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint); } catch (OssException $e) { printf(__FUNCTION__ . "阿里云OSS连接失败:error[%s]
", $e->getMessage());
return; } // 获取要下载的文件名称 $object = 'your_object_name'; // 下载文件 $content = ''; try { $content = $ossClient->getObject($bucket, $object); } catch (OssException $e) { return "指定的文件不存在"; } if ($content !== '') { // 文件下载操作 } else { return "文件下载失败"; } }
在方法中同样需要获取之前创建Bucket时的三个参数,然后创建OSSClient实例。通过$object获取要下载的文件,使用getObject()方法将文件下载到本地。文件下载操作可以通过header()方法设置文件类型、大小等信息,最后通过echo输出文件内容,实现文件下载操作。