拽拽
管理员组

PHP 使用 阿里云OSS上传文件详细方法

一、安装阿里云 oss sdk

1、在网站根目录执行下面命令,安装oss sdk。

composer require aliyuncs/oss-sdk-php

安装后,会在 网站根目录/vendor 下找到一个名为 `aliyuncs` 的文件夹。

注:[阿里云 oss - sdk 文档(可不用关注)](https://help.aliyun.com/document_detail/32099.html "官方 oss - sdk 文档")

 
二、使用

1、获取 OSS AccessKeyId、AccessKeySecret

如果没有这两个数据可以参考 如何获取 OSS AccessKeyId、AccessKeySecret 获取。

 
2、简易上传 Html 处理

upload.html

<!DOCTYPE html><html lang="en"><head>    <meta charset="UTF-8">    <title>小卜丢个人站 - oss图片上传</title></head><body>    <form action="oss-image/upload-image.json" method="post" enctype="multipart/form-data">        <label for="file">文件名:</label>        <input type="file" name="image" id="file"><br>        <input type="submit" name="submit" value="提交">    </form></body></html>

 

3、控制器处理 OssImageController.php(直接将请求发送到service,不用关注此层)

<?phpdeclare(strict_types = 1);namespace app\controllers;use app\services\OssImageService;class OssImageController extends BaseController{/**     * oss上传图片     *     * @return string     * @throws \OSS\Core\OssException     */public function actionUploadImage(){return $this->response(OssImageService::service()->uploadImage());}}

 

4、service层处理 OssImageService.php(PHP处理在此层,关注此层即可)

<?phpdeclare(strict_types = 1);namespace app\services;use app\extensions\AliOss;class OssImageService extends BaseService{/**     * oss上传图片     *     * @return array     * @throws \OSS\Core\OssException     */public function uploadImage(){$ossClient  = AliOss::getOssClient();$bucketName = AliOss::getBucketName();// 文件名$fileName = $_FILES['image']['name'];// 临时文件位置$tmpFile = $_FILES['image']['tmp_name'];// 定义文件存储的oss位置$ossPath = 'test/'.date('Y-m-d').'/'.date('Hi') .mt_rand(10000,99999);// 定义oss object$object = $ossPath .'.' .$this->getExtension($fileName);// 执行上传并获取返回 oss 信息$info = $ossClient->uploadFile($bucketName, $object, $tmpFile);$ossUrl = $info['oss-request-url'];// 如果图片的协议是http,则转换成httpsif (substr($ossUrl, 0, 4) == 'http') {$ossUrl = substr_replace($ossUrl, 'https', 0, 4);}$data = ['file_url'  => $ossUrl,'file_name' => basename($ossUrl)];return $data;}/**     * 返回文件扩展名     *     * @param $fileName     * @return mixed     */private function getExtension($fileName){return pathinfo($fileName)['extension'];}}

 

5、oss 实例及参数获取封装 AliOss.php

<?phpdeclare(strict_types = 1);namespace app\extensions;use OSS\OssClient;use OSS\Core\OssException;/** *阿里云oss文件上传 */class AliOss{const endpoint        = 'oss-cn-hongkong.aliyuncs.com';const accessKeyId     = 'LSDFskkdDDSSdkfg';const accessKeySecret = 'LT9cG3JkGKffRPalgk4n33lk8Ll41d';const bucket          = 'hk-server';/**     * 根据Config配置,得到一个OssClient实例     *     * @return OssClient 一个OssClient实例     */public static function getOssClient(){try {$ossClient = new OssClient(self::accessKeyId, self::accessKeySecret, self::endpoint, false);} catch (OssException $e) {printf(__FUNCTION__ . "creating OssClient instance: FAILED\n");printf($e->getMessage() . "\n");return null;}return $ossClient;}public static function getBucketName(){return self::bucket;}}

 

6、结果是可以上传成功并返回图片在oss中的完整访问url的

{status: 1,msg: "success",data: {file_url: "https://hk-server.oss-cn-hongkong.aliyuncs.com/test/2018-08-22/211753008.jpg",file_name: "211753008.jpg"}}

这时,我们访问 https://hk-server.oss-cn-hongkong.aliyuncs.com/test/2018-08-22/211753008.jpg 就可以正常获取到图片了,并且在oss管理控制台也是可以找到上传的文件的。

  这只是将文件上传到 oss 上,并将 文件的 url 返给前端,但还没有将文件的信息存在本地。这里建议前端接收到该url后,连同文件的其他数据(比如分类、文件名等)再请求后端的另外的接口,进行本地数据库的信息存储。

 

三、问题说明

可能会出现 The OSS Access Key Id you provided does not exist in our records 等问题,不要慌,重新生成一下就好了。

另外,遇到这类 阿里云 oss 官方返回的错误时,我们可以参考 oss 官方错误排查 。

 


#1楼
发帖时间:2021-2-16   |   查看数:0   |   回复数:0
游客组