一、安装阿里云 oss sdk
1、在网站根目录执行下面命令，安装oss sdk。
composer require aliyuncs/oss-sdk-php
安装后，会在 网站根目录/vendor 下找到一个名为 aliyuncs 的文件夹。
注：阿里云 oss - sdk 文档（可不用关注） "官方 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，则转换成https
if (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: "http://hk-server.oss-cn-hongkong.aliyuncs.com/test/2018-08-22/211753008.jpg",
file_name: "211753008.jpg"
}
}
这时，我们访问 http://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 官方错误排查 。
