本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

適用於 PHP 的 Aurora DSQL 連接器 PDO_PGSQL

Aurora DSQL Connector for PHP 是建置在 上的 PHP 連接器PDO_PGSQL，整合 IAM 身分驗證，以將 PHP 應用程式連線至 Amazon Aurora DSQL 叢集。

連接器會處理字符產生、SSL 組態和連線管理，讓您可以專注於應用程式邏輯。

關於連接器

Aurora DSQL Connector for PHP 在 上新增了身分驗證層PDO_PGSQL，可處理產生 IAM 字符，讓您使用現有的 PDO 工作流程連線到 Aurora DSQL。Amazon Aurora DSQL 需要具有時間限制權杖的 IAM 身分驗證，連接器會自動為您管理權杖產生。

什麼是 Aurora DSQL 身分驗證？

在 Aurora DSQL 中，身分驗證涉及：

Aurora DSQL Connector for PHP 了解這些要求，並在建立連線時自動產生 IAM 身分驗證字符。

功能

範例應用程式

如需完整範例，請參閱 GitHub 上的範例應用程式。

快速入門指南

要求

安裝

將套件新增至您的專案：

composer require awslabs/aurora-dsql-pdo-pgsql

Usage

組態型連線

<?php

require_once 'vendor/autoload.php';

use Aws\AuroraDsql\PdoPgsql\AuroraDsql;
use Aws\AuroraDsql\PdoPgsql\DsqlConfig;

$config = new DsqlConfig(
    host: 'your-cluster.dsql.us-east-1.on.aws',
    occMaxRetries: 3
);
$pdo = AuroraDsql::connect($config);

// Read
$stmt = $pdo->query('SELECT 1 AS result');
$row = $stmt->fetch(PDO::FETCH_ASSOC);
echo "Connected: {$row['result']}\n";

// Transactional write with automatic OCC retry
$id = $pdo->transaction(function (PDO $conn): string {
    $stmt = $conn->prepare('INSERT INTO users (name) VALUES (?) RETURNING id');
    $stmt->execute(['Alice']);
    return $stmt->fetchColumn();
});

連線字串格式

對於簡單的指令碼或當您偏好連線字串語法時，連接器支援 postgres://和具有 Aurora DSQL 特定查詢參數的postgresql://連線字串：

$pdo = AuroraDsql::connectFromDsn(
    'postgres://admin@your-cluster.dsql.us-east-1.on.aws/postgres?region=us-east-1'
);

支援的查詢參數：region、profile、tokenDurationSecs、ormPrefix。

OCC 重試

Aurora DSQL 使用樂觀並行控制 (OCC)。當兩個交易修改相同的資料時，第一個遞交獲勝，第二個收到 OCC 錯誤。

OCC 重試是選擇加入。在組態occMaxRetries中設定 ，以啟用具有指數退避和抖動的自動重試：

$config = new DsqlConfig(
    host: 'your-cluster.dsql.us-east-1.on.aws',
    occMaxRetries: 3
);
$pdo = AuroraDsql::connect($config);

// Single statements are automatically retried via exec()
$pdo->exec("CREATE INDEX ASYNC ON users (email)");

// Multi-statement transactions are retried via transaction()
$pdo->transaction(function (PDO $conn) {
    $conn->exec("UPDATE accounts SET balance = balance - 100 WHERE id = 1");
    $conn->exec("UPDATE accounts SET balance = balance + 100 WHERE id = 2");
});

組態選項

連接器也接受具有 組態查詢參數的 postgres://和 postgresql://連線字串。支援的查詢參數：region、tokenDurationSecs、 profile和 ormPrefix。

身分驗證

連接器會使用 AWS 登入資料產生字符，自動處理 Aurora DSQL 身分驗證。如果您未提供區域，連接器會從主機名稱剖析該 AWS 區域。

如需 Aurora DSQL 中身分驗證的詳細資訊，請參閱Aurora DSQL 的身分驗證和授權。

管理員與一般使用者