阿里雲團隊努力不懈，力求將最新的技術內容更快地以您最熟悉的語言呈現。本文由簡體中文內容自動轉碼而成，過程無人工干預。阿里雲不保證此自動轉碼的準確性、完整性及時效性。因轉碼造成的任何內容錯誤及因此可能帶來的損失，阿里雲概不負責，敬請見諒。本文内容請以簡體中文版本為準。
全部產品
Search

搜尋本產品

    上傳檔案

    文件中心
    產品詳情

    上傳檔案

    更新時間： Oct 19, 2018

    在OSS中，操作的基本資料單元是檔案（Object）。OSS PHP SDK提供了豐富的檔案上傳方式：

    說明： 各種上傳方式的適用場景請參見開發指南中的上傳檔案。

    字元串上傳

    以下代碼用於上傳字元串到OSS中：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. // 儲存空間名稱
    18. $bucket= "<yourBucketName>";
    19. // 檔案名稱
    20. $object = "<yourObjectName>";
    21. // 檔案內容
    22. $content = "Hello OSS";
    23. try{
    24.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    26.     $ossClient->putObject($bucket, $object, $content);
    27. } catch(OssException $e) {
    28.     printf(__FUNCTION__ . ": FAILED\n");
    29.     printf($e->getMessage() . "\n");
    30.     return;
    31. }
    32. print(__FUNCTION__ . ": OK" . "\n");

    檔案上傳

    以下代碼用於上傳檔案到OSS中：

    1. <?php
    2. <?php
    3. if (is_file(__DIR__ . '/../autoload.php')) {
    4.     require_once __DIR__ . '/../autoload.php';
    5. }
    6. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    7.     require_once __DIR__ . '/../vendor/autoload.php';
    8. }
    10. use OSS\OssClient;
    11. use OSS\Core\OssException;
    13. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    14. $accessKeyId = "<yourAccessKeyId>";
    15. $accessKeySecret = "<yourAccessKeySecret>";
    16. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    17. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    18. // 儲存空間名稱
    19. $bucket= "<yourBucketName>";
    20. // 檔案名稱
    21. $object = "<yourObjectName>";
    22. // <yourLocalFile>由本地檔案路徑加檔案名包括尾碼組成，例如/users/local/myfile.txt
    23. $filePath = "<yourLocalFile>";
    25. try{
    26.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    28.     $ossClient->uploadFile($bucket, $object, $filePath);
    29. } catch(OssException $e) {
    30.     printf(__FUNCTION__ . ": FAILED\n");
    31.     printf($e->getMessage() . "\n");
    32.     return;
    33. }
    34. print(__FUNCTION__ . ": OK" . "\n");

    追加上傳

    追加上傳支援兩種上傳類型，分別為字元串和檔案。追加類型的檔案（Append Object）暫時不支援copyObject操作。

    追加上傳字元串

    以下代碼用於追加上傳字元串到OSS中：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. // 儲存空間名稱
    18. $bucket= "<yourBucketName>";
    19. // 檔案名稱
    20. $object = "<yourObjectName>";
    21. // 檔案內容
    22. $content_array = array('Hello OSS', 'Hi OSS', 'OSS OK');
    23. try{
    24.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    26.     $position = $ossClient->appendObject($bucket, $object, $content_array[0], 0);
    27.     $position = $ossClient->appendObject($bucket, $object, $content_array[1], $position);
    28.     $position = $ossClient->appendObject($bucket, $object, $content_array[2], $position);
    29. } catch(OssException $e) {
    30.     printf(__FUNCTION__ . ": FAILED\n");
    31.     printf($e->getMessage() . "\n");
    32.     return;
    33. }
    34. print(__FUNCTION__ . ": OK" . "\n");

    追加上傳檔案

    以下代碼用於追加上傳本地檔案到OSS：

    1.  <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. // 儲存空間名稱
    18. $bucket= "<yourBucketName>";
    19. // 檔案名稱
    20. $object = "<yourObjectName>";
    21. // 本地檔案1
    22. $filePath = "<yourLocalFile1>";
    23. // 本地檔案2
    24. $filePath1 = "<yourLocalFile2>";
    25. try{
    26.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    28.     $position = $ossClient->appendFile($bucket, $object, $filePath, 0);
    29.     $position = $ossClient->appendFile($bucket, $object, $filePath1, $position);
    30. } catch(OssException $e) {
    31.     printf(__FUNCTION__ . ": FAILED\n");
    32.     printf($e->getMessage() . "\n");
    33.     return;
    34. }
    35. print(__FUNCTION__ . ": OK" . "\n");

    分區上傳

    分區上傳分為以下三個步驟：

    1. 初始化一個分區上傳事件。
      調用$ossClient->initiateMultipartUpload方法返回OSS建立的全域唯一的uploadId。

    2. 上傳分區。
      調用$ossClient->uploadPart方法上傳分區資料。需要注意：

      • 對於同一個uploadId，分區號（partNumber）標識了該分區在整個檔案內的相對位置。如果使用同一個分區號上傳了新的資料，那麼OSS上這個分區已有的資料將會被覆蓋。
      • 除了最後一塊Part以外，其他的Part最小為100KB。最後一塊Part沒有大小限制。

    3. 完成分區上傳。
      調用$ossClient->completeMultipartUpload方法將所有分區合并成完整的檔案。

    以下通過一個完整的樣本對分區上傳的流程進行逐步解析：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    11. use OSS\Core\OssUtil;
    13. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    14. $accessKeyId = "<yourAccessKeyId>";
    15. $accessKeySecret = "<yourAccessKeySecret>";
    16. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    17. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    18. $bucket= "<yourBucketName>";
    19. $object = "<yourObjectName>";
    20. $uploadFile = "<yourLocalFile>";
    22. /**
    23.  *  步驟1：初始化一個分區上傳事件，獲取uploadId。
    24.  */
    25. try{
    26.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    28.     //返回uploadId，它是分區上傳事件的唯一標識，您可以根據這個ID來發起相關的操作，如取消分區上傳、查詢分區上傳等。
    29.     $uploadId = $ossClient->initiateMultipartUpload($bucket, $object);
    30. } catch(OssException $e) {
    31.     printf(__FUNCTION__ . ": initiateMultipartUpload FAILED\n");
    32.     printf($e->getMessage() . "\n");
    33.     return;
    34. }
    35. print(__FUNCTION__ . ": initiateMultipartUpload OK" . "\n");
    36. /*
    37.  * 步驟2：上傳分區。
    38.  */
    39. $partSize = 10 * 1024 * 1024;
    40. $uploadFileSize = filesize($uploadFile);
    41. $pieces = $ossClient->generateMultiuploadParts($uploadFileSize, $partSize);
    42. $responseUploadPart = array();
    43. $uploadPosition = 0;
    44. $isCheckMd5 = true;
    45. foreach ($pieces as $i => $piece) {
    46.     $fromPos = $uploadPosition + (integer)$piece[$ossClient::OSS_SEEK_TO];
    47.     $toPos = (integer)$piece[$ossClient::OSS_LENGTH] + $fromPos - 1;
    48.     $upOptions = array(
    49.         $ossClient::OSS_FILE_UPLOAD => $uploadFile,
    50.         $ossClient::OSS_PART_NUM => ($i + 1),
    51.         $ossClient::OSS_SEEK_TO => $fromPos,
    52.         $ossClient::OSS_LENGTH => $toPos - $fromPos + 1,
    53.         $ossClient::OSS_CHECK_MD5 => $isCheckMd5,
    54.     );
    55.     // MD5校驗。
    56.     if ($isCheckMd5) {
    57.         $contentMd5 = OssUtil::getMd5SumForFile($uploadFile, $fromPos, $toPos);
    58.         $upOptions[$ossClient::OSS_CONTENT_MD5] = $contentMd5;
    59.     }
    60.     try {
    61.         // 上傳分區。
    62.         $responseUploadPart[] = $ossClient->uploadPart($bucket, $object, $uploadId, $upOptions);
    63.     } catch(OssException $e) {
    64.         printf(__FUNCTION__ . ": initiateMultipartUpload, uploadPart - part#{$i} FAILED\n");
    65.         printf($e->getMessage() . "\n");
    66.         return;
    67.     }
    68.     printf(__FUNCTION__ . ": initiateMultipartUpload, uploadPart - part#{$i} OK\n");
    69. }
    70. // $uploadParts是由每個分區的ETag和分區號（PartNumber）組成的數組。
    71. $uploadParts = array();
    72. foreach ($responseUploadPart as $i => $eTag) {
    73.     $uploadParts[] = array(
    74.         'PartNumber' => ($i + 1),
    75.         'ETag' => $eTag,
    76.     );
    77. }
    78. /**
    79.  * 步驟3：完成上傳。
    80.  */
    81. try {
    82.     // 在執行該操作時，需要提供所有有效$uploadParts。OSS收到提交的$uploadParts後，會逐一驗證每個分區的有效性。當所有的資料分區驗證通過後，OSS將把這些分區組合成一個完整的檔案。
    83.     $ossClient->completeMultipartUpload($bucket, $object, $uploadId, $uploadParts);
    84. }  catch(OssException $e) {
    85.     printf(__FUNCTION__ . ": completeMultipartUpload FAILED\n");
    86.     printf($e->getMessage() . "\n");
    87.     return;
    88. }
    89. printf(__FUNCTION__ . ": completeMultipartUpload OK\n");

    上述例子中的$options包含的參數如下：

    參數 描述
    $ossClient::OSS_FILE_UPLOAD 上傳檔案
    OssClient::OSS_PART_NUM 分區號
    OssClient::OSS_SEEK_TO 指定開始位置
    OssClient::OSS_LENGTH 檔案長度
    OssClient::OSS_PART_SIZE 分區大小
    OssClient::OSS_CHECK_MD5 是否開啟MD5校驗，true為開啟

    分區上傳的完整代碼請參見：GitHub。

    取消分區上傳

    您可以調用$ossClient->abortMultipartUpload方法來取消分區上傳事件。當一個分區上傳事件被取消後，無法再使用這個uploadId做任何操作，已經上傳的分區資料會被刪除。

    以下代碼用於取消分區上傳事件：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. $bucket= "<yourBucketName>";
    18. $object = "<yourObjectName>";
    19. $upload_id = "<yourUploadId>";
    21. try{
    22.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    24.     $ossClient->abortMultipartUpload($bucket, $object, $upload_id);
    25. } catch(OssException $e) {
    26.     printf(__FUNCTION__ . ": FAILED\n");
    27.     printf($e->getMessage() . "\n");
    28.     return;
    29. }
    30. print(__FUNCTION__ . ": OK" . "\n");

    分區上傳本地檔案

    以下代碼用於分區上傳本地檔案到OSS中：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. $bucket= "<yourBucketName>";
    18. $object = "<yourObjectName>";
    19. $file = "<yourLocalFile>";
    21. $options = array(
    22.     OssClient::OSS_CHECK_MD5 => true,
    23.     OssClient::OSS_PART_SIZE => 1,
    24. );
    25. try{
    26.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    28.     $ossClient->multiuploadFile($bucket, $object, $file, $options);
    29. } catch(OssException $e) {
    30.     printf(__FUNCTION__ . ": FAILED\n");
    31.     printf($e->getMessage() . "\n");
    32.     return;
    33. }
    34. print(__FUNCTION__ . ":  OK" . "\n");

    分區上傳目錄

    以下代碼用於分區上傳本地目錄（包含此目錄下所有檔案）到OSS中：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. $bucket= "<yourBucketName>";
    18. $localDirectory = ".";
    19. $prefix = "samples/codes";
    20. try {
    21.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    23.     $ossClient->uploadDir($bucket, $prefix, $localDirectory);
    24. }  catch(OssException $e) {
    25.     printf(__FUNCTION__ . ": FAILED\n");
    26.     printf($e->getMessage() . "\n");
    27.     return;
    28. }
    29. print(__FUNCTION__ . ":  OK" . "\n");

    列舉已上傳的分區

    以下代碼用於列舉已上傳的分區：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    10. use OSS\Core\OssException;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. $bucket= "<yourBucketName>";
    18. $object = "<yourObjectName>";
    19. $uploadId = "<yourUploadId>";
    21. try{
    22.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    24.     $listPartsInfo = $ossClient->listParts($bucket, $object, $uploadId);
    25.     foreach ($listPartsInfo->getListPart() as $partInfo) {
    26.         print($partInfo->getPartNumber() . "\t" . $partInfo->getSize() . "\t" . $partInfo->getETag() . "\t" . $partInfo->getLastModified() . "\n");
    27.     }
    28. } catch(OssException $e) {
    29.     printf(__FUNCTION__ . ": FAILED\n");
    30.     printf($e->getMessage() . "\n");
    31.     return;
    32. }
    33. print(__FUNCTION__ . ": OK" . "\n");

    列舉分區上傳事件

    以下代碼用於列舉分區上傳事件：

    1. <?php
    2. <?php
    3. if (is_file(__DIR__ . '/../autoload.php')) {
    4.     require_once __DIR__ . '/../autoload.php';
    5. }
    6. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    7.     require_once __DIR__ . '/../vendor/autoload.php';
    8. }
    10. use OSS\OssClient;
    11. use OSS\Core\OssException;
    13. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    14. $accessKeyId = "<yourAccessKeyId>";
    15. $accessKeySecret = "<yourAccessKeySecret>";
    16. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    17. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    18. $bucket= "<yourBucketName>";
    20. $options = array(
    21.     'delimiter' => '/',
    22.     'max-uploads' => 100,
    23.     'key-marker' => '',
    24.     'prefix' => '',
    25.     'upload-id-marker' => ''
    26. );
    27. try {
    28.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    30.     $listMultipartUploadInfo = $ossClient->listMultipartUploads($bucket, $options);
    31. } catch(OssException $e) {
    32.     printf(__FUNCTION__ . ": listMultipartUploads FAILED\n");
    33.     printf($e->getMessage() . "\n");
    34.     return;
    35. }
    36. printf(__FUNCTION__ . ": listMultipartUploads OK\n");
    37. $listUploadInfo = $listMultipartUploadInfo->getUploads();
    38. var_dump($listUploadInfo);

    $options的參數說明如下：

    參數 說明
    delimiter 用於對檔案名稱進行分組的一個字元。所有名稱包含指定的首碼且第一次出現delimiter字元之間的檔案作為一組元素。
    key-marker 所有檔案名稱的字母序大於key-marker參數值的分區上傳事件。可以與upload-id-marker參數一同使用來指定返回結果的起始位置。
    max-uploads 限定此次返回分區上傳事件的最大數目，預設值和最大值均為1000。
    prefix 限定返回的檔案名稱必須以指定的prefix作為首碼。注意使用prefix查詢時，返回的檔案名稱中仍會包含prefix。
    upload-id-marker 與key-marker參數一同使用來指定返回結果的起始位置。 如果未設定key-marker參數，則此參數無效。如果設定了key-marker參數，則查詢結果中包含：
    - 名稱的字母序大於key-marker參數值的所有檔案。
    - 檔案名稱等於key-marker參數值且uploadId比upload-id-marker參數值大的所有分區上傳事件。

    上傳回調

    簡單上傳設定回調

    以下代碼用於在簡單上傳時設定回調：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    9. use OSS\OssClient;
    11. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    12. $accessKeyId = "<yourAccessKeyId>";
    13. $accessKeySecret = "<yourAccessKeySecret>";
    14. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    15. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    16. $bucket= "<yourBucketName>";
    17. $object = "<yourObjectName>";
    19. $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    21. // 上傳檔案時設定回調。
    22. // callbackUrl為回調伺服器位址，如http://oss-demo.aliyuncs.com:23450或http://127.0.0.1:9090。
    23. // callbackHost為回調請求消息頭中Host的值，如oss-cn-hangzhou.aliyuncs.com。
    24. $url =
    25.     '{
    26.         "callbackUrl":"<yourCallbackServerUrl>",
    27.         "callbackHost":"<yourCallbackServerHost>",
    28.         "callbackBody":"bucket=${bucket}&object=${object}&etag=${etag}&size=${size}&mimeType=${mimeType}&imageInfo.height=${imageInfo.height}&imageInfo.width=${imageInfo.width}&imageInfo.format=${imageInfo.format}&my_var1=${x:var1}&my_var2=${x:var2}",
    29.         "callbackBodyType":"application/x-www-form-urlencoded"
    30.     }';
    32. // 設定發起回調請求的自訂參數，由Key和Value組成，Key必須以x:開始。
    33. $var =
    34.     '{
    35.         "x:var1":"value1",
    36.         "x:var2":"值2"
    37.     }';
    38. $options = array(OssClient::OSS_CALLBACK => $url,
    39.     OssClient::OSS_CALLBACK_VAR => $var
    40. );
    41. $result = $ossClient->putObject($bucket, $object, file_get_contents(__FILE__), $options);
    42. print_r($result['body']);
    43. print_r($result['info']['http_code']);

    分區上傳設定回調

    以下代碼用於分區上傳設定回調：

    1. <?php
    2. if (is_file(__DIR__ . '/../autoload.php')) {
    3.     require_once __DIR__ . '/../autoload.php';
    4. }
    5. if (is_file(__DIR__ . '/../vendor/autoload.php')) {
    6.     require_once __DIR__ . '/../vendor/autoload.php';
    7. }
    8. use OSS\OssClient;
    9. use OSS\Core\OssException;
    10. use OSS\Core\OssUtil;
    12. // 阿里雲主帳號AccessKey擁有所有API的存取權限，風險很高。強烈建議您建立並使用RAM帳號進行API訪問或日常運維，請登入 https://ram.console.aliyun.com 建立RAM帳號。
    13. $accessKeyId = "<yourAccessKeyId>";
    14. $accessKeySecret = "<yourAccessKeySecret>";
    15. // Endpoint以杭州為例，其它Region請按實際情況填寫。
    16. $endpoint = "http://oss-cn-hangzhou.aliyuncs.com";
    17. $bucket= "<yourBucketName>";
    18. $object = "<yourObjectName>";
    19. $uploadFile = "<yourLocalFile>";
    21. /**
    22.  *  步驟1：初始化一個分區上傳事件，獲取uploadId。
    23.  */
    25. $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    26. //返回uploadId，它是分區上傳事件的唯一標識，您可以根據這個ID來發起相關的操作，如取消分區上傳、查詢分區上傳等。
    27. $uploadId = $ossClient->initiateMultipartUpload($bucket, $object);
    29. print(__FUNCTION__ . ": initiateMultipartUpload OK" . "\n");
    30. /*
    31.  * 步驟2：上傳分區。
    32.  */
    33. $partSize = 10 * 1024 * 1024;
    34. $uploadFileSize = filesize($uploadFile);
    35. $pieces = $ossClient->generateMultiuploadParts($uploadFileSize, $partSize);
    36. $responseUploadPart = array();
    37. $uploadPosition = 0;
    38. $isCheckMd5 = true;
    39. foreach ($pieces as $i => $piece) {
    40.     $fromPos = $uploadPosition + (integer)$piece[$ossClient::OSS_SEEK_TO];
    41.     $toPos = (integer)$piece[$ossClient::OSS_LENGTH] + $fromPos - 1;
    42.     $upOptions = array(
    43.         $ossClient::OSS_FILE_UPLOAD => $uploadFile,
    44.         $ossClient::OSS_PART_NUM => ($i + 1),
    45.         $ossClient::OSS_SEEK_TO => $fromPos,
    46.         $ossClient::OSS_LENGTH => $toPos - $fromPos + 1,
    47.         $ossClient::OSS_CHECK_MD5 => $isCheckMd5,
    48.     );
    49.     // MD5校驗。
    50.     if ($isCheckMd5) {
    51.         $contentMd5 = OssUtil::getMd5SumForFile($uploadFile, $fromPos, $toPos);
    52.         $upOptions[$ossClient::OSS_CONTENT_MD5] = $contentMd5;
    53.     }
    54.     try {
    55.         // 上傳分區。
    56.         $responseUploadPart[] = $ossClient->uploadPart($bucket, $object, $uploadId, $upOptions);
    57.     } catch(OssException $e) {
    58.         printf(__FUNCTION__ . ": initiateMultipartUpload, uploadPart - part#{$i} FAILED\n");
    59.         printf($e->getMessage() . "\n");
    60.         return;
    61.     }
    62.     printf(__FUNCTION__ . ": initiateMultipartUpload, uploadPart - part#{$i} OK\n");
    63. }
    64. // $uploadParts是由每個分區的ETag和分區號（PartNumber）組成的數組。
    65. $uploadParts = array();
    66. foreach ($responseUploadPart as $i => $eTag) {
    67.     $uploadParts[] = array(
    68.         'PartNumber' => ($i + 1),
    69.         'ETag' => $eTag,
    70.     );
    71. }
    73. /**
    74.  * 步驟3：完成上傳。
    75.  */
    76. // callbackUrl為回調伺服器位址，如http://oss-demo.aliyuncs.com:23450或http://127.0.0.1:9090。
    77. // callbackHost為回調請求消息頭中Host的值，如oss-cn-hangzhou.aliyuncs.com。
    78. $json =
    79.     '{
    80.         "callbackUrl":"<yourCallbackServerUrl>",
    81.         "callbackHost":"<yourCallbackServerHost>",
    82.         "callbackBody":"{\"mimeType\":${mimeType},\"size\":${size},\"x:var1\":${x:var1},\"x:var2\":${x:var2}}",
    83.         "callbackBodyType":"application/json"
    84.     }';
    86. // 設定發起回調請求的自訂參數，由Key和Value組成，Key必須以x:開始。
    87. $var =
    88.     '{
    89.         "x:var1":"value1",
    90.         "x:var2":"值2"
    91.     }';
    92. $options = array(OssClient::OSS_CALLBACK => $json,
    93.     OssClient::OSS_CALLBACK_VAR => $var);
    94. // 在執行該操作時，需要提供所有有效$uploadParts。OSS收到提交的$uploadParts後，會逐一驗證每個分區的有效性。當所有的資料分區驗證通過後，OSS將把這些分區組合成一個完整的檔案。
    95. $ossClient->completeMultipartUpload($bucket, $object, $uploadId, $uploadParts, $options);
    97. printf(__FUNCTION__ . ": completeMultipartUpload OK\n");