更新时间:2026-08-03 GMT+08:00

列举并行文件系统内对象

开发过程中,您有任何问题可以在GitHub上提交issue接口参考文档详细介绍了每个接口的参数和使用方法。

您可以通过ObsClient->listObjects列举指定POSIX并行文件系统内的文件夹和对象:

<?php
// 引入依赖库
require 'vendor/autoload.php';
// 使用源码安装时引入SDK代码库
// require 'obs-autoloader.php';
// 声明命名空间
use Obs\ObsClient;
// 创建ObsClient实例
$obsClient = new ObsClient( [
    //推荐通过环境变量获取访问密钥AK/SK,这里也可以使用其他外部引入方式传入,如果使用硬编码可能会存在泄露风险。
    //您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/usermanual-ca/ca_01_0003.htmlhttps://support.huaweicloud.com/intl/zh-cn/usermanual-ca/ca_01_0003.htmlhttps://support.huaweicloud.com/eu/usermanual-ca/ca_01_0003.html
    'key' => getenv('ACCESS_KEY_ID'),
    'secret' => getenv('SECRET_ACCESS_KEY'),
    // endpoint填写Bucket对应的Endpoint, 此处以中国-香港为例,其他地区请按实际情况填写。
    'endpoint' => "obs.ap-southeast-1.myhuaweicloud.com",
    'signature' => 'obs'
] );

$bucketName = 'posix-bucket-name';
// 列举并行文件系统内的对象(含分页处理)
$isTruncated = true;
$marker = null;
while ($isTruncated) {
       try {
              $resp = $obsClient->listObjects( [
                     'Bucket' => $bucketName,
                     // 设置文件夹分隔符
                     'Delimiter' => '/',
                     'Marker' => $marker,
                     // 每页最大返回对象数,默认 1000
                     'MaxKeys' => 100
              ] );
              if (!empty($resp['CommonPrefixes'])) {
                     printf("Folders:\n");
                     foreach ($resp['CommonPrefixes'] as $prefix) {
                            printf("  [D] %s\n", $prefix['Prefix']);
                     }
              }
              if (!empty($resp['Contents'])) {
                     printf("Files:\n");
                     foreach ($resp['Contents'] as $content) {
                            printf("  [F] %s (size: %d bytes)\n", $content['Key'], $content['Size']);
                     }
              }
              $isTruncated = $resp['IsTruncated'];
              $marker = $resp['NextMarker'];
       } catch (\Obs\ObsException $e) {
              printf("ListObjectsFailed: Status:%d, Message:%s\n", $e->getStatusCode(), $e->getExceptionMessage());
              break;
       }
       // 关闭 ObsClient 实例,释放连接资源
       $obsClient->close();
}