* Expires(\DateTime, 可选) - Expires请求头，表示Object的过期时间
* UserMetadata(array, 可选) - 用户自定义元数据，如 array('key1' => 'value1', 'key2' => 'value2')
*
* @return Models\PutObjectResult
*/
public function putObject(array $options) {
return $this->execute(__FUNCTION__, $options);
}
/**
* 列出指定Bucket下的Object
*
* @param array $options 可以包含以下Key:
* Bucket(string, 必选) - Bucket的名称
* Prefix(string, 可选) - 限定返回的Object key必须以prefix作为前缀。
* Marker(string, 可选) - 用户设定结果从marker之后按字母排序的第一个开始返回。
* MaxKeys(string, 可选) - 用于限定此次返回object的最大数，如果不设定，默认为100。
* Delimiter(string, 可选) - 用于对Object名字进行分组的字符。
*
* @return Models\ObjectListing
*/
public function listObjects(array $options) {
return $this->execute(__FUNCTION__, $options);
}
/**
* 获取一个Object
*
* @param array $options 可以包含以下Key:
* Bucket(string, 必选) - Bucket的名称
* Key(string, 必选) - Object的Key
* Range(array, 可选) - 指定返回的字节范围，如设定为 array(0, 9) 则返回第0到9个字节的内容
* SaveAs(string, 可选) - 用于指定Object保存的文件路径，此时返回的OSSObject中content为空。
* MetaOnly(bool, 可选) - 此项为true的话则只获取Object的元信息而不获取具体内容，默认为false。
* ModifiedSinceConstraint(\DateTime, 可选) - 如果指定的时间早于实际修改时间，则正常返回Object。
* UnmodifiedSinceConstraint(\DateTime, 可选) - 如果传入参数中的时间等于或者晚于文件实际修改时间，则正常返回Object。
* MatchingETagConstraints(array, 可选) - 指定一组ETag，如果传入期望的ETag和object的 ETag匹配，则正常返回Object。
* NoMatchingETagConstraints(array, 可选) - 指定一组ETag，如果传入的ETag值和Object的ETag不匹配，则正常返回Object。
* ResponseCacheControl(string, 可选) - 指定返回的Http头Cache-Control
* ResponseContentDisposition(string, 可选) - 指定返回的Http头Content-Disposition
* ResponseContentEncoding(string, 可选) - 指定返回的Http头Content-Encoding
* ResponseContentLanguage(string, 可选) - 指定返回的Http头Content-Language
* ResponseContentType(string, 可选) - 指定返回的Http头Content-Type
* ResponseExpires(string, 可选) - 指定返回的Http头Expires
*
* @return Models\OSSObject
*/
public function getObject(array $options) {
return $this->execute(__FUNCTION__, $options);
}
/**
* 获取Object的元数据，OSSObject中不包含Object的内容
*
* @param array $options 可以包含以下Key:
* Bucket(string, 必选) - Bucket的名称
* Key(string, 必选) - Object的Key
* ModifiedSinceConstraint(\DateTime, 可选) - 如果指定的时间早于实际修改时间，则执行复制。
* UnmodifiedSinceConstraint(\DateTime, 可选) - 如果传入参数中的时间等于或者晚于文件实际修改时间，则执行复制。
* MatchingETagConstraints(array, 可选) - 指定一组ETag，如果传入期望的ETag和object的 ETag匹配，则执行复制。
* NoMatchingETagConstraints(array, 可选) - 指定一组ETag，如果传入的ETag值和Object的ETag不匹配，则执行复制。
*
* @return Models\OSSObject
*/
public function getObjectMetadata(array $options) {
$options[OSSOptions::META_ONLY] = true;
return $this->getObject($options);
}
/**
* 删除一个Object
*
* @param array $options 可以包含以下Key:
* Bucket(string, 必选) - 要删除的Object所在的Bucket
* Key(string, 必选) - 要删除的Object的Key
*
* @return void
*/
public function deleteObject(array $options) {
return $this->execute(__FUNCTION__, $options);
}
/**
* 拷贝一个在OSS上已经存在的Object为另外一个Object。
*
* @param array $options 可以包含以下Key:
* SourceBucket(string, 必选) - 复制的源Bucket
* SourceKey(string, 必选) - 复制的的源Object的Key
* DestBucket(string, 必选) - 复制的目的Bucket
* DestKey(string, 必选) - 复制的目的Object的Key
* ContentDisposition(string, 可选) - Content-Disposition请求头，表示MIME用户代理如何显示附加的文件。
* CacheControl(string, 可选) - Cache-Control请求头，表示用户指定的HTTP请求/回复链的缓存行为。
* ContentEncoding(string, 可选) - Content-Encoding请求头，表示Object内容的编码方式。
* ContentType(string, 可选) - Content-Type请求头，表示Object内容的类型，为标准的MIME类型。
* Expires(\DateTime, 可选) - Expires请求头，表示Object的过期时间
* UserMetadata(array, 可选) - 用户自定义元数据，如 array('key1' => 'value1', 'key2' => 'value2')
* 如果用户在请求中指定了任意一项Object的元数据（ContentDisposition，CacheControl，ContentEncoding，ContentType，Expires， UserMetadata）
* 则使用新的元数据，否则直接使用源Object的源数据。
*
*
* @return Models\CopyObjectResult
*/
public function copyObject(array $options) {
return $this->execute(__FUNCTION__, $options);
}
/**
* 初始化一个Multipart上传事件。
*
* 使用Multipart模式上传数据前，必须先调用该接口来通过OSS初始化一个Multipart上传事件。
* 该接口会返回一个OSS服务器创建的全局唯一的Upload ID，用于标识本次Multipart上传事件。
* 用户可以根据这个ID来发起相关的操作，如中止、查询Multipart上传等。
*
*
* @param array $options 可以包含以下Key:
* Bucket(string, 必选) - Object所要分块上传到的Bucket名称
* Key(string, 必选) - 所要分块上传的Object的Key
* Content(string|resource, 必选) - 所要上传Object的内容
* ContentLength(int, 可选) - 所要上传的Object的大小，如果Content为resource类型，ContentLength为必选
* ContentDisposition(string, 可选) - Content-Disposition请求头，表示MIME用户代理如何显示附加的文件。
* CacheControl(string, 可选) - Cache-Control请求头，表示用户指定的HTTP请求/回复链的缓存行为。
* ContentEncoding(string, 可选) - Content-Encoding请求头，表示Object内容的编码方式。
*
* Expires(\DateTime, 可选) - Expires请求头，表示Object的过期时间
* UserMetadata(array, 可选) - 用户自定义元数据，如 array('key1' => 'value1', 'key2' => 'value2')
*
* @return Models\InitiateMultipartUploadResult
*/
public function initiateMultipartUpload(array $options) {
return $this->execute(__FUNCTION__, $options);
}
/**
* 列出所有执行中的 Multipart上传事件。
*
* 即已经被初始化的 Multipart Upload 但是未被完成或被终止的 Multipart上传事件。
* OSS返回的罗列结果中最多会包含1000个Multipart上传事件。
*
*
* @param array $options 可以包含以下Key:
* Bucket(string, 必选) - Bucket的名称
* Delimiter(string, 可选) - 用于对Object名字进行分组的字符。所有名字包含指定的前缀且第一次出现delimiter字符之间的object作为一组元素——CommonPrefixes。
* KeyMarker(string, 可选) - 设置一个标识表示从哪里返回列表。
* MaxUploads(string, 可选) - 设置限制的最大返回记录数。最大值和默认值均为1000。
* Prefix(string, 可选) - 限定返回的object key必须以prefix作为前缀。
* UploadIdMarker(string, 可选) - 设置一个标识表示从哪里返回列表。
*
* @return Models\MultipartUploadsListing
*/
public function listMultipartUploads(array $options) {
return $this->execute(__FUNCTION__, $options);
}
/**
* 上传一个分块（Part）到指定的的Multipart上传事件中。
*
* @param array $options 可以包含以下Key:
* Bucket(string, 必选) - Object所要分块上传到的Bucket名称
* Key(string, 必选) - 所要分块上传的Object的Key
* UploadId(string, 必选) - 设置标识Multipart上传事件的Upload ID。
* Content(string|resource, 必选) - 上传块的内容。
* ParNumber(int, 必选) - 上传分块（Part）的标识号码
* PartSize(int, 必选) - 本块的长度
*
* @return Models\UploadPartResult
*/
public function uploadPart(array $options) {
return $this->execute(__FUNCTION__, $options);
}
/**
* 列出multipart上传事件中上传的所有part信息
*
* @param array $options 可以包含以下Key:
* Bucket(string, 必选) - 上传事件所在Bucket名称
* Key(string, 必选) - 上传事件的Object的Key
* UploadId(string, 必选) - 标识Multipart上传事件的Upload ID。
* MaxParts(int, 可选) - 设置一个值最大返回多少条记录。最大值和默认值均为1000。
* PartNumberMarker(int, 可选) - 设置一个值表示从哪个Part号码开始获取列表。
*
* @return Models\PartListing
*/
public function listParts(array $options) {
return $this->execute(__FUNCTION__, $options);
}
/**
* 撤销一个分块上传的事件
*
* @param array $options 可以包含以下Key:
* Bucket(string, 必选) - 上传事件所在Bucket名称
* Key(string, 必选) - 上传事件的Object的Key
* UploadId(string, 必选) - 标识Multipart上传事件的Upload ID。
*
* @return void
*/
public function abortMultipartUpload(array $options) {
return $this->execute(__FUNCTION__, $options);
}
/**
* 完成分块上传
*
* @param array $options 可以包含以下Key:
* Bucket(string, 必选) - 上传事件所在Bucket名称
* Key(string, 必选) - 上传事件的Object的Key
* UploadId(string, 必选) - 标识Multipart上传事件的Upload ID。
* PartETags(array, 必选) - 返回标识上传Part结果的PartETag列表，PartETag也是一个array
* 里面存在两个元素，分别为PartNumber和ETag。
*
*
* @return Models\CompleteMultipartUploadResult
*/
public function completeMultipartUpload(array $options) {
return $this->execute(__FUNCTION__, $options);
}
/**
* 生成预签名URL
*
* @param array $options 可以包含以下Key:
* Bucket(string, 必选) - 签名Object所在的Bucket
* Key(string, 必选) - 签名的Object的Key
* Expires(\DateTime, 必选) - 签名过期时间
* ContentType(string, 可选) - 签名Object的内容类型
* ResponseCacheControl(string, 可选) - 指定返回的Http头Cache-Control （获取Object使用）
* ResponseContentDisposition(string, 可选) - 指定返回的Http头Content-Disposition（获取Object使用）
* ResponseContentEncoding(string, 可选) - 指定返回的Http头Content-Encoding（获取Object使用）
* ResponseContentLanguage(string, 可选) - 指定返回的Http头Content-Language（获取Object使用）
* ResponseContentType(string, 可选) - 指定返回的Http头Content-Type（获取Object使用）
* ResponseExpires(string, 可选) - 指定返回的Http头Expires（获取Object使用）
* UserMetadata(array, 可选) - 用户自定义元数据（上传Object使用），如 array('key1' => 'value1', 'key2' => 'value2')
*
* @return mixed
*/
public function generatePresignedUrl(array $options) {
$command = new GeneratePresignedUrlCommand(__FUNCTION__);
return $command->execute($this->getClientOptions(), $options);
}
protected function __construct(array $config) {
// Merge config with default config
$config = array_merge(
ResourceManager::getInstance()->getDefaultOptions(__DIR__),
$config
);
// To ensure contains import args
AssertUtils::assertSet(array(
OSSOptions::ENDPOINT,
OSSOptions::ACCESS_KEY_ID,
OSSOptions::ACCESS_KEY_SECRET,
), $config);
// Config client
$this->endpoint = $config[OSSOptions::ENDPOINT];
$this->credentials = array(
OSSOptions::ACCESS_KEY_ID => $config[OSSOptions::ACCESS_KEY_ID],
OSSOptions::ACCESS_KEY_SECRET => $config[OSSOptions::ACCESS_KEY_SECRET],
);
// Creat service client
$this->serviceClient = ServiceClientFactory::factory()->createService($config);
}
protected function getClientOptions() {
return array(
OSSOptions::ENDPOINT => $this->endpoint,
OSSOptions::ACCESS_KEY_ID => $this->credentials[OSSOptions::ACCESS_KEY_ID],
OSSOptions::ACCESS_KEY_SECRET => $this->credentials[OSSOptions::ACCESS_KEY_SECRET],
);
}
protected function execute($method, $options) {
$className = ucfirst($method).'Command';
$class = 'Aliyun\\OSS\\Commands\\'.$className;
$clientOptions = $this->getClientOptions();
$command = new $class($method);
$command->setService($this->serviceClient);
return $command->execute($clientOptions, $options);
}
}