Conector de Aurora DSQL para PHP PDO_PGSQL

El conector de Aurora DSQL para PHP es un conector de PHP basado en PDO_PGSQL que integra la autenticación de IAM para conectar aplicaciones PHP a clústeres de Amazon Aurora DSQL.

El conector se encarga de la generación de tokens, la configuración SSL y la gestión de conexiones para que usted pueda centrarse en la lógica de su aplicación.

Acerca del conector

El conector de Aurora DSQL para PHP agrega una capa de autenticación sobre PDO_PGSQL que gestiona la generación de tókenes de IAM, lo que permite conectarse a Aurora DSQL con los flujos de trabajo de PDO existentes. Amazon Aurora DSQL requiere una autenticación de IAM con tókenes de duración limitada y el conector administra automáticamente la generación de tókenes.

¿Qué es la autenticación de Aurora DSQL?

En Aurora DSQL, la autenticación implica:

El conector de Aurora DSQL para PHP comprende estos requisitos y genera automáticamente los tókenes de autenticación de IAM al establecer las conexiones.

Características

Aplicación de ejemplo

Para ver un ejemplo completo, consulte la aplicación de ejemplo en GitHub.

Guía de inicio rápido

Requisitos

Instalación

Añada el paquete a su proyecto:

composer require awslabs/aurora-dsql-pdo-pgsql

Uso

Conexión basada en la configuración

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

Formato de la cadena de conexión

Para scripts simples o cuando prefiera la sintaxis de cadenas de conexión, el conector admite cadenas de conexión postgres:// y postgresql:// con parámetros de consulta específicos de Aurora DSQL:

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

Parámetros de consulta compatibles: region, profile, tokenDurationSecs, ormPrefix.

Reintento de OCC

Aurora DSQL utiliza control de simultaneidad optimista (OCC). Cuando dos transacciones modifican los mismos datos, la primera en confirmarse tiene prioridad y la segunda recibe un error de OCC.

El reintento de OCC es opcional. Establezca occMaxRetries en la configuración para habilitar el reintento automático con retroceso exponencial y fluctuación:

$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");
});

Opciones de configuración

El conector también admite las cadenas de conexión postgres:// y postgresql:// con los parámetros de consulta para configuración. Parámetros de consulta compatibles: region, profile, tokenDurationSecs y ormPrefix.

Autenticación

El conector gestiona automáticamente la autenticación de Aurora DSQL generando tokens usando las credenciales de AWS. Si no proporciona la región de AWS, el conector la analiza a partir del nombre de host.

Para obtener más información sobre la autenticación en Aurora DSQL, consulte Autenticación y autorización para Aurora DSQL.

Administrador frente a usuarios habituales