注意事項(xiàng)

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

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

• 要?jiǎng)?chuàng)建軟鏈接，您必須具有oss:PutObject權(quán)限；要獲取軟鏈接，您必須具有oss:GetObject權(quán)限。具體操作，請參見為RAM用戶授權(quán)自定義的權(quán)限策略。

創(chuàng)建軟鏈接

以下代碼用于創(chuàng)建軟鏈接：

<?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)行本代碼示例之前，請確保已設(shè)置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
$provider = new EnvironmentVariableCredentialsProvider();
// Endpoint以華東1（杭州）為例，其他Region請按實(shí)際情況填寫。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 填寫B(tài)ucket名稱，例如examplebucket。
$bucket= "examplebucket";
// 指定軟鏈接指向的目標(biāo)Object名稱，例如exampleobject.txt。
$object = "exampleobject.txt";
// 指定軟鏈接名稱，例如examplesymlink.txt。
$symlink = "examplesymlink.txt";

$options[OssClient::OSS_HEADERS] = array(
    // 指定創(chuàng)建軟鏈接時(shí)是否允許覆蓋同名目標(biāo)Object。此處設(shè)置為true，表示禁止覆蓋同名目標(biāo)Object。
    'x-oss-forbid-overwrite'=>"true",
    // 指定Object的訪問權(quán)限。此處設(shè)置為private，表示私有權(quán)限。即只有Object的擁有者和授權(quán)用戶有該Object的讀寫權(quán)限，其他用戶沒有權(quán)限操作該Object。
    'x-oss-object-acl' =>"private",
    // 指定Object的存儲類型。此處設(shè)置為Standard，表示標(biāo)準(zhǔn)存儲類型。
    '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;
}

獲取軟鏈接指向的目標(biāo)文件名稱

獲取軟鏈接要求您對該軟鏈接有讀權(quán)限。以下代碼用于獲取軟鏈接以及軟鏈接指向的目標(biāo)文件名稱：

<?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)行本代碼示例之前，請確保已設(shè)置環(huán)境變量OSS_ACCESS_KEY_ID和OSS_ACCESS_KEY_SECRET。
$provider = new EnvironmentVariableCredentialsProvider();
// Endpoint以杭州為例，其它Region請按實(shí)際情況填寫。
$endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
// 填寫B(tài)ucket名稱。
$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);
    // 獲取軟鏈接以及軟鏈接指向的目標(biāo)文件名稱。
    $Symlinks = $ossClient->getSymlink($bucket, $symlink);
} catch (OssException $e) {
    printf(__FUNCTION__ . ": FAILED\n");
    printf($e->getMessage() . "\n");
    return;
}
print(__FUNCTION__ . ": OK" . "\n");
var_dump($Symlinks);            

相關(guān)文檔

• 關(guān)于軟鏈接的完整示例代碼，請參見GitHub示例。

• 關(guān)于創(chuàng)建軟鏈接的API接口說明，請參見PutSymlink。

• 關(guān)于獲取軟鏈接的API接口說明，請參見GetSymlink。