AWS S3 PHP文件操作指南：解决GetObject错误与正确实现文件存取

<?php

require 'vendor/autoload.php'; // 确保您的Composer autoload文件已包含

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

/**
 * 初始化并返回一个S3客户端实例
 * @return S3Client
 */
function getS3Client(): S3Client
{
    // 推荐使用环境变量、IAM角色或配置文件来管理凭证
    // 这里以配置文件为例，'profile' 指向 ~/.aws/credentials 文件中的一个配置项
    // 如果在EC2实例上运行，可以利用IAM角色，SDK会自动获取凭证
    return new S3Client([
        'profile' => 'default', // 或 'key' => 'YOUR_ACCESS_KEY_ID', 'secret' => 'YOUR_SECRET_ACCESS_KEY'
        'region'  => 'us-west-2', // 您的S3桶所在的区域
        'version' => 'latest' // 推荐使用'latest'以获取最新API版本
    ]);
}

?>

<?php

// ... (getS3Client 函数定义) ...

/**
 * 将文件上传到AWS S3桶
 * @param string $bucketName S3桶名称
 * @param string $key 对象键（文件路径）
 * @param string $filePath 本地文件路径
 * @return array|null 上传结果数组或null
 */
function aws_file_upload(string $bucketName, string $key, string $filePath): ?array
{
    $s3Client = getS3Client();

    try {
        $result = $s3Client->putObject([
            'Bucket'     => $bucketName,
            'Key'        => $key,
            'SourceFile' => $filePath, // 使用 SourceFile 更高效地上传本地文件
            // 'Body' => fopen($filePath, 'r'), // 也可以使用 Body 传递文件流
            // 'ContentType' => 'application/pdf', // 可选：指定文件类型
            // 'ACL' => 'public-read', // 可选：设置公共读权限，谨慎使用
        ]);
        echo "文件上传成功: " . $result['ObjectURL'] . "\n";
        return $result->toArray(); // 将结果对象转换为数组
    } catch (AwsException $e) {
        echo "文件上传失败: " . $e->getMessage() . "\n";
        return null;
    }
}

// 示例用法
$bucket = 'my-unique-app-bucket'; // 替换为您的S3桶名称
$key = 'Cases/my-document.pdf';
$localFilePath = 'path/to/local/my-document.pdf'; // 替换为您的本地文件路径

// 确保本地文件存在
if (!file_exists($localFilePath)) {
    // 模拟创建一个PDF文件用于测试
    file_put_contents($localFilePath, "This is a dummy PDF content for testing.");
    echo "创建测试文件: $localFilePath\n";
}

$uploadResult = aws_file_upload($bucket, $key, $localFilePath);

?>

<?php

// ... (getS3Client 函数定义) ...

/**
 * 从AWS S3桶获取文件并直接输出到浏览器
 * @param string $bucketName S3桶名称
 * @param string $key 对象键（文件路径）
 */
function aws_file_get_and_display(string $bucketName, string $key): void
{
    $s3Client = getS3Client();

    try {
        $result = $s3Client->getObject([
            'Bucket' => $bucketName,
            'Key'    => $key
        ]);

        // 设置HTTP响应头，告知浏览器文件类型和处理方式
        header("Content-Type: {$result['ContentType']}");
        // 如果是下载而不是直接显示，可以添加Content-Disposition头
        // header("Content-Disposition: attachment; filename=\"" . basename($key) . "\"");

        // 直接输出文件内容
        echo $result['Body'];

    } catch (AwsException $e) {
        // 处理文件不存在或其他S3错误
        http_response_code(404); // 例如，文件未找到
        echo "无法获取文件: " . $e->getMessage() . "\n";
    }
}

// 示例用法
// 假设 'Cases/my-document.pdf' 已成功上传
// aws_file_get_and_display($bucket, 'Cases/my-document.pdf'); // 在浏览器中调用此函数

?>