如何通过AWS PHP客户端编程关闭S3存储桶的阻止公共访问设置

问题根源 #

你遇到的PutPublicAccessBlock操作不存在的错误，核心原因是使用的AWS PHP SDK版本过低——旧版本SDK未实现该API接口。S3公共访问阻止功能在2018年推出，对应的SDK接口仅在v3版本的AWS PHP SDK中支持。

解决方案步骤 #

1. 升级AWS PHP SDK #

通过Composer升级到最新版本的AWS SDK for PHP：

composer require aws/aws-sdk-php

2. 完整的存储桶创建与公开访问配置流程 #

正确的操作流程应为：创建存储桶 → 关闭桶级公共访问阻止 → 设置公开读桶策略 → 上传对象（可选）。以下是完整代码示例：

// 初始化S3客户端
$s3Client = new Aws\S3\S3Client([
    'version' => 'latest',
    'region'  => '你的目标区域（如us-east-1）',
    // 认证信息按你的配置方式填写，比如环境变量、凭证文件等
]);

$bucketName = 'your-bucket-name';

// 1. 创建存储桶
try {
    $s3Client->createBucket([
        'Bucket' => $bucketName,
    ]);
    echo "存储桶创建成功\n";
} catch (Aws\Exception\AwsException $e) {
    echo "创建存储桶失败: " . $e->getMessage() . "\n";
    exit;
}

// 2. 关闭存储桶的公共访问阻止设置
try {
    $s3Client->putPublicAccessBlock([
        'Bucket' => $bucketName,
        'PublicAccessBlockConfiguration' => [
            'BlockPublicAcls' => false,
            'IgnorePublicAcls' => false,
            'BlockPublicPolicy' => false,
            'RestrictPublicBuckets' => false,
        ],
    ]);
    echo "公共访问阻止设置已关闭\n";
} catch (Aws\Exception\AwsException $e) {
    echo "关闭公共访问阻止失败: " . $e->getMessage() . "\n";
    exit;
}

// 3. 设置桶策略（允许公开读取对象）
$policy = [
    'Version' => '2012-10-17',
    'Statement' => [
        [
            'Sid' => 'PublicReadGetObject',
            'Effect' => 'Allow',
            'Principal' => '*',
            'Action' => 's3:GetObject',
            'Resource' => "arn:aws:s3:::$bucketName/*"
        ]
    ]
];

try {
    $s3Client->putBucketPolicy([
        'Bucket' => $bucketName,
        'Policy' => json_encode($policy), // 用json_encode避免手动转义错误
    ]);
    echo "桶策略设置成功\n";
} catch (Aws\Exception\AwsException $e) {
    echo "设置桶策略失败: " . $e->getMessage() . "\n";
    exit;
}

// 4. 上传示例对象（可选）
try {
    $s3Client->putObject([
        'Bucket' => $bucketName,
        'Key' => 'test-file.txt',
        'Body' => '测试内容',
        // 无需设置ACL为public-read，桶策略已控制访问权限
    ]);
    echo "对象上传成功\n";
} catch (Aws\Exception\AwsException $e) {
    echo "上传对象失败: " . $e->getMessage() . "\n";
}

3. 关键注意事项 #

• 权限要求：确保你的IAM用户/角色拥有以下权限：s3:CreateBucket、s3:PutPublicAccessBlock、s3:PutBucketPolicy、s3:PutObject（若需上传对象）
• 账户级公共访问设置：若AWS账户开启了账户级公共访问阻止，仅关闭桶级设置无效，需先调整账户层面配置（或确保账户级允许桶级覆盖）
• 策略写法规范：推荐用json_encode生成策略字符串，避免手动转义双引号引发的语法错误

内容的提问来源于stack exchange，提问作者Cam Mac