Object Storage Service:PHP 2.0 版 OSS SDK を使用してオブジェクトのストレージクラスを変換する

CopyObject メソッドを使用して、オブジェクトのストレージタイプを標準からアーカイブに変換できます。

<?php

// 依存関係ライブラリを読み込むために、autoload ファイルをインポートします。
require_once __DIR__ . '/../vendor/autoload.php';

use AlibabaCloud\Oss\V2 as Oss;

// コマンドラインパラメータを定義し、説明します。
$optsdesc = [
    "region" => ['help' => 'バケットが配置されているリージョン。', 'required' => True], // (必須) バケットが配置されているリージョンを指定します。
    "endpoint" => ['help' => '他のサービスが OSS にアクセスするために使用できるドメイン名。', 'required' => False], // (オプション) OSS にアクセスするためのエンドポイントを指定します。
    "bucket" => ['help' => 'バケットの名前', 'required' => True], // (必須) デスティネーションバケットの名前を指定します。
    "key" => ['help' => 'オブジェクトの名前', 'required' => True], // (必須) デスティネーションオブジェクトの名前を指定します。
    "src-bucket" => ['help' => 'ソースバケットの名前', 'required' => False], // (オプション) ソースバケットの名前を指定します。
    "src-key" => ['help' => 'ソースオブジェクトの名前', 'required' => True], // (必須) ソースオブジェクトの名前を指定します。
];

// getopt が必要とする長いオプションのリストに説明を変換します。
// 各パラメータの末尾にコロン (:) を追加して、値が必要であることを示します。
$longopts = \array_map(function ($key) {
    return "$key:";
}, array_keys($optsdesc));

// コマンドラインパラメータを解析します。
$options = getopt("", $longopts);

// 必要なパラメータが設定されているかどうかを確認します。
foreach ($optsdesc as $key => $value) {
    if ($value['required'] === True && empty($options[$key])) {
        $help = $value['help']; // パラメータのヘルプ情報を取得します。
        echo "Error: the following arguments are required: --$key, $help" . PHP_EOL;
        exit(1); // 必要なパラメータが設定されていない場合はプログラムを終了します。
    }
}

// コマンドラインパラメータから解析された値を対応する変数に代入します。
$region = $options["region"]; // バケットが配置されているリージョン。
$bucket = $options["bucket"]; // デスティネーションバケットの名前。
$key = $options["key"]; // デスティネーションオブジェクトの名前。
$srcKey = $options["src-key"]; // ソースオブジェクトの名前。

// 環境変数からアクセス認証情報をロードします。
// EnvironmentVariableCredentialsProvider を使用して、環境変数から AccessKey ID と AccessKey シークレットを取得します。
$credentialsProvider = new Oss\Credentials\EnvironmentVariableCredentialsProvider();

// SDK のデフォルト設定を使用します。
$cfg = Oss\Config::loadDefault();
$cfg->setCredentialsProvider($credentialsProvider); // 認証情報プロバイダーを指定します。
$cfg->setRegion($region); // バケットが配置されているリージョンを指定します。
if (isset($options["endpoint"])) {
    $cfg->setEndpoint($options["endpoint"]); // エンドポイントが提供されている場合は、エンドポイントを指定します。
}

// OSS クライアントインスタンスを作成します。
$client = new Oss\Client($cfg);

// CopyObjectRequest オブジェクトを作成して、ソースオブジェクトをコピーします。
$request = new Oss\Models\CopyObjectRequest(
            bucket: $bucket,
            key: $key,
            sourceKey: $srcKey,
            sourceBucket: $bucket,
            storageClass: 'Archive' // ストレージタイプをアーカイブに設定します。

if (!empty($options["src-bucket"])) {
    $request->sourceBucket = $options["src-bucket"]; // ソースバケット名が指定されている場合は、sourceBucket パラメータを指定します。
}
$request->sourceKey = $srcKey; // ソースオブジェクトの名前を指定します。

// オブジェクトコピー操作を実行します。
$result = $client->copyObject($request);

// オブジェクトコピー結果を表示します。
printf(
    'status code:' . $result->statusCode . PHP_EOL . // HTTP ステータスコード。たとえば、HTTP ステータスコード 200 はリクエストが成功したことを示します。
    'request id:' . $result->requestId . PHP_EOL     // リクエスト ID。リクエストのデバッグまたは追跡に使用できます。
);

ストレージタイプを変換するには、OSS SDK for PHP 2.0 の Copier.Copy メソッドを使用することをお勧めします。このメソッドは、シンプルコピーとマルチパートコピー操作を組み合わせ、指定されたリクエストパラメータに応じて最適な操作をインテリジェントに選択します。

以下は、Copier.Copy メソッドを使用してオブジェクトのストレージタイプを標準からアーカイブに変換するサンプルコードです。

<?php

// 依存関係ライブラリを読み込むために、autoload ファイルをインポートします。
require_once __DIR__ . '/../vendor/autoload.php';

use AlibabaCloud\Oss\V2 as Oss;

// コマンドラインパラメータを定義し、説明します。
$optsdesc = [
    "region" => ['help' => 'バケットが配置されているリージョン。', 'required' => True], // (必須) バケットが配置されているリージョンを指定します。
    "endpoint" => ['help' => '他のサービスが OSS にアクセスするために使用できるドメイン名。', 'required' => False], // (オプション) エンドポイントを指定します。
    "bucket" => ['help' => 'バケットの名前', 'required' => True], // (必須) バケットの名前を指定します。
    "key" => ['help' => 'オブジェクトの名前', 'required' => True], // (必須) デスティネーションオブジェクトの名前を指定します。
    "src-key" => ['help' => 'ソースオブジェクトの名前', 'required' => True], // (必須) ソースオブジェクトの名前を指定します。
];

// getopt が必要とする長いオプションのリストに説明を変換します。
// 各パラメータの末尾にコロン (:) を追加して、値が必要であることを示します。
$longopts = \array_map(function ($key) {
    return "$key:";
}, array_keys($optsdesc));

// コマンドラインパラメータを解析します。
$options = getopt("", $longopts);

// 必要なパラメータが設定されているかどうかを確認します。
foreach ($optsdesc as $key => $value) {
    if ($value['required'] === True && empty($options[$key])) {
        $help = $value['help']; // パラメータのヘルプ情報を取得します。
        echo "Error: the following arguments are required: --$key, $help" . PHP_EOL;
        exit(1); // 必須パラメータが不足している場合はプログラムを終了します。
    }
}

// 解析されたパラメータから値を取得します。
$region = $options["region"]; // バケットが配置されているリージョン。
$bucket = $options["bucket"]; // バケットの名前。
$key = $options["key"];       // デスティネーションオブジェクトの名前。
$srcKey = $options["src-key"]; // ソースオブジェクトの名前。


// 環境変数からアクセス認証情報をロードします。
// EnvironmentVariableCredentialsProvider を使用して、環境変数から AccessKey ID と AccessKey シークレットを取得します。
$credentialsProvider = new Oss\Credentials\EnvironmentVariableCredentialsProvider();

// SDK のデフォルト設定を使用します。
$cfg = Oss\Config::loadDefault();
$cfg->setCredentialsProvider($credentialsProvider); // 認証情報プロバイダーを指定します。
$cfg->setRegion($region); // バケットが配置されているリージョンを指定します。
if (isset($options["endpoint"])) {
    $cfg->setEndpoint($options["endpoint"]); // エンドポイントが提供されている場合は、エンドポイントを指定します。
}

// OSSClient インスタンスを作成します。
$client = new Oss\Client($cfg);

// Copier インスタンスを作成します。
$copier = $client->newCopier();

$dstKey = $key; // デスティネーションオブジェクトの名前。
$copyRequest = new Oss\Models\CopyObjectRequest(
    bucket: $bucket,
    key: $dstKey,
    sourceBucket: $bucket,
    sourceKey: $srcKey,
    storageClass: "Archive");

$result = $copier->copy(
    request: $copyRequest,
);

printf(
    'status code:' . $result->statusCode . PHP_EOL . // HTTP ステータスコード。たとえば、HTTP ステータスコード 200 はリクエストが成功したことを示します。
    'request id:' . $result->requestId . PHP_EOL     // リクエスト ID。リクエストのデバッグまたは追跡に使用できます。
);