如何用PHP的GCP StorageClient获取目录（前缀）列表并实现分页？

核心问题分析 #

你的代码目前存在两个关键问题：

1. 没有利用GCS的delimiter参数模拟目录查询，反而遍历所有对象并逐个调用info()，导致请求量巨大、效率极低；
2. 未正确使用分页参数控制结果集大小，一次性拉取数百万条记录必然超时。

1. 仅列出目录（Prefix）的正确方式 #

GCS本身没有真实目录，所有"目录"都是通过对象路径的前缀（prefix）和分隔符（delimiter）模拟的。要单独获取所有用户目录，只需设置delimiter='/'，API会自动返回所有顶层前缀（即你要的目录），无需遍历所有对象。

优化代码示例 #

try {
    $bucket = $this->storage->bucket('xx.xx.xx');
    $pageToken = null;
    $maxResults = 1000; // 每页返回的目录数量，可根据需求调整

    do {
        $options = [
            'delimiter' => '/', // 关键：用斜杠分隔路径，获取顶层前缀
            'pageToken' => $pageToken,
            'maxResults' => $maxResults
        ];

        // 调用listObjects获取结果，包含prefixes字段
        $result = $bucket->objects($options);
        $prefixes = $result->prefixes(); // 直接获取所有目录前缀

        // 处理当前页的目录
        foreach ($prefixes as $prefix) {
            echo "目录：{$prefix}\n";
        }

        // 更新分页token，准备下一页请求
        $pageToken = $result->nextPageToken();
    } while ($pageToken); // 直到没有下一页token为止

} catch (Exception $e) {
    print_r($e);
}

2. 分页查询对象的优化（若需处理对象） #

如果后续需要分页查询对象，同样通过pageToken和maxResults控制，且避免在循环中重复调用object()->info()——直接使用$object实例的属性即可，无需额外API请求：

try {
    $bucket = $this->storage->bucket('xx.xx.xx');
    $pageToken = null;
    $maxResults = 1000;

    do {
        $options = [
            'pageToken' => $pageToken,
            'maxResults' => $maxResults
            // 可添加prefix过滤特定目录下的对象
        ];

        foreach ($bucket->objects($options) as $object) {
            // 直接从$object实例获取属性，无需额外请求
            echo "对象名称：{$object->name()}\n";
            echo "对象大小：{$object->size()}\n";
            // 如需完整元数据，一次获取即可，不要循环内重复调用
            // $info = $object->info();
        }

        $pageToken = $result->nextPageToken();
    } while ($pageToken);

} catch (Exception $e) {
    print_r($e);
}

关键注意事项 #

• 避免冗余请求：原代码中foreach ($bucket->objects(...) as $object)后又调用$bucket->object($object->name())->info()，这会为每个对象额外发起一次API请求，百万级对象场景下完全不可行；
• 合理设置maxResults：GCS API允许的最大maxResults为1000，设置这个值能减少分页次数；
• delimiter的作用：当设置delimiter='/'时，API会将路径中第一个斜杠前的部分作为前缀返回，自动过滤掉子目录和文件，完美匹配你获取用户专属目录的需求。

内容的提问来源于stack exchange，提问作者Kodr.F