注意事項(xiàng)

• 本文以華東1（杭州）外網(wǎng)Endpoint為例。如果您希望通過與OSS同地域的其他阿里云產(chǎn)品訪問OSS，請(qǐng)使用內(nèi)網(wǎng)Endpoint。關(guān)于OSS支持的Region與Endpoint的對(duì)應(yīng)關(guān)系，請(qǐng)參見OSS訪問域名、數(shù)據(jù)中心、開放端口。

• 本文以OSS域名新建OSSClient為例。如果您希望通過自定義域名、STS等方式新建OSSClient，請(qǐng)參見新建OssClient。

• 要修改已有文件的元數(shù)據(jù)，您必須具有oss:GetObject和oss:PutObject權(quán)限。具體操作，請(qǐng)參見為RAM用戶授權(quán)自定義的權(quán)限策略。

示例代碼

以下代碼用于修改已有文件的元數(shù)據(jù)。

<?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\Credentials\EnvironmentVariableCredentialsProvider;
use OSS\OssClient;
use OSS\CoreOssException;

// 從環(huán)境變量中獲取訪問憑證。運(yùn)行本代碼示例之前，請(qǐng)確保已設(shè)置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
$provider = new EnvironmentVariableCredentialsProvider();
// Endpoint以華東1（杭州）為例，其它Region請(qǐng)按實(shí)際情況填寫。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 填寫源Bucket名稱，例如srcexamplebucket。
$fromBucket = "srcexamplebucket";
// 填寫源Object的完整路徑。Object完整路徑中不能包含Bucket名稱，例如srcdir/exampleobject.txt。
$fromObject = "<yourFromObjectName>";
// 填寫與源Bucket處于同一地域的目標(biāo)Bucket名稱，例如destexamplebucket。
$toBucket = "destexamplebucket";
// 填寫目標(biāo)Object的完整路徑，完整路徑中不能包含Bucket名稱，例如destdir/exampleobject.txt。
$toObject = "destdir/exampleobject.txt"; 
$copyOptions = array(
    OssClient::OSS_HEADERS => array(
        'Expires' => '2018-10-01 08:00:00',
        'Content-Disposition' => 'attachment; filename="xxxxxx"',
        'x-oss-meta-location' => 'location',
        // 指定設(shè)置目標(biāo)Object元數(shù)據(jù)的方式，此處以指定為'REPLACE'為例，表示忽略源Object的元數(shù)據(jù)，直接采用請(qǐng)求中指定的元數(shù)據(jù)。若設(shè)置為COPY，表示復(fù)制源Object的元數(shù)據(jù)到目標(biāo)Object。
        'x-oss-metadata-directive' => 'REPLACE',
    ),
);
try{
    $config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        "region"=> "cn-hangzhou"
    );
    $ossClient = new OssClient($config);
    // 修改已有文件的元數(shù)據(jù)。
    $ossClient->copyObject($fromBucket, $fromObject, $toBucket, $toObject, $copyOptions);
} catch(OssException $e) {
    printf(__FUNCTION__ . ": FAILED\n");
    printf($e->getMessage() . "\n");
    return;
}
print(__FUNCTION__ . ": OK" . "\n");            

相關(guān)文檔

• 關(guān)于修改已有文件元數(shù)據(jù)的完整示例代碼，請(qǐng)參見GitHub示例。

• 關(guān)于修改已有文件元數(shù)據(jù)的API接口說明，請(qǐng)參見CopyObject。