PHP PDO_PGSQL용 Aurora DSQL 커넥터

PHP용 Aurora DSQL 커넥터는 PHP 애플리케이션을 Amazon Aurora DSQL 클러스터에 연결하기 위한 IAM 인증을 통합하는 PDO_PGSQL를 기반으로 구축된 PHP 커넥터입니다.

커넥터는 토큰 생성, SSL 구성 및 연결 관리를 처리하므로 애플리케이션 로직에 집중할 수 있습니다.

커넥터 정보

PHP용 Aurora DSQL 커넥터는 IAM 토큰 생성을 처리하는 PDO_PGSQL 위에 인증 계층을 추가하여 기존 PDO 워크플로를 사용하여 Aurora DSQL에 연결할 수 있도록 합니다. Amazon Aurora DSQL에는 시간 제한 토큰을 사용한 IAM 인증이 필요하며, 커넥터는 토큰 생성을 자동으로 관리합니다.

Aurora DSQL 인증이란 무엇인가요?

Aurora DSQL에서 인증에는 다음이 포함됩니다.

PHP용 Aurora DSQL 커넥터는 이러한 요구 사항을 이해하고 연결을 설정할 때 IAM 인증 토큰을 자동으로 생성합니다.

특성

애플리케이션 예시

전체 예제는 GitHub의 예제 애플리케이션을 참조하세요.

빠른 시작 설명서

요구 사항

설치

패키지를 프로젝트에 추가합니다.

composer require awslabs/aurora-dsql-pdo-pgsql

사용법

구성 기반 연결

<?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();
});

연결 문자열 형식

간단한 스크립트를 사용하거나 연결 문자열 구문을 선호하는 경우, 커넥터는 Aurora DSQL 관련 쿼리 파라미터를 사용한 postgres:// 및 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, profile, tokenDurationSecs, ormPrefix입니다.

Authentication

커넥터는 AWS 자격 증명을 사용해 토큰을 생성하여 Aurora DSQL 인증을 자동으로 처리합니다. AWS 리전을 제공하지 않으면 커넥터가 호스트 이름에서 리전을 구문 분석합니다.

Aurora DSQL의 인증에 대한 자세한 내용은 Aurora DSQL에 대한 인증 및 권한 부여 섹션을 참조하세요.

관리자와 일반 사용자