本文介绍如何拷贝文件。
拷贝小文件
对于小于 1GB 的文件,您可以通过 $ossClient->copyObject 方法将文件从一个存储空间(源存储空间)复制到同一地域的另一个存储空间(目标存储空间)。
说明 此操作的限制条件如下:
- 用户有源文件的读写权限。
- 不支持跨地域拷贝。例如,不支持将杭州存储空间里的文件拷贝到青岛。
- 文件的大小不能超过1GB。
以下代码用于拷贝小文件:
<?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访问或日常运维,请登录 https://console.cloud.tmall.com 创建RAM账号。 $accessKeyId = "<yourAccessKeyId>"; $accessKeySecret = "<yourAccessKeySecret>"; // Endpoint以杭州为例,其它Region请按实际情况填写。 $endpoint = "http://oss-cn-hangzhou.aliyuncs.com"; $from_bucket = "<yourFromBucketName>"; $from_object = "<yourFromObjectName>"; $to_bucket = $bucket; $to_object = $from_object . '.copy'; try{ $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint); $ossClient->copyObject($from_bucket, $from_object, $to_bucket, $to_object); } catch(OssException $e) { printf(__FUNCTION__ . ": FAILED\n"); printf($e->getMessage() . "\n"); return; } print(__FUNCTION__ . ": OK" . "\n");
有关拷贝小文件的详情,请参见CopyObject。
拷贝大文件
对于大于1GB的文件,需要使用分片拷贝(UploadPartCopy)。分片拷贝分为三步:
- 通过$ossClient->initiateMultipartUpload初始化分片拷贝任务。
- 通过$ossClient->uploadPartCopy进行分片拷贝。除最后一个分片外,其它分片都要大于100KB。
- 通过$ossClient->completeMultipartUpload提交分片拷贝任务。
以下代码用于分片拷贝:
<?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访问或日常运维,请登录 https://console.cloud.tmall.com 创建RAM账号。$accessKeyId = "<yourAccessKeyId>"; $accessKeySecret = "<yourAccessKeySecret>"; // Endpoint以杭州为例,其它Region请按实际情况填写。 $endpoint = "http://oss-cn-hangzhou.aliyuncs.com"; $src_bucket = "<yourSourceBucketName>"; $src_object = "<yourSourceObjectName>"; $dst_bucket = "<yourDestinationBucketName>"; $dst_object = "<yourDestinationObjectName>"; // 根据实际情况设置分片大小。 $part_size = 256*1024*1024; try{ $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint); $objectMeta = $ossClient->getObjectMeta($src_bucket, $src_object); $length = $objectMeta['content-length'] + 0; // 初始化分片。 $upload_id = $ossClient->initiateMultipartUpload($dst_bucket, $dst_object); // 逐个分片拷贝。 $pieces = $ossClient->generateMultiuploadParts($length, $part_size); $response_upload_part = array(); $copyId = 1; $upload_position = 0; foreach ($pieces as $i => $piece) { $from_pos = $upload_position + (integer)$piece['seekTo']; $to_pos = (integer)$piece['length'] + $from_pos - 1; $up_options = array( 'start' => $from_pos, 'end' => $to_pos, ); $response_upload_part[] = $ossClient->uploadPartCopy( $src_bucket, $src_object, $dst_bucket, $dst_object, $copyId, $upload_id, $up_options); $copyId = $copyId + 1; } // 完成分片拷贝。 $upload_parts = array(); foreach ($response_upload_part as $i => $etag) { $upload_parts[] = array( 'PartNumber' => ($i + 1), 'ETag' => $etag, ); } $result = $ossClient->completeMultipartUpload($dst_bucket, $dst_object, $upload_id, $upload_parts); } catch(OssException $e) { printf(__FUNCTION__ . ": FAILED\n"); printf($e->getMessage() . "\n"); return; } print(__FUNCTION__ . ": OK" . "\n");
有关拷贝大文件的详情,请参见UploadPartCopy。