AWS PHP SDK 是否必须安装 AWS Common Runtime？-php教程-PHP中文网

AWS PHP SDK 是否必须安装 AWS Common Runtime？

AWS Common Runtime（CRT）并非所有 PHP 应用使用 AWS SDK 的必需依赖；仅当调用特定功能（如 EventBridge 的 putEvents 启用 Signature V4A、S3 多区域访问点等）时才强制要求，常规操作完全可绕过 CRT 正常运行。

aws common runtime（crt）并非所有 php 应用使用 aws sdk 的必需依赖；仅当调用特定功能（如 eventbridge 的 `putevents` 启用 signature v4a、s3 多区域访问点等）时才强制要求，常规操作完全可绕过 crt 正常运行。

在 Laravel 项目中集成 AWS PHP SDK 时，遇到类似 Aws\Exception\CommonRuntimeException: AWS Common Runtime for PHP is required to use Signature V4A 的报错，往往让人误以为整个 SDK 体系已全面转向 CRT 依赖。实际上，这是个精准的、按需触发的限制，而非全局强制要求。

✅ 什么情况下你不需要安装 CRT？

绝大多数 AWS 服务和操作——包括 S3 文件上传/下载、DynamoDB CRUD、SQS 消息收发、Lambda 调用、CloudWatch 日志写入等——均默认使用标准 Signature Version 4（SigV4），完全兼容原生 PHP cURL 或 Guzzle HTTP 客户端，无需 CRT。例如：

use Aws\EventBridge\EventBridgeClient;

$client = new EventBridgeClient([
    'region' => 'us-east-1',
    'version' => '2015-10-07',
    'credentials' => [
        'key'    => env('AWS_ACCESS_KEY_ID'),
        'secret' => env('AWS_SECRET_ACCESS_KEY'),
    ],
]);

// ✅ 这行调用不触发 SigV4A，无需 CRT
$result = $client->listEventBuses();

⚠️ 什么情况下你必须安装 CRT？

当前（截至 AWS SDK for PHP v3.290+）仅两类场景强制依赖 CRT：

EventBridge 的 putEvents() 启用 TraceHeader 或跨账户事件投递（启用 SigV4A 签名）；
S3 Multi-Region Access Points（MRAP）的请求签名。

若你的代码未显式启用这些高级特性（如未设置 'signature_version' => 'v4a' 或未使用 MRAP endpoint），则该异常通常源于 SDK 自动降级失败或配置误触——此时应优先检查客户端配置，而非立即部署 CRT。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

? 推荐替代方案（避免 CRT）

显式禁用 SigV4A（推荐）：在客户端构造时指定标准签名版本：

$client = new EventBridgeClient([
    'region' => 'us-east-1',
    'version' => '2015-10-07',
    'signature_version' => 'v4', // 强制使用传统 SigV4
    'credentials' => new \Aws\Credentials\Credentials(
        env('AWS_ACCESS_KEY_ID'),
        env('AWS_SECRET_ACCESS_KEY')
    ),
]);

验证凭证来源：确保凭证通过安全方式注入（如 .env + config/aws.php），避免因凭证缺失导致 SDK 尝试回退到高安全性签名流程：

// config/aws.php
'credentials' => [
    'key'    => env('AWS_ACCESS_KEY_ID'),
    'secret' => env('AWS_SECRET_ACCESS_KEY'),
],
'region' => env('AWS_DEFAULT_REGION', 'us-east-1'),