文档首页/ 对象存储服务 OBS/ SDK参考/ PHP/ 并行文件系统/ 列举并行文件系统内对象
更新时间:2026-06-30 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 ( [
      //推荐通过环境变量获取AKSK,这里也可以使用其他外部引入方式传入,如果使用硬编码可能会存在泄露风险。
      //您可以登录访问管理控制台获取访问密钥AK/SK,获取方式请参见https://support.huaweicloud.com/intl/zh-cn/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
              ] );
              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;
       }
}