全部產品
Search

搜尋本產品

    ：管理檔案

    文件中心

    ：管理檔案

    更新時間：Oct 19, 2018

    您可以通過一系列的介面管理儲存空間（Bucket）下的檔案（Object）。管理檔案的完整代碼請參見：GitHub。

    判斷檔案是否存在

    以下代碼用於判斷指定的檔案是否存在：

    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>";
    20. try{
    21.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    23.     $exist = $ossClient->doesObjectExist($bucket, $object);
    24. } catch(OssException $e) {
    25.     printf(__FUNCTION__ . ": FAILED\n");
    26.     printf($e->getMessage() . "\n");
    27.     return;
    28. }
    29. print(__FUNCTION__ . ": OK" . "\n");
    30. var_dump($exist);

    檔案存取權限

    檔案的存取權限（ACL）有以下四種：

    存取權限 描述 存取權限值
    繼承Bucket 檔案遵循儲存空間的存取權限。 default
    私有 檔案的擁有者和授權使用者有該檔案的讀寫權限，其他使用者沒有許可權操作該檔案。 private
    公共讀 檔案的擁有者和授權使用者有該檔案的讀寫權限，其他使用者只有檔案的讀許可權。請謹慎使用該許可權。 public-read
    公共讀寫 所有使用者都有該檔案的讀寫權限。請謹慎使用該許可權。 public-read-write

    檔案的存取權限優先順序高於儲存空間的存取權限。例如儲存空間的存取權限是私有，而檔案的存取權限是公共讀寫，則所有使用者都有該檔案的讀寫權限。如果某個檔案沒有設定過存取權限，則遵循儲存空間的存取權限。

    設定檔案存取權限

    以下代碼用於設定指定檔案的存取權限：

    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. // 設定檔案的存取權限為公共讀，預設為繼承Bucket。
    20. $acl = "public-read";
    21. try {
    22.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    24.     $ossClient->putObjectAcl($bucket, $object, $acl);
    25. } catch (OssException $e) {
    26.     printf(__FUNCTION__ . ": FAILED\n");
    27.     printf($e->getMessage() . "\n");
    28.     return;
    29. }
    30. 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. try {
    20.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    22.     $objectAcl = $ossClient->getObjectAcl($bucket, $object);
    23. } catch (OssException $e) {
    24.     printf(__FUNCTION__ . ": FAILED\n");
    25.     printf($e->getMessage() . "\n");
    26.     return;
    27. }
    28. print(__FUNCTION__ . ": OK" . "\n");
    29. var_dump($objectAcl);

    檔案元資訊

    檔案元資訊（Object Meta）詳情請參見開發指南中的檔案元資訊。

    設定檔案元資訊

    以下代碼用於設定檔案元資訊：

    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. $content = file_get_contents(__FILE__);
    20. $options = array(
    21.     OssClient::OSS_HEADERS => array(
    22.         'Expires' => '2012-10-01 08:00:00',
    23.         'Content-Disposition' => 'attachment; filename="xxxxxx"',
    24.         'x-oss-meta-self-define-title' => 'user define meta info',
    25.     ));
    26. try{
    27.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    29.     $ossClient->putObject($bucket, $object, $content, $options);
    30. } catch(OssException $e) {
    31.     printf(__FUNCTION__ . ": FAILED\n");
    32.     printf($e->getMessage() . "\n");
    33.     return;
    34. }
    35. 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. $fromBucket = "<yourFromBucketName>";
    18. $fromObject = "<yourFromObjectName>";
    19. $toBucket = "<yourToBucketName>";
    20. $toObject = "<yourToObjectName>";
    21. $copyOptions = array(
    22.     OssClient::OSS_HEADERS => array(
    23.         'Expires' => '2018-10-01 08:00:00',
    24.         'Content-Disposition' => 'attachment; filename="xxxxxx"',
    25.         'x-oss-meta-location' => 'location',
    26.     ),
    27. );
    28. try{
    29.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    31.     $ossClient->copyObject($fromBucket, $fromObject, $toBucket, $toObject, $copyOptions);
    32. } catch(OssException $e) {
    33.     printf(__FUNCTION__ . ": FAILED\n");
    34.     printf($e->getMessage() . "\n");
    35.     return;
    36. }
    37. 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. try {
    20.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    22.     $objectMeta = $ossClient->getObjectMeta($bucket, $object);
    23. } catch (OssException $e) {
    24.     printf(__FUNCTION__ . ": FAILED\n");
    25.     printf($e->getMessage() . "\n");
    26.     return;
    27. }
    28. print(__FUNCTION__ . ": OK" . "\n");
    29. if (isset($objectMeta[strtolower('Content-Disposition')]) &&
    30.     'attachment; filename="xxxxxx"' === $objectMeta[strtolower('Content-Disposition')]
    31. ) {
    32.     print(__FUNCTION__ . ": ObjectMeta checked OK" . "\n");
    33. } else {
    34.     print(__FUNCTION__ . ": ObjectMeta checked FAILED" . "\n");
    35. }

    列舉檔案

    列舉所有檔案

    以下代碼用於列舉指定儲存空間下的所有檔案：

    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>";
    19. $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    21. while (true) {
    22.     try {
    23.         $listObjectInfo = $ossClient->listObjects($bucket, $options);
    24.     } catch (OssException $e) {
    25.         printf(__FUNCTION__ . ": FAILED\n");
    26.         printf($e->getMessage() . "\n");
    27.         return;
    28.     }
    29.     // 得到nextMarker，從上一次listObjects讀到的最後一個檔案的下一個檔案開始繼續獲取檔案清單。
    30.     $nextMarker = $listObjectInfo->getNextMarker();
    31.     $listObject = $listObjectInfo->getObjectList();
    32.     $listPrefix = $listObjectInfo->getPrefixList();
    34.     if (!empty($listObject)) {
    35.         print("objectList:\n");
    36.         foreach ($listObject as $objectInfo) {
    37.             print($objectInfo->getKey() . "\n");
    38.         }
    39.     }
    40.     if (!empty($listPrefix)) {
    41.         print("prefixList: \n");
    42.         foreach ($listPrefix as $prefixInfo) {
    43.             print($prefixInfo->getPrefix() . "\n");
    44.         }
    45.     }
    46.     if ($nextMarker === '') {
    47.         break;
    48.     }
    49. }

    列舉指定條件的檔案

    以下代碼用於列舉指定條件的檔案：

    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>";
    19. $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    21. $prefix = 'dir/';
    22. $delimiter = '/';
    23. $nextMarker = '';
    24. $maxkeys = 10;
    25. $options = array(
    26.     'delimiter' => $delimiter,
    27.     'prefix' => $prefix,
    28.     'max-keys' => $maxkeys,
    29.     'marker' => $nextMarker,
    30. );
    31. try {
    32.     $listObjectInfo = $ossClient->listObjects($bucket, $options);
    33. } catch (OssException $e) {
    34.     printf(__FUNCTION__ . ": FAILED\n");
    35.     printf($e->getMessage() . "\n");
    36.     return;
    37. }
    38. print(__FUNCTION__ . ": OK" . "\n");
    39. $objectList = $listObjectInfo->getObjectList(); // object list
    40. $prefixList = $listObjectInfo->getPrefixList(); // directory list
    41. if (!empty($objectList)) {
    42.     print("objectList:\n");
    43.     foreach ($objectList as $objectInfo) {
    44.         print($objectInfo->getKey() . "\n");
    45.     }
    46. }
    47. if (!empty($prefixList)) {
    48.     print("prefixList: \n");
    49.     foreach ($prefixList as $prefixInfo) {
    50.         print($prefixInfo->getPrefix() . "\n");
    51.     }
    52. }

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

    參數 說明 是否必需
    delimiter 對檔案名稱進行分組的一個字元。CommonPrefixes是以delimiter結尾，並有共同首碼的檔案集合。 否
    prefix 本次查詢結果的首碼。 否
    max-keys 列舉檔案的最大個數。預設為100，最大值為1000。 否
    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;
    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>";
    20. try{
    21.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    23.     $ossClient->deleteObject($bucket, $object);
    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>";
    19. $objects = array();
    20. $objects[] = "<yourObjectName1>";
    21. $objects[] = "<yourObjectName2>";
    22. try{
    23.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    25.     $ossClient->deleteObjects($bucket, $objects);
    26. } catch(OssException $e) {
    27.     printf(__FUNCTION__ . ": FAILED\n");
    28.     printf($e->getMessage() . "\n");
    29.     return;
    30. }
    31. print(__FUNCTION__ . ": OK" . "\n");

    拷貝檔案

    簡單拷貝

    以下代碼用於拷貝小於1GB的檔案：

    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. $from_bucket = "<yourFromBucketName>";
    18. $from_object = "<yourFromObjectName>";
    19. $to_bucket = $bucket;
    20. $to_object = $from_object . '.copy';
    22. try{
    23.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    25.     $ossClient->copyObject($from_bucket, $from_object, $to_bucket, $to_object);
    26. } catch(OssException $e) {
    27.     printf(__FUNCTION__ . ": FAILED\n");
    28.     printf($e->getMessage() . "\n");
    29.     return;
    30. }
    31. print(__FUNCTION__ . ": OK" . "\n");
    32. `

    拷貝大檔案

    對於大於1GB的檔案，需要使用分區拷貝。分區拷貝分為三步：

    1. 通過$ossClient->initiateMultipartUpload初始化分區拷貝任務。
    2. 通過$ossClient->uploadPartCopy進行分區拷貝。除最後一個分區外，其它分區都要大於100KB。
    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;
    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";
    18. $src_bucket = "<yourSourceBucketName>";
    19. $src_object = "<yourSourceObjectName>";
    20. $dst_bucket = "<yourDestinationBucketName>";
    21. $dst_object = "<yourDestinationObjectName>";
    23. try{
    24.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    26.     // 初始化分區。
    27.     $upload_id = $ossClient->initiateMultipartUpload($dst_bucket, $dst_object);
    29.     $copyId = 1;
    30.     // 逐個分區拷貝。
    31.     $eTag = $ossClient->uploadPartCopy( $src_bucket, $src_object, $dst_bucket, $dst_object,$copyId, $upload_id);
    32.     $upload_parts[] = array(
    33.         'PartNumber' => $copyId,
    34.         'ETag' => $eTag,
    35.     );
    37.     // 完成分區拷貝。
    38.     $result = $ossClient->completeMultipartUpload($dst_bucket, $dst_object, $upload_id, $upload_parts);
    39. } catch(OssException $e) {
    40.     printf(__FUNCTION__ . ": FAILED\n");
    41.     printf($e->getMessage() . "\n");
    42.     return;
    43. }
    44. print(__FUNCTION__ . ": OK" . "\n");

    解凍歸檔檔案

    歸檔類型（Archive）的檔案需要解凍（Restore）之後才能讀取。非歸檔類型的檔案，不要調用restoreObject方法。

    歸檔檔案的狀態變換過程如下：

    1. 歸檔類型的檔案初始時處於冷凍狀態。
    2. 提交解凍操作後，服務端執行解凍，檔案處於解凍中的狀態。
    3. 完成解凍後，可以讀取檔案。解凍狀態預設持續1天，最多延長7天，之後檔案又回到冷凍狀態。

    以下代碼用於解凍歸檔檔案：

    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>";
    20. try {
    21.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    23.     $ossClient->restoreObject($bucket, $object);
    24. } catch (OssException $e) {
    25.     printf(__FUNCTION__ . ": FAILED\n");
    26.     printf($e->getMessage() . "\n");
    27.     return;
    28. }
    29. print(__FUNCTION__ . ": OK" . "\n");

    儲存類型詳情請參見儲存類型。

    符號連結

    建立符號連結

    符號連結是一種特殊的檔案，它指向某個具體的檔案，類似於Windows上使用的捷徑。符號連結支援自訂元資訊。

    以下代碼用於建立符號連結：

    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. $symlink = "<yourSymlink>";
    20. try {
    21.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    23.     $ossClient->putSymlink($bucket, $symlink, $object);
    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. $symlink = "<yourSymlink>";
    19. try {
    20.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    22.     $Symlinks = $ossClient->getSymlink($bucket, $symlink);
    23. } catch (OssException $e) {
    24.     printf(__FUNCTION__ . ": FAILED\n");
    25.     printf($e->getMessage() . "\n");
    26.     return;
    27. }
    28. print(__FUNCTION__ . ": OK" . "\n");
    29. var_dump($Symlinks);

    開啟MD5校驗

    MD5校驗用於確保資料轉送的完整性。使用MD5校驗時，效能會有所損失。上傳檔案時預設關閉MD5校驗。

    以下代碼用於上傳檔案時開啟MD5校驗：

    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>";
    20. $options = array(OssClient::OSS_CHECK_MD5 => true);
    21. try{
    22.     $ossClient = new OssClient($accessKeyId, $accessKeySecret, $endpoint);
    24.     $ossClient->uploadFile($bucket, $object, __FILE__, $options);
    25. } catch(OssException $e) {
    26.     printf(__FUNCTION__ . ": FAILED\n");
    27.     printf($e->getMessage() . "\n");
    28.     return;
    29. }
    30. print(__FUNCTION__ . ": OK" . "\n");

    putObject、uploadFile、appendObject、appendFile、multiuploadFile方法支援開啟MD5校驗。