PHP 使用 OSS上传文件

PHP   OSS  

一、安装阿里云 oss sdk

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

composer require aliyuncs/oss-sdk-php

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

注:阿里云 oss - sdk 文档(可不用关注)

 

二、使用

1、获取 OSS AccessKeyId、AccessKeySecret

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

 
2、简易上传 Html 处理

upload.html

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

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

  1. <?php
  2. declare(strict_types = 1);
  3. namespace app\controllers;
  4. use app\services\OssImageService;
  5. class OssImageController extends BaseController
  6. {
  7. /**
  8. * oss上传图片
  9. *
  10. * @return string
  11. * @throws \OSS\Core\OssException
  12. */
  13. public function actionUploadImage()
  14. {
  15. return $this->response(OssImageService::service()->uploadImage());
  16. }
  17. }

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

  1. <?php
  2. declare(strict_types = 1);
  3. namespace app\services;
  4. use app\extensions\AliOss;
  5. class OssImageService extends BaseService
  6. {
  7. /**
  8. * oss上传图片
  9. *
  10. * @return array
  11. * @throws \OSS\Core\OssException
  12. */
  13. public function uploadImage()
  14. {
  15. $ossClient = AliOss::getOssClient();
  16. $bucketName = AliOss::getBucketName();
  17. // 文件名
  18. $fileName = $_FILES['image']['name'];
  19. // 临时文件位置
  20. $tmpFile = $_FILES['image']['tmp_name'];
  21. // 定义文件存储的oss位置
  22. $ossPath = 'test/'.date('Y-m-d').'/'.date('Hi') .mt_rand(10000,99999);
  23. // 定义oss object
  24. $object = $ossPath .'.' .$this->getExtension($fileName);
  25. // 执行上传并获取返回 oss 信息
  26. $info = $ossClient->uploadFile($bucketName, $object, $tmpFile);
  27. $ossUrl = $info['oss-request-url'];
  28. // 如果图片的协议是http,则转换成https
  29. if (substr($ossUrl, 0, 4) == 'http') {
  30. $ossUrl = substr_replace($ossUrl, 'https', 0, 4);
  31. }
  32. $data = [
  33. 'file_url' => $ossUrl,
  34. 'file_name' => basename($ossUrl)
  35. ];
  36. return $data;
  37. }
  38. /**
  39. * 返回文件扩展名
  40. *
  41. * @param $fileName
  42. * @return mixed
  43. */
  44. private function getExtension($fileName)
  45. {
  46. return pathinfo($fileName)['extension'];
  47. }
  48. }

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

  1. <?php
  2. declare(strict_types = 1);
  3. namespace app\extensions;
  4. use OSS\OssClient;
  5. use OSS\Core\OssException;
  6. /**
  7. *阿里云oss文件上传
  8. */
  9. class AliOss
  10. {
  11. const endpoint = 'oss-cn-hongkong.aliyuncs.com';
  12. const accessKeyId = 'LSDFskkdDDSSdkfg';
  13. const accessKeySecret = 'LT9cG3JkGKffRPalgk4n33lk8Ll41d';
  14. const bucket = 'hk-server';
  15. /**
  16. * 根据Config配置,得到一个OssClient实例
  17. *
  18. * @return OssClient 一个OssClient实例
  19. */
  20. public static function getOssClient()
  21. {
  22. try {
  23. $ossClient = new OssClient(self::accessKeyId, self::accessKeySecret, self::endpoint, false);
  24. } catch (OssException $e) {
  25. printf(__FUNCTION__ . "creating OssClient instance: FAILED\n");
  26. printf($e->getMessage() . "\n");
  27. return null;
  28. }
  29. return $ossClient;
  30. }
  31. public static function getBucketName()
  32. {
  33. return self::bucket;
  34. }
  35. }

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

  1. {
  2. status: 1,
  3. msg: "success",
  4. data: {
  5. file_url: "http://hk-server.oss-cn-hongkong.aliyuncs.com/test/2018-08-22/211753008.jpg",
  6. file_name: "211753008.jpg"
  7. }
  8. }

  这时,我们访问 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 官方错误排查

 

 



Top