使用PHP SDK获取S3桶指定前缀下的单层对象列表

public/uploads/test_company/test1
public/uploads/test_company/test2
public/uploads/test_company/test1/test.txt

<?php
<p>require 'vendor/autoload.php'; // 假设已通过Composer安装AWS SDK</p><p>use Aws\S3\S3Client;
use Aws\Exception\AwsException;</p><p>// 1. 初始化S3客户端
// 请替换为您的AWS区域和凭证信息
$s3Client = new S3Client([
'version' => 'latest',
'region'  => 'your-aws-region', // 例如: 'us-east-1'
'credentials' => [
'key'    => 'YOUR_AWS_ACCESS_KEY_ID',
'secret' => 'YOUR_AWS_SECRET_ACCESS_KEY',
],
]);</p><p>$bucketName = 'your-s3-bucket-name'; // 您的S3存储桶名称
$targetPrefix = 'public/uploads/test_company/'; // 目标前缀，通常以'/'结尾</p><p>try {
// 2. 调用 listObjects 方法，并设置 Prefix 和 Delimiter
$result = $s3Client->listObjects([
'Bucket'    => $bucketName,
'Prefix'    => $targetPrefix,
'Delimiter' => '/',
]);</p><pre class="brush:php;toolbar:false;">echo "在 '{$targetPrefix}' 下找到的顶级子项:\n";

// 3. 处理 CommonPrefixes (模拟的子目录)
if (isset($result['CommonPrefixes'])) {
    foreach ($result['CommonPrefixes'] as $commonPrefix) {
        // commonPrefix['Prefix'] 的格式为 'public/uploads/test_company/test1/'
        // 我们需要提取 'test1'
        $folderName = rtrim(str_replace($targetPrefix, '', $commonPrefix['Prefix']), '/');
        echo "- 子目录: {$folderName}\n";
    }
}

// 4. 处理 Contents (直接位于当前前缀下的文件，不含Delimiter)
// 在本例中，如果 'test1' 和 'test2' 是唯一的顶级项，此列表可能为空。
// 如果有文件如 'public/uploads/test_company/report.pdf'，它将出现在这里。
if (isset($result['Contents'])) {
    foreach ($result['Contents'] as $object) {
        $objectKey = $object['Key'];
        // 确保是直接子文件，而不是深层文件
        // 检查对象键是否直接在目标前缀下，且不包含额外的斜杠
        $relativeKey = str_replace($targetPrefix, '', $objectKey);
        if (!empty($relativeKey) && strpos($relativeKey, '/') === false) {
             echo "- 文件: {$relativeKey}\n";
        }
    }
}