Object Storage Service:ファイルダウンローダー (PHP SDK V2)

次のコードを使用して、ダウンローダーのシャードサイズと同時実行数を設定できます。

<?php

// autoload ファイルをインポートして、依存ライブラリが正しくロードされるようにします。
require_once __DIR__ . '/../vendor/autoload.php';

use AlibabaCloud\Oss\V2 as Oss;

// コマンドライン引数の説明を定義します。
$optsdesc = [
    "region" => ['help' => 'The region in which the bucket is located.', 'required' => True], // バケットが配置されているリージョン。(必須)
    "endpoint" => ['help' => 'The domain names that other services can use to access OSS.', 'required' => False], // エンドポイント。(オプション)
    "bucket" => ['help' => 'The name of the bucket', 'required' => True], // バケットの名前。(必須)
    "key" => ['help' => 'The name of the object', '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"];       // オブジェクトの名前。

// 環境変数から資格情報情報をロードします。
// EnvironmentVariableCredentialsProvider を使用して、環境変数から Access Key ID と Access Key Secret を読み取ります。
$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);

// ダウンローダーインスタンスを作成します。
$downloader = $client->newDownloader();

// 分割ダウンロードに関連するパラメーターを定義します。
$partSize = 100 * 1024; // シャードサイズ (バイト単位)。この例では、シャードサイズは 100 KB に設定されています。

// ダウンロードしたコンテンツを保存するローカルファイルパスを定義します。
$filename = "/Users/yourLocalPath/yourFileName"; // ファイルパスの例。
touch($filename); // 空のファイルを作成して、ファイルが存在することを確認します。

// 分割ダウンロード操作を実行します。
$result = $downloader->downloadFile(
    new Oss\Models\GetObjectRequest(
        bucket: $bucket,
        key: $key
    ),
    $filename,
    args: [ // 分割ダウンロードの動作をカスタマイズするために使用されるオプションのパラメーター。
        'part_size' => $partSize, // カスタムシャードサイズ。
        'parallel_num' => 1,      // 並行してダウンロードできるシャードの数。
    ]
);

// ダウンロード結果を出力します。
printf(
    'download status code:' . $result->statusCode . PHP_EOL .
    'download request id:' . $result->requestId . PHP_EOL .
    'download result:' . var_export($result, true) . PHP_EOL
);

<?php

// autoload ファイルをインポートして、依存ライブラリが正しくロードされるようにします。
require_once __DIR__ . '/../vendor/autoload.php';

use AlibabaCloud\Oss\V2 as Oss;

// コマンドライン引数の説明を定義します。
$optsdesc = [
    "region" => ['help' => 'The region in which the bucket is located.', 'required' => True], // バケットが配置されているリージョン。(必須)
    "endpoint" => ['help' => 'The domain names that other services can use to access OSS.', 'required' => False], // エンドポイント。(オプション)
    "bucket" => ['help' => 'The name of the bucket', 'required' => True], // バケットの名前。(必須)
    "key" => ['help' => 'The name of the object', '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"];       // オブジェクトの名前。

// 環境変数から資格情報情報をロードします。
// EnvironmentVariableCredentialsProvider を使用して、環境変数から Access Key ID と Access Key Secret を読み取ります。
$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);

// ダウンローダーインスタンスを作成します。
$downloader = $client->newDownloader();

// ダウンロードしたコンテンツを保存するバッファーストリームを定義します。
$stream = new \GuzzleHttp\Psr7\BufferStream(1 * 1024 * 1024); // バッファーサイズは 1 MB です。

// ダウンロード操作を実行して、オブジェクトコンテンツをバッファーストリームにダウンロードします。
$result = $downloader->downloadTo(
    request: new Oss\Models\GetObjectRequest(
        bucket: $bucket,
        key: $key // ダウンロードするオブジェクトの名前を指定します。
    ),
    stream: $stream, // ダウンロードしたコンテンツを保存する宛先ストリームを指定します。
);

// ダウンロードしたコンテンツを出力します。
printf(
    'download to body:' . $stream->getContents() . PHP_EOL // バッファーストリームのコンテンツを出力します。
);