AWS SDK for PHP 版本升级指南与技术解析

AWS SDK for PHP 版本升级指南与技术解析

aws-sdk-php Official repository of the AWS SDK for PHP (@awsforphp) 项目地址: https://gitcode.com/gh_mirrors/aw/aws-sdk-php

概述

本文深入解析 AWS SDK for PHP 各版本间的升级注意事项，帮助开发者平滑过渡到新版本。作为 AWS 官方 PHP 客户端库，该 SDK 提供了与 AWS 服务交互的便捷接口。

从 2.x 升级到 3.x

重大架构升级

3.0 版本是一次重大架构革新，主要改进包括：

• 全面采用现代 PHP 标准
• 性能优化
• 依赖库升级
• 整合两年来的用户反馈

兼容性说明

基础使用模式保持兼容：

$result = $client->operation($params);

迁移建议

1. 废弃功能处理：

   • 所有 facade 类和方法已标记为废弃
   • Enum 类将被移除，建议直接使用原始值

2. 异常处理改进：

   • 新增 getAwsErrorCode(), getAwsErrorType() 和 getAwsRequestId() 方法
   • 推荐捕获顶层服务异常而非细分异常类

从 2.7 升级到 2.8

AWS Lambda 服务变更

Lambda API 在预览期后进行了重大调整：

• invokeAsync() 操作保持不变
• 其他 API 接口有显著变化

兼容方案：

$client = LambdaClient::factory([
    'version' => '2014-11-11'  // 使用旧版 API
]);

3.0 版本准备

1. 废弃标记：

   • 所有 facade 类和方法标记为废弃
   • 为异常类添加兼容方法

2. 最佳实践：

   • 避免使用 Enum 类
   • 捕获顶层服务异常

从 2.6 升级到 2.7

变更说明

2.7 版本向后兼容，主要变更：

• DynamoDb 命名空间部分标记为废弃
• 无强制性破坏性变更

从 2.5 升级到 2.6

Amazon CloudSearch 重大更新

默认使用 2013-01-01 API 版本，主要改进：

• 支持 33 种语言
• 高亮显示功能
• 自动完成建议
• 地理空间搜索
• IAM 集成

兼容方案：

$client = CloudSearchClient::factory([
    'version' => '2011-02-01'  // 使用旧版 API
]);

从 2.4 升级到 2.5

Amazon EC2 变更

RequestSpotInstances 操作参数结构调整： 旧方式：

'LaunchSpecification' => [
    'MonitoringEnabled' => true
]

新方式：

'LaunchSpecification' => [
    'Monitoring' => ['Enabled' => true]
]

AWS CloudTrail API 改进

1. CreateTrail/UpdateTrail：

   • 不再使用 Trail 对象参数
   • 改为直接传递独立参数

2. GetTrailStatus：

   • 废弃字段：LatestDeliveryAttemptTime 等
   • 新增字段：LatestDeliveryTime 等

从 2.3 升级到 2.4

Amazon CloudFront 变更

2013-05-12 API 版本引入：

• 自定义 SSL 证书支持
• 破坏性变更

兼容方案：

$client = CloudFrontClient::factory([
    'version' => '2012-05-05'
]);

依赖升级

要求 Guzzle 3.7 或更高版本

从 2.2 升级到 2.3

Amazon DynamoDB 变更

2012-08-10 API 版本引入：

• 本地二级索引支持
• 键值指定方式变更

兼容方案：

$client = DynamoDbClient::factory([
    'version' => '2011-12-05'
]);

依赖升级

要求 Guzzle 3.4.1 或更高版本

从 2.1 升级到 2.2

主要改进

• 支持所有 AWS 服务
• 要求 Guzzle 3.3 或更高版本

从 2.0 升级到 2.1

等待器(Waiter)变更

参数传递方式改进： 旧方式：

'foo/baz'  // 字符串拼接

新方式：

[
    'Bucket' => 'foo',
    'Key' => 'baz',
    'waiter.max_attempts' => 3
]

升级最佳实践

1. 测试环境先行：先在测试环境验证升级
2. 版本锁定：明确指定服务 API 版本
3. 异常处理：更新异常捕获逻辑
4. 依赖管理：确保兼容的 Guzzle 版本

通过遵循本指南，开发者可以系统性地规划升级路径，确保应用平稳过渡到新版本 SDK。

aws-sdk-php Official repository of the AWS SDK for PHP (@awsforphp) 项目地址: https://gitcode.com/gh_mirrors/aw/aws-sdk-php