OSS云存储

安装

composer require easyswoole/oss

阿里云调用

根据阿里云官方sdk修改,全部方法都一致,走通了所有官方的client请求类单元测试,全部调用方法都和阿里云一致 文档可查看阿里云官方文档:https://help.aliyun.com/document_detail/32099.html?spm=a2c4g.11186623.2.17.de715d26YNLCah#concept-32099-zh

  1. <?php
  2. /**
  3. * Created by PhpStorm.
  4. * User: Tioncico
  5. * Date: 2019/11/20 0020
  6. * Time: 15:28
  7. */
  8. include "./vendor/autoload.php";
  9. include "./phpunit.php";
  10. go(function (){
  11. $config = new \EasySwoole\Oss\AliYun\Config([
  12. 'accessKeyId' => ACCESS_KEY_ID,
  13. 'accessKeySecret' => ACCESS_KEY_SECRET,
  14. 'endpoint' => END_POINT,
  15. ]);
  16. $client = new \EasySwoole\Oss\AliYun\OssClient($config);
  17. $data = $client->putObject('tioncicoxyz','test',__FILE__);
  18. var_dump($data);
  19. });

部分方法没走通单元测试

由于有些方法可能是测试环境问题,未走通,可能出现问题(一般不会有问题),需要大家注意
列出走不通单元测试的方法,以供大家参考:

  • addBucketCname 提示: NoSuchCnameInRecord: No such cname be found in record
  • testDeleteCname 提示: CnameDenied: The cname belongs to another user.

以下2个方法为callback走不通,应该不影响

  • \EasySwoole\Oss\Tests\AliYun\CallbackTest::testMultipartUploadCallbackNormal 提示: CallbackFailed: Response body is not valid json format.
  • \EasySwoole\Oss\Tests\AliYun\CallbackTest::testPutObjectCallbackNormal 走不通

Symlink 类方法全走不通,应该不影响,提示: bucket is not allowed empty或者The specified key does not exist.

七牛云调用

根据七牛云官方sdk修改,走通了oss的大部分单元测试,用法和七牛云oss完全一致

操作文档可直接查看七牛云官方文档 https://developer.qiniu.com/kodo/sdk/1241/php

  1. include "../../vendor/autoload.php";
  2. include "../../phpunit.php";
  3. go(function (){
  4. $auth = new \EasySwoole\Oss\QiNiu\Auth(QINIU_ACCESS_KEY,QINIU_SECRET_KEY);
  5. $key = 'formPutFileTest';
  6. $token = $auth->uploadToken('tioncico', $key);
  7. $upManager = new \EasySwoole\Oss\QiNiu\Storage\UploadManager();
  8. list($ret, $error) = $upManager->putFile($token, $key, __file__, null, 'text/plain', null);
  9. var_dump($ret,$error);
  10. });

部分方法没走通单元测试

由于某些可能是测试环境问题,有部分方法未走通单元测试,需要大家注意,列出走不通的单元测试的方法,以供大家参考

  • \EasySwoole\Oss\Tests\QiNiu\BucketTest::testPrefetch 未走通,提示:{“error”:”bucket source not set”}
  • PfopTest 类方法未走通,提示{“error”:”no such bucket”}
  • \EasySwoole\Oss\Tests\QiNiu\ResumeUpTest::test4ML2 方法未走通,一直卡住,不建议使用该方法上传文件,请使用 \EasySwoole\Oss\Tests\QiNiu\ResumeUpTest::test4ML 方法上传

七牛云设置超时

官方sdk没有设置超时的逻辑,在本组件中新增加了,设置方法如下:

  1. \EasySwoole\Oss\QiNiu\Config::setTimeout(3);
  2. \EasySwoole\Oss\QiNiu\Config::setConnectTimeout(5);

腾讯云调用

腾讯云调用和原来的方法基本一致,操作文档可直接查看腾讯云官方文档:https://cloud.tencent.com/document/product/436/12266

  1. <?php
  2. include "../../vendor/autoload.php";
  3. include "../../phpunit2.php";
  4. go(function (){
  5. //config配置
  6. $config = new \EasySwoole\Oss\Tencent\Config([
  7. 'appId' => TX_APP_ID,
  8. 'secretId' => TX_SECRETID,
  9. 'secretKey' => TX_SECRETKEY,
  10. 'region' => TX_REGION,
  11. 'bucket' => TX_BUCKET,
  12. ]);
  13. //new客户端
  14. $cosClient = new \EasySwoole\Oss\Tencent\OssClient($config);
  15. $key = '你好111.txt';
  16. //生成一个文件数据
  17. $body = generateRandomString(2 * 1024 + 1023);
  18. //上传
  19. $cosClient->upload($bucket = TX_BUCKET,
  20. $key = $key,
  21. $body = $body,
  22. $options = ['PartSize' => 1024 + 1]
  23. );
  24. //获取文件内容
  25. $rt = $cosClient->getObject(['Bucket' => TX_BUCKET, 'Key' => $key]);
  26. var_dump($rt['Body']->__toString());
  27. });
  28. function generateRandomString($length = 10)
  29. {
  30. $characters = '0123456789abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
  31. $randomString = '';
  32. for ($i = 0; $i < $length; $i++) {
  33. $randomString .= $characters[rand(0, strlen($characters) - 1)];
  34. }
  35. return $randomString;
  36. }

补充

大部分方法已经兼容,使用方法和腾讯云官方完全一致,但还有些注意事项:

  • 上传文件使用了SplStream 作为流文件管理
  • 下载文件使用了SplStream 作为流文件管理(上面的$rt[‘Body’]就是SplStream对象)

部分方法没走通单元测试

由于腾讯云sdk使用了guzzle 库,改动非常麻烦,所以有部分单元测试没通过,具体方法如下,希望大家注意:

  • PutBucketAcl 方法,相关的单元测试全部提示Access Denied.(官方sdk也这个提示)
  • copy 方法,小文件提示You have no authority to read the source file 大文件直接无法走通无法使用(官方sdk也走不通)