PHP：move_uploaded_file()是否兼容Amazon S3流包装器？

实际情况与原因 #

move_uploaded_file完全不支持S3流包装器，哪怕函数返回true，这是典型的“假成功”陷阱：

• 该函数是为本地文件系统设计的原子操作，仅支持本地路径，无法处理s3://这类远程流协议。
• 执行时它会先校验原文件是否为HTTP上传的临时文件，随后直接删除原文件，但由于无法向S3完成写入操作，最终导致原临时文件消失、S3桶中也无目标文件，却错误返回true（属于PHP流包装器与该函数的兼容性bug）。

极简替代方案 #

方案1：原生PHP函数组合实现 #

先通过copy()将临时文件复制到S3，确认成功后再删除原临时文件：

$tmpFile = "/tmp/phpQ6IijD";
$s3Path = "s3://my-bucket/cabbc0ad015b8a7038925ae4b4a6335e";

// 先完成S3写入，再清理本地临时文件
if (copy($tmpFile, $s3Path)) {
    unlink($tmpFile);
    echo "文件上传成功";
} else {
    echo "文件上传失败";
}

注意：需确保S3流包装器已正确配置权限、密钥等信息，否则copy()会执行失败。

方案2：AWS SDK实现（更稳定可靠） #

若项目已引入AWS PHP SDK，推荐使用官方方法直接上传，比流包装器兼容性更好：

use Aws\S3\S3Client;

$s3 = new S3Client([
    'version' => 'latest',
    'region'  => '你的存储桶区域',
    'credentials' => [
        'key'    => '你的AWS访问密钥',
        'secret' => '你的AWS密钥密码',
    ]
]);

$tmpFile = "/tmp/phpQ6IijD";
$bucket = "my-bucket";
$key = "cabbc0ad015b8a7038925ae4b4a6335e";

try {
    $s3->putObject([
        'Bucket' => $bucket,
        'Key'    => $key,
        'Body'   => fopen($tmpFile, 'rb'),
        'ACL'    => 'public-read' // 根据需求设置文件权限
    ]);
    unlink($tmpFile);
    echo "文件上传成功";
} catch (\Exception $e) {
    echo "上传失败：" . $e->getMessage();
}

内容的提问来源于stack exchange，提问作者Jay Bienvenu