全部產品
Search

搜尋本產品

    Object Storage Service：PHP追加上傳

    文件中心

    Object Storage Service：PHP追加上傳

    更新時間：Nov 02, 2024

    追加上傳是指通過AppendObject方法在已上傳的追加類型檔案（Appendable Object）末尾直接追加內容。

    注意事項

    • 本文以華東1（杭州）外網Endpoint為例。如果您希望通過與OSS同地區的其他阿里雲產品訪問OSS，請使用內網Endpoint。關於OSS支援的Region與Endpoint的對應關係，請參見OSS地區和訪問網域名稱。

    • 本文以從環境變數讀取存取憑證為例。如何配置訪問憑證，請參見Java配置訪問憑證。

    • 本文以OSS網域名稱建立OSSClient為例。如果您希望通過自訂網域名、STS等方式建立OSSClient，請參見建立OSSClient。

    • 要追加上傳，您必須有oss:PutObject許可權。具體操作，請參見為RAM使用者授權自訂的權限原則。

    • 當檔案不存在時，調用AppendObject介面會建立一個追加類型檔案。

    • 當檔案已存在時：

      • 如果檔案為追加類型檔案，且設定的追加位置和檔案當前長度相等，則直接在該檔案末尾追加內容。

      • 如果檔案為追加類型檔案，但是設定的追加位置和檔案當前長度不相等，則拋出PositionNotEqualToLength異常。

      • 如果檔案為非追加類型檔案時，例如通過簡單上傳的檔案類型為Normal的檔案，則拋出ObjectNotAppendable異常。

    追加上傳字串

    以下代碼用於通過追加上傳的方式將字串依次上傳到目標儲存空間examplebucket中的srcexampleobject.txt檔案。

    <?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以華東1（杭州）為例，其它Region請按實際情況填寫。關於Region與Endpoint對應關係的更多資訊，請參見訪問網域名稱和資料中心。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 填寫Bucket名稱。關於Bucket名稱命名規範的更多資訊，請參見Bucket。
$bucket= "examplebucket";
// 填寫不包含Bucket名稱在內的Object的完整路徑。關於Object名稱命名規範的更多資訊，請參見基本概念。
$object = "srcexampleobject.txt";
// 設定依次追加上傳的字串。第一次、第二次以及第三次追加上傳後擷取的檔案內容分別為Hello OSS、Hi OSS以及OSS OK。
$content_array = array('Hello OSS', 'Hi OSS', 'OSS OK');

$options = array(
    'headers' => array(
        // 指定該Object被下載時的網頁緩衝行為。
        // 'Cache-Control' => 'no-cache',
        // 指定該Object被下載時的名稱。
        // 'Content-Disposition' => 'attachment;filename=oss_download.jpg',
        // 指定該Object的內容編碼格式。
        // 'Content-Encoding' => 'utf-8',
        // 指定到期時間。
        // 'Expires' => 'Fri, 31 Dec 2021 16:57:01 GMT',
        // 指定追加上傳時是否覆蓋同名Object。此處設定為true，表示禁止覆蓋同名Object。
        // 'x-oss-forbid-overwrite' => 'true',
        // 指定上傳該Object的每個part時使用的伺服器端加密方式。
        // 'x-oss-server-side-encryption'=> 'AES256',
        // 指定Object的密碼編譯演算法。
        // 'x-oss-server-side-data-encryption'=>'SM4',
        // 指定Object的儲存類型。
        // 'x-oss-storage-class' => 'Standard',
        // 指定Object的存取權限。
        // 'x-oss-object-acl' => 'private',
        ),
);

try{
    $config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        "region"=> "cn-hangzhou"
    );
    $ossClient = new OssClient($config);

    // 第一次追加上傳。第一次追加的位置是0，傳回值為下一次追加的位置。後續追加的位置是追加前檔案的長度。
    $position = $ossClient->appendObject($bucket, $object, $content_array[0], 0,$options);
    $position = $ossClient->appendObject($bucket, $object, $content_array[1], $position,$options);
    $position = $ossClient->appendObject($bucket, $object, $content_array[2], $position,$options);
} catch(OssException $e) {
    printf(__FUNCTION__ . ": FAILED\n");
    printf($e->getMessage() . "\n");
    return;
}
print(__FUNCTION__ . ": OK" . "\n");

    追加上傳本地檔案

    以下代碼用於通過追加上傳的方式將本地檔案examplefilea.txt、examplefileb.txt和examplefilec.txt的內容依次上傳到目標儲存空間examplebucket中的exampleobject.txt檔案。

     <?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以華東1（杭州）為例，其它Region請按實際情況填寫。
$endpoint = "https://oss-cn-hangzhou.aliyuncs.com";
// 填寫Bucket名稱。
$bucket= "examplebucket";
// 填寫不包含Bucket名稱在內的Object的完整路徑。
$object = "exampleobject.txt";
// 填寫本地檔案的完整路徑。如果未指定本地路徑，則預設從樣本程式所屬專案對應本地路徑中上傳檔案。
$filePath = "D:\\localpath\\examplefilea.txt";
$filePath1 = "D:\\localpath\\examplefileb.txt";
$filePath2 = "D:\\localpath\\examplefilec.txt";

try{
    $config = array(
        "provider" => $provider,
        "endpoint" => $endpoint,
        "signatureVersion" => OssClient::OSS_SIGNATURE_VERSION_V4,
        "region"=> "cn-hangzhou"
    );
    $ossClient = new OssClient($config);
    // 第一次追加上傳。第一次追加的位置是0，傳回值為下一次追加的位置。後續追加的位置是追加前檔案的長度。
    $position = $ossClient->appendFile($bucket, $object, $filePath, 0);
    $position = $ossClient->appendFile($bucket, $object, $filePath1, $position);
    $position = $ossClient->appendFile($bucket, $object, $filePath2, $position);
} catch(OssException $e) {
    printf(__FUNCTION__ . ": FAILED\n");
    printf($e->getMessage() . "\n");
    return;
}
print(__FUNCTION__ . ": OK" . "\n");

    相關文檔

    關於追加上傳的API介面說明，請參見AppendObject。