PHP实现AWS S3桶单层对象（目录）列表的教程

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

<?php

require 'vendor/autoload.php'; // 确保您已通过Composer安装AWS SDK

use Aws\S3\S3Client;
use Aws\Exception\AwsException;

// 1. 配置您的AWS凭证和区域
// 最佳实践是使用IAM角色或环境变量，避免硬编码凭证
$s3Client = new S3Client([
    'version'  => 'latest', // 使用最新版本的API
    'region'   => 'your-aws-region', // 例如 'us-east-1', 'ap-southeast-1'
    'credentials' => [
        'key'    => 'YOUR_AWS_ACCESS_KEY_ID', // 替换为您的Access Key ID
        'secret' => 'YOUR_AWS_SECRET_ACCESS_KEY', // 替换为您的Secret Access Key
        // 'token'  => 'YOUR_AWS_SESSION_TOKEN', // 如果使用临时凭证
    ],
]);

// 2. 定义桶名、前缀和分隔符
$bucketName = 'your-s3-bucket-name'; // 替换为您的S3桶名称
$prefix = 'public/uploads/test_company/'; // 要查询的路径前缀，注意末尾的斜杠
$delimiter = '/'; // 目录分隔符

echo "正在查询桶 '{$bucketName}' 中路径 '{$prefix}' 下的单层对象...\n";

try {
    // 3. 调用 listObjects 方法
    $result = $s3Client->listObjects([
        'Bucket'    => $bucketName, // 必需：S3桶名称
        'Prefix'    => $prefix,     // 限制结果为指定前缀下的对象
        'Delimiter' => $delimiter,  // 启用目录模拟功能
        // 'MaxKeys' => 1000, // 可选：限制每次返回的对象数量，默认1000
        // 'Marker' => '<string>', // 可选：用于分页，从指定键之后开始返回
    ]);

    // 4. 处理返回结果：CommonPrefixes (子目录)
    if (isset($result['CommonPrefixes'])) {
        echo "\n当前层级子目录:\n";
        foreach ($result['CommonPrefixes'] as $commonPrefix) {
            // CommonPrefixes['Prefix']会包含完整的目录路径，例如 'public/uploads/test_company/test1/'
            echo "- " . $commonPrefix['Prefix'] . "\n";
        }
    } else {
        echo "\n当前层级没有子目录。\n";
    }

    // 5. 处理返回结果：Contents (当前层级的文件)
    if (isset($result['Contents'])) {
        echo "\n当前层级文件:\n";
        foreach ($result['Contents'] as $object) {
            // 排除与Prefix完全相同的Key（通常表示一个空目录本身）
            // 并且确保对象键在Prefix之后不包含Delimiter，以确认它是当前层级的文件
            $relativeKey = substr($object['Key'], strlen($prefix));
            if (!empty($relativeKey) && strpos($relativeKey, $delimiter) === false) {
                echo "- " . $object['Key'] . " (大小: " . $object['Size'] . " 字节, 上次修改: " . $object['LastModified'] . ")\n";
            }
        }
    } else {
        echo "\n当前层级没有直接文件。\n";
    }

} catch (AwsException $e) {
    // 捕获并输出任何AWS SDK相关的异常
    echo "查询S3对象时发生错误: " . $e->getMessage() . "\n";
}

?>

正在查询桶 'your-s3-bucket-name' 中路径 'public/uploads/test_company/' 下的单层对象...

当前层级子目录:
- public/uploads/test_company/test1/
- public/uploads/test_company/test2/

当前层级文件:
- public/uploads/test_company/file_at_root.jpg (大小: XXX 字节, 上次修改: YYY)