PHP V2 用 OSS SDK を使用してバケットを作成する方法 - Object Storage Service

バケットは、オブジェクトを格納するために使用されるコンテナーです。このトピックでは、Object Storage Service (OSS) SDK for PHP を使用してバケットを作成する方法について説明します。

注意事項

このトピックのサンプルコードでは、中国 (杭州) リージョンのリージョン ID cn-hangzhou を使用しています。デフォルトでは、バケット内のリソースにアクセスするためにパブリックエンドポイントが使用されます。バケットが配置されているのと同じリージョン内の他の Alibaba Cloud サービスを使用してバケット内のリソースにアクセスする場合は、内部エンドポイントを使用します。サポートされているリージョンとエンドポイントの詳細については、「OSS のリージョンとエンドポイント」をご参照ください。
oss:PutBucket 権限は、バケットの作成に必要です。詳細については、「RAM ユーザーにカスタムポリシーをアタッチする」をご参照ください。
2025 年 10 月 13 日 10:00 (UTC + 08:00) から、OSS はすべてリージョンで段階的な調整を実施し、API、OSS SDK、または ossutil を使用して作成された新しいバケットに対して、デフォルトでパブリックアクセスをブロックを有効にします。各リージョンで調整が有効になる正確な時間については、[公式発表] 新しく作成されたバケットのパブリックアクセスブロック設定の調整をご覧ください。パブリックアクセスブロックが有効になると、パブリック ACL (パブリック読み取りおよびパブリック読み取り/書き込み) やパブリックアクセスを許可するバケットポリシーなど、パブリックアクセス権限を設定することはできません。ビジネスでパブリックアクセスが必要な場合は、バケットの作成後にこの機能を無効にすることができます。

サンプルコード

以下は、バケットを作成するためのサンプルコードです。

<?php

// オブジェクトと依存ライブラリを自動的にロードします。
require_once __DIR__ . '/../vendor/autoload.php'; 

use AlibabaCloud\Oss\V2 as Oss;

// コマンドラインパラメータを指定します。
$optsdesc = [
    "region" => ['help' => 'バケットが配置されているリージョン。', 'required' => True], // リージョンパラメータは必須です。例: oss-cn-hangzhou。
    "endpoint" => ['help' => '他のサービスが OSS にアクセスするために使用できるドメイン名。', 'required' => False], // エンドポイントパラメータはオプションです。
    "bucket" => ['help' => 'バケットの名前', 'required' => True], // バケットの名前は必須です。
];

// コマンドラインパラメータを解析するための長いオプションのリストを生成します。
$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"; // 必須パラメータが設定されていないことを指定します。
        exit(1); 
    }
}

// コマンドラインパラメータの値を取得します。
$region = $options["region"]; // バケットが配置されているリージョン。
$bucket = $options["bucket"]; // バケットの名前。

// 環境変数から認証情報 (AccessKeyId と AccessKeySecret) をロードします。
$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); 

// バケット作成を開始するためのリクエストを作成します。
$request = new Oss\Models\PutBucketRequest($bucket); 

// putBucket メソッドを呼び出します。
$result = $client->putBucket($request);

// 結果を出力します。
printf(
    'status code:' . $result->statusCode . PHP_EOL . // HTTP ステータスコード。
    'request id:' . $result->requestId // リクエストの一意の ID。
);

Object Storage Service:PHP V2 用 OSS SDK を使用したバケットの作成方法

注意事項

サンプルコード

関連情報