一、安裝阿里云 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,不用關注此層)
<?php
declare(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處理在此層,關注此層即可)
<?php
declare(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
<?php
declare(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 官方錯誤排查?。
?
注:免費領取阿里云產品優惠券:https://www.haveyb.com/aliyun-coupon
?
?
?