追加上传是指通过AppendObject方法在已上传的追加类型文件（Appendable Object）末尾直接追加内容。

使用限制

通过追加上传的方式上传文件时，有如下限制：

  • 如果文件不存在，则调用AppendObject接口会创建一个可追加类型的文件。
  • 如果文件已存在，且为可追加类型文件时，若设置的追加位置和文件当前长度不等，则抛出PositionNotEqualToLength异常。如果文件已存在，且为不可追加类型文件时，则抛出ObjectNotAppendable异常。
  • 追加类型的文件暂不支持CopyObject操作。

有关追加上传的更多信息，请参见AppendObject。

追加上传本地文件

以下代码用于通过追加上传的方式将本地文件examplefilea.txt、examplefileb.txt和examplefilec.txt的内容依次上传到目标存储空间examplebucket中的exampleobject.txt文件。

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
37
<?php
if (is_file(__DIR__ . '/../autoload.php')) {
    require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    require_once __DIR__ . '/../vendor/autoload.php';
}
 
use OSS\OssClient;
use OSS\Core\OssException;
 
// 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
$accessKeyId = "<var class="keyword varname" id="varname-7ps-v4u-o8w">yourAccessKeyId</var>";
$accessKeySecret = "<var class="keyword varname" id="varname-92y-lbm-47e">yourAccessKeySecret</var>";
// <var class="keyword varname" id="varname-q9u-gjl-80g">yourEndpoint</var>填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
$endpoint = "<var class="keyword varname" id="varname-2s9-2ql-poo">yourEndpoint</var>";
// 填写Bucket名称。
$bucket= "examplebucket";
// 设置Object完整路径。Object完整路径中不能包含Bucket名称。
$object = "exampleobject.txt";
// 填写本地文件的完整路径。如果未指定本地路径，则默认从示例程序所属项目对应本地路径中上传文件。
$filePath = "D:\\localpath\\examplefilea.txt";
$filePath1 = "D:\\localpath\\examplefileb.txt";
$filePath1 = "D:\\localpath\\examplefilec.txt";
 
try{
    $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    // 第一次追加上传。第一次追加的位置是0，返回值为下一次追加的位置。后续追加的位置是追加前文件的长度。
    $position = $ossClient->appendFile($bucket, $object, $filePath, 0);
    $position = $ossClient->appendFile($bucket, $object, $filePath1, $position);
    $position = $ossClient->appendFile($bucket, $object, $filePath2, $position);
} catch(OssException $e) {
    printf(__FUNCTION__ . ": FAILED\n");
    printf($e->getMessage() . "\n");
    return;
}
print(__FUNCTION__ . ": OK" . "\n");

关于Bucket名称命名规范的更多信息，请参见存储空间（Bucket）。关于Object名称命名规范的更多信息，请参见对象（Object）。

追加上传字符串

以下代码用于通过追加上传的方式将字符串依次上传到目标存储空间examplebucket中的strexampleobject.txt文件。

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
<?php
if (is_file(__DIR__ . '/../autoload.php')) {
    require_once __DIR__ . '/../autoload.php';
}
if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    require_once __DIR__ . '/../vendor/autoload.php';
}
 
use OSS\OssClient;
use OSS\Core\OssException;
 
// 阿里云账号AccessKey拥有所有API的访问权限，风险很高。强烈建议您创建并使用RAM用户进行API访问或日常运维，请登录RAM控制台创建RAM用户。
$accessKeyId = "<var class="keyword varname" id="varname-kr0-z5x-218">yourAccessKeyId</var>";
$accessKeySecret = "<var class="keyword varname" id="varname-407-eow-0u7">yourAccessKeySecret</var>";
// <var class="keyword varname" id="varname-7f4-299-8hu">yourEndpoint</var>填写Bucket所在地域对应的Endpoint。以华东1（杭州）为例，Endpoint填写为https://oss-cn-hangzhou.aliyuncs.com。
$endpoint = "<var class="keyword varname" id="varname-70t-tc6-j7d">yourEndpoint</var>";
// 填写Bucket名称。
$bucket= "examplebucket";
// 设置Object完整路径。Object完整路径中不能包含Bucket名称。
$object = "strexampleobject.txt";
// 设置依次追加上传的字符串。第一次、第二次以及第三次追加上传后获取的文件内容分别为Hello OSS、Hi OSS以及OSS OK。
$content_array = array('Hello OSS', 'Hi OSS', 'OSS OK');
 
try{
    $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
 
    // 第一次追加上传。第一次追加的位置是0，返回值为下一次追加的位置。后续追加的位置是追加前文件的长度。
    $position = $ossClient->appendObject($bucket, $object, $content_array[0], 0);   
    $position = $ossClient->appendObject($bucket, $object, $content_array[1], $position);  
    $position = $ossClient->appendObject($bucket, $object, $content_array[2], $position);
} catch(OssException $e) {
    printf(__FUNCTION__ . ": FAILED\n");
    printf($e->getMessage() . "\n");
    return;
}
print(__FUNCTION__ . ": OK" . "\n");