php 8.6通过aws sdk for php上传大文件时,可使用multipartuploader并保留异常携带的uploadstate,在同一进程中恢复失败分段。给恢复次数设上限,超过上限后中止未完成上传;不能只捕获异常就把残留分段当作已清理。

官方文档:MultipartUploader object
准备权限、文件和依赖
安装aws/aws-sdk-php:^3.407并核对平台要求。提前配置AWS凭据提供链,给目标桶授予当前任务所需的分段上传及AbortMultipartUpload权限。下例使用受控本地文件,替换桶名、对象键和区域;同一对象键已存在时可能覆盖对象,因此先确定版本策略。

官方文档:Aborting a multipart upload
有界恢复,并在最后一次失败后中止
<?php require __DIR__ . '/vendor/autoload.php';
use Aws\S3\S3Client;
use Aws\S3\MultipartUploader;
use Aws\Exception\MultipartUploadException;
$s3 = new S3Client(['version' => '2006-03-01', 'region' => 'us-east-1']);
$source = __DIR__ . '/large-file.zip';
$uploader = new MultipartUploader($s3, $source, [
'bucket' => 'your-bucket', 'key' => 'imports/large-file.zip', 'concurrency' => 2,
]);
for ($attempt = 1; $attempt upload();
echo "Multipart upload completed\n";
break;
} catch (MultipartUploadException $e) {
if ($attempt === 3) {
try { $s3->abortMultipartUpload($e->getState()->getId()); }
catch (Throwable $abortError) {
throw new RuntimeException('Upload failed; abort also failed. Keep upload ID for cleanup.', 0, $e);
}
throw $e;
}
usleep(250000 * $attempt);
$uploader = new MultipartUploader($s3, $source, ['state' => $e->getState()]);
}
}
恢复状态与生命周期各有边界
示例只处理同一进程内的恢复,重试期间源文件不能改变。终止响应失败时,记录该任务的Bucket、Key、UploadId并继续运维清理,不记录密钥。进程崩溃或被终止不会进入catch,可另设桶生命周期清理未完成分段。上传成功只表示对象上传完成,不代表对象公开可读,也不代替业务侧内容核对。
使用官方Model Context Protocol PHP SDK将PHP应用程序功能暴露为MCP工具、资源和提示,用于代理工作流。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










