Laravel使用aws-sdk-php-laravel获取Amazon QLDB明文数据的方法

问题根因 #

Amazon QLDB 查询接口默认返回 Amazon Ion 二进制编码格式 的结果，PHP SDK 不会自动做反序列化处理，必须使用官方 Ion 解析库转换后，才能得到可读的纯文本/结构化数据。

实现步骤 #

1. 安装 Ion 解析依赖 #

执行 Composer 命令安装官方解析库：
composer require amazon-ion/ion-php
如果提示包已存在（aws-sdk-php 通常内置该依赖），可跳过安装步骤。

2. 改造业务代码解析结果 #

原代码的会话、事务调用逻辑基本可用，仅需要在拿到查询返回值后，对二进制结果做解析，改造后的完整示例：

use AWS;
use Amazon\Ion\IonReaderBuilder;
use function Amazon\Ion\phputil\ion_to_array;

public function index(){
    // 初始化QLDB会话客户端
    $client = AWS::createClient('qldb-session');

    // 1. 启动目标账本的会话
    $startSessionResult = $client->sendCommand([
        'StartSession' => [
            'LedgerName' => 'Vacine-issue'
        ]
    ]);
    $sessionToken = $startSessionResult['StartSession']['SessionToken'];

    // 2. 开启查询事务
    $startTxResult = $client->sendCommand([
        'StartTransaction' => [],
        'SessionToken' => $sessionToken
    ]);
    $transactionId = $startTxResult['StartTransaction']['TransactionId'];

    // 3. 执行查询SQL
    $execResult = $client->sendCommand([
        'ExecuteStatement' => [
            'Statement' => 'SELECT * FROM Vaccination',
            'TransactionId' => $transactionId,
        ],
        'SessionToken' => $sessionToken
    ]);

    // 4. 把ION二进制结果转成PHP原生数组（纯文本可读）
    $resultList = [];
    // 遍历每一行结果的二进制ION数据
    foreach ($execResult['ExecuteStatement']['IOBinding'] as $rowBinding) {
        $reader = IonReaderBuilder::builder()->buildReader($rowBinding['IonBinary']);
        $resultList[] = ion_to_array($reader);
    }

    // 释放会话（推荐添加，避免占用QLDB会话配额）
    $client->sendCommand([
        'EndSession' => [],
        'SessionToken' => $sessionToken
    ]);

    // 输出最终可读结果
    dd($resultList);
}

注意事项 #

• 原代码中强制把 SDK 返回结果转成对象的写法，可替换为数组访问，避免因返回结构变更引发类型错误。
• 解析后得到的数组中，所有字段都是纯文本、数字、布尔等原生PHP类型，无二进制编码内容，直接可以用于业务逻辑处理。
• 查询完成后务必释放会话，防止长期占用资源导致后续请求触发QLDB会话配额上限。

内容的提问来源于stack exchange，提问作者Malik Hanzala