372 lines
10 KiB
Markdown
372 lines
10 KiB
Markdown
|
cos-php-sdk-v5 Upgrade Guide
|
|||
|
|
====================
|
|||
|
|
2.6.1 to 2.6.2
|
|||
|
|
---------
|
|||
|
|
修复部分问题
|
|||
|
|
|
|||
|
|
2.6.0 to 2.6.1
|
|||
|
|
---------
|
|||
|
|
1. 多文件打包压缩
|
|||
|
|
2. 文件哈希值计算
|
|||
|
|
3. 文件解压
|
|||
|
|
|
|||
|
|
2.5.6 to 2.6.0
|
|||
|
|
---------
|
|||
|
|
1. 通用文字识别接口
|
|||
|
|
2. 取消存量任务
|
|||
|
|
3. 触发批量存量任务
|
|||
|
|
4. 新增动图模板
|
|||
|
|
5. 新增拼接模板
|
|||
|
|
6. 新增极速高清转码模板
|
|||
|
|
7. 新增图片处理模板
|
|||
|
|
8. 新增截图模板
|
|||
|
|
9. 新增超分辨率模板
|
|||
|
|
10. 新增转码模板
|
|||
|
|
11. 新增精彩集锦模板
|
|||
|
|
12. 新增视频增强模板
|
|||
|
|
13. 新增人声分离模板
|
|||
|
|
14. 新增水印模板
|
|||
|
|
15. 删除工作流
|
|||
|
|
16. 查询存量任务
|
|||
|
|
17. 批量拉取存量任务
|
|||
|
|
18. 查询模版列表
|
|||
|
|
19. 搜索工作流
|
|||
|
|
20. 获取工作流实例详情
|
|||
|
|
21. 获取工作流实例列表
|
|||
|
|
22. 手动触发工作流
|
|||
|
|
23. 更新动图模板
|
|||
|
|
24. 更新拼接模板
|
|||
|
|
25. 更新极速高清转码模板
|
|||
|
|
26. 更新图片处理模板
|
|||
|
|
27. 更新截图模板
|
|||
|
|
28. 更新超分辨率模板
|
|||
|
|
29. 更新转码模板
|
|||
|
|
30. 更新精彩集锦模板
|
|||
|
|
31. 更新视频增强模板
|
|||
|
|
32. 更新人声分离模板
|
|||
|
|
33. 更新水印模板
|
|||
|
|
34. 提交音频降噪任务
|
|||
|
|
35. 图片水印修复
|
|||
|
|
36. 图片处理参数使用demo
|
|||
|
|
37. 开通以图搜图
|
|||
|
|
38. 添加图库图片
|
|||
|
|
39. 图片搜索接口
|
|||
|
|
40. 删除图库图片
|
|||
|
|
41. 绑定数据万象服务
|
|||
|
|
42. 查询数据万象服务
|
|||
|
|
43. 解绑数据万象服务
|
|||
|
|
44. 查询防盗链
|
|||
|
|
45. 设置防盗链
|
|||
|
|
46. 开通原图保护
|
|||
|
|
47. 查询原图保护状态
|
|||
|
|
48. 关闭原图保护
|
|||
|
|
49. 人脸检测
|
|||
|
|
50. 人脸特效
|
|||
|
|
51. 身份证识别
|
|||
|
|
52. 身份证识别-上传时处理
|
|||
|
|
53. 获取数字验证码
|
|||
|
|
54. 获取动作顺序
|
|||
|
|
55. 查询文档预览开通状态
|
|||
|
|
56. 更新文档转码队列
|
|||
|
|
57. 图片审核新增异步审核参数Async，新增部分审核结果参数
|
|||
|
|
58. 媒体处理任务接口新增UserData、JobLevel、CallBackFormat、CallBackType、CallBackMqConfig参数
|
|||
|
|
59. 图片批量审核新增Content参数，可以提交经过base64编码的图片文件内容进行审核
|
|||
|
|
60. 提交视频质量评分任务
|
|||
|
|
61. 提交音视频流分离任务
|
|||
|
|
2.5.5 to 2.5.6
|
|||
|
|
---------
|
|||
|
|
- 创建SDRtoHDR任务
|
|||
|
|
- 创建添加数字水印任务
|
|||
|
|
- 创建提取数字水印任务
|
|||
|
|
- 创建超分任务
|
|||
|
|
- 创建视频标签
|
|||
|
|
- 创建图片处理任务
|
|||
|
|
- 创建转封装任务
|
|||
|
|
- 审核各接口参数修改
|
|||
|
|
- 直播流审核接口
|
|||
|
|
- 取消直播流审核接口
|
|||
|
|
- 修复全球加速region不存在的问题
|
|||
|
|
|
|||
|
|
2.5.4 to 2.5.5
|
|||
|
|
---------
|
|||
|
|
- fix signHost type error
|
|||
|
|
|
|||
|
|
2.5.3 to 2.5.4
|
|||
|
|
---------
|
|||
|
|
- 新增查询是否开通媒体处理接口
|
|||
|
|
- 新增获取pm3u8签名接口
|
|||
|
|
- 新增查询队列列表接口
|
|||
|
|
- 新增更新队列接口
|
|||
|
|
- 新增查询任务接口
|
|||
|
|
- 新增创建多任务接口
|
|||
|
|
- 新增创建截图任务接口
|
|||
|
|
- 新增创建转码任务接口
|
|||
|
|
- 新增创建动图任务接口
|
|||
|
|
- 新增创建拼接任务接口
|
|||
|
|
- 新增创建智能封面任务接口
|
|||
|
|
- 新增创建视频增强任务接口
|
|||
|
|
- 新增创建精彩集锦任务接口
|
|||
|
|
- 新增创建人声分离任务接口
|
|||
|
|
- 修复signHost值获取不到的问题
|
|||
|
|
|
|||
|
|
2.5.2 to 2.5.3
|
|||
|
|
---------
|
|||
|
|
- 增加ETag的兼容逻辑，防止因为特殊框架或者网关规则导致etag undefined
|
|||
|
|
|
|||
|
|
2.5.1 to 2.5.2
|
|||
|
|
---------
|
|||
|
|
- 修复预签名中Headers参数无效的问题
|
|||
|
|
|
|||
|
|
2.5.0 to 2.5.1
|
|||
|
|
---------
|
|||
|
|
- 万象相关接口的DetectType审核类型参数可选
|
|||
|
|
- 万象内容审核接口增加DataId自定义业务标识
|
|||
|
|
- 新增万象网页审核任务相关接口
|
|||
|
|
- 新增部分参数校验
|
|||
|
|
- 修复PHP8.1中将null传递给不可为空的内部函数的问题
|
|||
|
|
|
|||
|
|
2.4.4 to 2.5.0
|
|||
|
|
---------
|
|||
|
|
- 万象支持病毒检测、人声分离任务接口
|
|||
|
|
- 万象转码任务支持多个水印参数/多任务接口/查询接口/列表接口
|
|||
|
|
- 修复签名长期存在的bug
|
|||
|
|
- 修复copy接口404问题，copyObject示例添加注释
|
|||
|
|
- 审核接口增加仅支持https的说明
|
|||
|
|
|
|||
|
|
2.4.3 to 2.4.4
|
|||
|
|
---------
|
|||
|
|
- 修复图片水印签名问题
|
|||
|
|
|
|||
|
|
2.4.2 to 2.4.3
|
|||
|
|
---------
|
|||
|
|
- 优化审核接口返回相关字段
|
|||
|
|
- 增加host开关功能
|
|||
|
|
- GetObject接口支持万象自定义样式
|
|||
|
|
- 修复ip的host bug
|
|||
|
|
|
|||
|
|
2.4.1 to 2.4.2
|
|||
|
|
---------
|
|||
|
|
- 修复图片处理相关接口403签名不对的bug
|
|||
|
|
|
|||
|
|
2.4.0 to 2.4.1
|
|||
|
|
---------
|
|||
|
|
- 增加桶Bucket、GetBucket对应Sample详细注解
|
|||
|
|
- 对部分传入参数进行检查
|
|||
|
|
- 添加doesObjectExist、doesBucketExist对应Sample
|
|||
|
|
- 调整整体项目架构，修复composer依赖问题
|
|||
|
|
- 调整UT
|
|||
|
|
|
|||
|
|
2.3.4 to 2.4.0
|
|||
|
|
---------
|
|||
|
|
- 新增文档转码功能，包括提交、查询、拉取文档预览任务
|
|||
|
|
- 丰富头域参数说明
|
|||
|
|
- 修复预签名中将万象参数作为key报错问题
|
|||
|
|
- 调整travis与action，后续版本保证多版本测试正常
|
|||
|
|
|
|||
|
|
2.3.3 to 2.3.4
|
|||
|
|
---------
|
|||
|
|
- 修复laravel8中guzzlehttp/psr7报错问题,后续重新整理依赖
|
|||
|
|
- 修复putBucketAccelerate接口与目前API不一致的问题
|
|||
|
|
|
|||
|
|
2.3.2 to 2.3.3
|
|||
|
|
---------
|
|||
|
|
- 修复laravel8中guzzlehttp/psr7报错问题
|
|||
|
|
- 清理无用代码
|
|||
|
|
|
|||
|
|
2.3.1 to 2.3.2
|
|||
|
|
---------
|
|||
|
|
- 新增视频截帧，视频信息查询示例
|
|||
|
|
- 新增PUT/GET Bucket Referer示例
|
|||
|
|
- 对于相应接口添加CRC返回信息
|
|||
|
|
- 修复图片审核中ci-process param出现两次的问题
|
|||
|
|
- 修复PHP5.6 版本的依赖问题
|
|||
|
|
- 根据PHP版本自动composer install guzzle6.x或guzzle7
|
|||
|
|
|
|||
|
|
2.3.0 to 2.3.1
|
|||
|
|
---------
|
|||
|
|
- 修复文本检测的返回格式
|
|||
|
|
- 修复sample中的问题
|
|||
|
|
- 新增视频、文本、文档、音频检测
|
|||
|
|
- 新增媒体转码、截图、拼接
|
|||
|
|
|
|||
|
|
2.2.3 to 2.3.0
|
|||
|
|
---------
|
|||
|
|
- 新增图片审核，视频审核，音频审核，文本审核，文档审核接口
|
|||
|
|
- 新增单链接限速demo
|
|||
|
|
- 暴露getPresigned接口Headers和Params参数接口
|
|||
|
|
- 补充textDetect UT
|
|||
|
|
- 修复stream_for废弃问题
|
|||
|
|
- 修复x-cos头检测逻辑问题
|
|||
|
|
- 修复UT部分bug
|
|||
|
|
|
|||
|
|
2.2.2 to 2.2.3
|
|||
|
|
- 在putObejct中新增x-cos-tagging头
|
|||
|
|
- 修复`GetObjectWithoutSign`bug
|
|||
|
|
|
|||
|
|
2.2.1 to 2.2.2
|
|||
|
|
----------
|
|||
|
|
新增appendObject SDK，包括sample,service,test
|
|||
|
|
增加无签名对象下载地址 SDK，包括sample,service,test
|
|||
|
|
增加全球加速相关配置参数
|
|||
|
|
将COS_SECRETID修改为SECRETID、COS_SECRETKEY修改为SECRETKEY，防止混淆
|
|||
|
|
修复部分逻辑代码bug
|
|||
|
|
修复部分拼写错误
|
|||
|
|
- Add `AppendObject` interface
|
|||
|
|
- Add `GetObjectWithoutSign` interface
|
|||
|
|
- Add `allow_accelerate` param to client
|
|||
|
|
- Change const name `COS_SECRETID->SECRETID` `COS_SECRETKEY->SECRETKEY`
|
|||
|
|
- Fix `getPresigned` interface
|
|||
|
|
- Fix typo
|
|||
|
|
|
|||
|
|
2.2.0 to 2.2.1
|
|||
|
|
----------
|
|||
|
|
- Add `PutObjectTagging` interface
|
|||
|
|
- Add `GetObjectTagging` interface
|
|||
|
|
- Add `DeleteObjectTagging` interface
|
|||
|
|
|
|||
|
|
2.1.6 to 2.2.0
|
|||
|
|
----------
|
|||
|
|
- `PutObject` interface supports ci image process
|
|||
|
|
- `GetObject` interface supports ci image process
|
|||
|
|
- Add `ImageInfo` interface, which is used for get image info
|
|||
|
|
- Add `ImageExif` interface, which is used for get image exif
|
|||
|
|
- Add `ImageAve` interface, which is used for get image ave
|
|||
|
|
- Add `ImageProcess` interface, which is used for data processing on cloud
|
|||
|
|
- Add `Qrcode` interface, which is used for qrcode recognition
|
|||
|
|
- Add `QrcodeGenerate` interface, which is used for generate qrcode
|
|||
|
|
- Add `DetectLabel` interface, which is used for detect image label
|
|||
|
|
- Add `PutBucketImageStyle` interface, which is used for add bucket image style
|
|||
|
|
- Add `GetBucketImageStyle` interface, which is used for get bucket image style
|
|||
|
|
- Add `DeleteBucketImageStyle` interface, which is used for delete bucket image style
|
|||
|
|
- Add `PutBucketGuetzli` interface, which is used for open bucket guetzli state
|
|||
|
|
- Add `GetBucketGuetzli` interface, which is used for get bucket guetzli state
|
|||
|
|
- Add `DeleteBucketGuetzli` interface, which is used for close bucket guetzli state
|
|||
|
|
|
|||
|
|
2.1.5 to 2.1.6
|
|||
|
|
----------
|
|||
|
|
- Add `allow_redirects` parameter
|
|||
|
|
- Fix `selectObjectContent` interface
|
|||
|
|
|
|||
|
|
2.1.3 to 2.1.5
|
|||
|
|
----------
|
|||
|
|
- The `download` interface supports breakpoint
|
|||
|
|
- Rename `getPresignetUrl` to `getPresignedUrl`
|
|||
|
|
|
|||
|
|
2.1.2 to 2.1.3
|
|||
|
|
----------
|
|||
|
|
- Add `download` interface, which is used for concurrent block download
|
|||
|
|
- Add callback of `upload` and `download` progress
|
|||
|
|
- Fix request retry
|
|||
|
|
|
|||
|
|
2.1.1 to 2.1.2
|
|||
|
|
----------
|
|||
|
|
- The interface supports custom parameters
|
|||
|
|
- Fix `ListBucketInventoryConfigurations`
|
|||
|
|
|
|||
|
|
2.1.0 to 2.1.1
|
|||
|
|
----------
|
|||
|
|
- Fix bug of urlencode when calculating signature
|
|||
|
|
|
|||
|
|
2.0.9 to 2.1.0
|
|||
|
|
----------
|
|||
|
|
- `upload` support upload with multithread
|
|||
|
|
- Add `retry` params for interface retry
|
|||
|
|
- Support add customer header
|
|||
|
|
- Signature will restrict part of the header and all parameters
|
|||
|
|
- Fix `listBuckets` with `doamin`
|
|||
|
|
|
|||
|
|
2.0.8 to 2.0.9
|
|||
|
|
----------
|
|||
|
|
- Fix bug of `listObjectVersions`
|
|||
|
|
- Update `getObject` with param of `saveas`
|
|||
|
|
|
|||
|
|
2.0.7 to 2.0.8
|
|||
|
|
----------
|
|||
|
|
- Fix presigned url when using tmpSecretId/tmpSecretKey/Token
|
|||
|
|
|
|||
|
|
2.0.6 to 2.0.7
|
|||
|
|
----------
|
|||
|
|
- Fix response of `ListParts`
|
|||
|
|
|
|||
|
|
2.0.5 to 2.0.6
|
|||
|
|
----------
|
|||
|
|
- Support Domain
|
|||
|
|
- Add Select Object Content Interface
|
|||
|
|
- Add Traffic Limit
|
|||
|
|
- Fix bug of object endswith /
|
|||
|
|
|
|||
|
|
2.0.4 to 2.0.5
|
|||
|
|
----------
|
|||
|
|
- Fix bug when upload object with metadata
|
|||
|
|
|
|||
|
|
2.0.3 to 2.0.4
|
|||
|
|
----------
|
|||
|
|
- Fix bug when using ip-port
|
|||
|
|
|
|||
|
|
2.0.2 to 2.0.3
|
|||
|
|
----------
|
|||
|
|
- Fix path parse bug with /0/
|
|||
|
|
|
|||
|
|
2.0.1 to 2.0.2
|
|||
|
|
----------
|
|||
|
|
- Fix bug of `putObject` with `fopen`
|
|||
|
|
- Add ut
|
|||
|
|
|
|||
|
|
|
|||
|
|
2.0.0 to 2.0.1
|
|||
|
|
----------
|
|||
|
|
- Add interface of inventory/tagging/logging
|
|||
|
|
- Fix bug of some interface with query string
|
|||
|
|
|
|||
|
|
|
|||
|
|
1.3 to 2.0
|
|||
|
|
----------
|
|||
|
|
cos-php-sdk-v5 now uses [GuzzleHttp] for HTTP message.
|
|||
|
|
Due to fact, it depending on PHP >= 5.6.
|
|||
|
|
|
|||
|
|
- Use the `Qcloud\Cos\Client\getPresignetUrl()` method instead of the `Qcloud\Cos\Command\createPresignedUrl()`
|
|||
|
|
|
|||
|
|
v2:
|
|||
|
|
```php
|
|||
|
|
$signedUrl = $cosClient->getPresignetUrl($method='putObject',
|
|||
|
|
$args=['Bucket'=>'examplebucket-1250000000', 'Key'=>'exampleobject', 'Body'=>''],
|
|||
|
|
$expires='+30 minutes');
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
v1:
|
|||
|
|
```php
|
|||
|
|
$command = $cosClient->getCommand('putObject', array(
|
|||
|
|
'Bucket' => "examplebucket-1250000000",
|
|||
|
|
'Key' => "exampleobject",
|
|||
|
|
'Body' => '',
|
|||
|
|
));
|
|||
|
|
$signedUrl = $command->createPresignedUrl('+30 minutes');
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
- `$copSource` parameters of the `Qcloud\Cos\Client\Copy` interface are no longer compatible with older versions.
|
|||
|
|
|
|||
|
|
v2:
|
|||
|
|
|
|||
|
|
```php
|
|||
|
|
$result = $cosClient->copy(
|
|||
|
|
$bucket = '<srcBucket>',
|
|||
|
|
$Key = '<srcKey>',
|
|||
|
|
$copySorce = array(
|
|||
|
|
'Region' => '<sourceRegion>',
|
|||
|
|
'Bucket' => '<sourceBucket>',
|
|||
|
|
'Key' => '<sourceKey>',
|
|||
|
|
)
|
|||
|
|
);
|
|||
|
|
```
|
|||
|
|
|
|||
|
|
v1:
|
|||
|
|
```php
|
|||
|
|
$result = $cosClient->Copy(
|
|||
|
|
$bucket = '<srcBucket>',
|
|||
|
|
$key = '<srcKey>',
|
|||
|
|
$copysource = '<sourceBucket>.cos.<sourceRegion>.myqcloud.com/<sourceKey>'
|
|||
|
|
);
|
|||
|
|
```
|
|||
|
|
- Now when uploading files with using `open()` to upload stream, if the local file does not exist, a 0 byte file will be uploaded without throwing an exception, only a warning.
|
|||
|
|
|