Object Storage Service:シンボリックリンクの管理 (PHP SDK V1)

注意事項

• このトピックでは、中国 (杭州) リージョンのパブリックエンドポイントを使用します。同じリージョン内の他の Alibaba Cloud サービスから OSS にアクセスするには、内部エンドポイントを使用します。サポートされているリージョンとエンドポイントの詳細については、「リージョンとエンドポイント」をご参照ください。

• このトピックでは、OSS エンドポイントを使用して OSSClient インスタンスを作成します。カスタムドメイン名または Security Token Service (STS) を使用して OSSClient インスタンスを作成する場合は、「OssClient の作成」をご参照ください。

• シンボリックリンクを作成するには、oss:PutObject 権限が必要です。シンボリックリンクを取得するには、oss:GetObject 権限が必要です。詳細については、「RAM ユーザーへのカスタム権限の付与」をご参照ください。

シンボリックリンクの作成

次のコードは、シンボリックリンクを作成する方法の例を示しています。

<?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;

// 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
$provider = new EnvironmentVariableCredentialsProvider();
// この例では、中国 (杭州) リージョンのエンドポイントを使用します。実際のエンドポイントに置き換えてください。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// バケット名を指定します。例：examplebucket。
$bucket= "examplebucket";
// シンボリックリンクが指すオブジェクトの名前を指定します。例：exampleobject.txt。
$object = "exampleobject.txt";
// シンボリックリンクの名前を指定します。例：examplesymlink.txt。
$symlink = "examplesymlink.txt";

$options[OssClient::OSS_HEADERS] = array(
    // 同じ名前のオブジェクトを上書きするかどうかを指定します。この例では、値を true に設定して、上書きを禁止します。
    'x-oss-forbid-overwrite'=>"true",
    // オブジェクトのアクセス制御リスト (ACL) を指定します。この例では、ACL を private (非公開) に設定します。これは、オブジェクトの所有者と承認されたユーザーのみが読み取りおよび書き込み権限を持つことを意味します。
    'x-oss-object-acl' =>"private",
    // オブジェクトのストレージクラスを指定します。この例では、ストレージクラスを Standard (標準ストレージ) に設定します。
    'x-oss-storage-class' =>"Standard"
);
try {
    $config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        "region"=> "cn-hangzhou"
    );
    $ossClient = new OssClient($config);
    $ossClient->putSymlink($bucket, $symlink, $object,$options);
} catch (OssException $e) {
    printf($e->getMessage() . "\n");
    return;
}

シンボリックリンクのターゲットオブジェクトの取得

シンボリックリンクを取得するには、そのシンボリックリンクに対する読み取り権限が必要です。次のコードは、シンボリックリンクと、それが指すオブジェクトファイルの名前を取得する方法の例を示しています。

<?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;

// 環境変数からアクセス認証情報を取得します。サンプルコードを実行する前に、OSS_ACCESS_KEY_ID および OSS_ACCESS_KEY_SECRET 環境変数が設定されていることを確認してください。
$provider = new EnvironmentVariableCredentialsProvider();
// この例では、中国 (杭州) リージョンのエンドポイントを使用します。実際のエンドポイントに置き換えてください。
$endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// バケット名を指定します。
$bucket= "examplebucket";
// シンボリックリンクの名前を指定します。
$symlink = "examplesymlink.txt";
try {
    $config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        "region"=> "cn-hangzhou"
    );
    $ossClient = new OssClient($config);
    // シンボリックリンクと、シンボリックリンクが指すオブジェクトの名前を取得します。
    $Symlinks = $ossClient->getSymlink($bucket, $symlink);
} catch (OssException $e) {
    printf(__FUNCTION__ . ": FAILED\n");
    printf($e->getMessage() . "\n");
    return;
}
print(__FUNCTION__ . ": OK" . "\n");
var_dump($Symlinks);            

関連ドキュメント

• シンボリックリンクの完全なサンプルコードについては、「GitHub の例」をご参照ください。

• シンボリックリンクを作成するための API 操作の詳細については、「PutSymlink」をご参照ください。

• シンボリックリンクを取得するための API 操作の詳細については、「GetSymlink」をご参照ください。