Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Connettore Aurora DSQL per PHP PDO_PGSQL

L'Aurora DSQL Connector per PHP è un connettore PHP basato su PDO_PGSQLche integra l'autenticazione IAM per connettere le applicazioni PHP ai cluster DSQL di Amazon Aurora.

Il connettore gestisce la generazione di token, la configurazione SSL e la gestione delle connessioni in modo che tu possa concentrarti sulla logica dell'applicazione.

Informazioni sul connettore

L'Aurora DSQL Connector per PHP aggiunge un livello di autenticazione PDO_PGSQL che gestisce la generazione di token IAM, consentendoti di connetterti ad Aurora DSQL utilizzando i flussi di lavoro PDO esistenti. Amazon Aurora DSQL richiede l'autenticazione IAM con token a tempo limitato e il connettore gestisce automaticamente la generazione di token per te.

Cos'è l'autenticazione Aurora SQL?

In Aurora DSQL, l’autenticazione prevede:

L'Aurora DSQL Connector per PHP comprende questi requisiti e genera automaticamente token di autenticazione IAM quando stabilisce connessioni.

Funzionalità

Applicazione di esempio

Per un esempio completo, vedi l'applicazione di esempio su GitHub.

Guida rapida di avvio

Requisiti

Installazione

Aggiungi il pacchetto al tuo progetto:

composer require awslabs/aurora-dsql-pdo-pgsql

Utilizzo

Connessione basata sulla configurazione

<?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 della stringa di connessione

Per script semplici o quando si preferisce la sintassi della stringa di connessione, il connettore supporta postgres:// stringhe di postgresql:// connessione con parametri di query specifici di Aurora DSQL:

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

Parametri di interrogazione supportati:,,,. region profile tokenDurationSecs ormPrefix

Riprova OCC

Aurora DSQL utilizza il controllo ottimistico della concorrenza (OCC). Quando due transazioni modificano gli stessi dati, la prima che esegue il commit vince e la seconda riceve un errore OCC.

Il nuovo tentativo OCC è facoltativo. Impostato occMaxRetries nella configurazione per abilitare il nuovo tentativo automatico con backoff e jitter esponenziali:

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

Opzioni di configurazione

Il connettore accetta postgres:// anche stringhe di postgresql:// connessione con parametri di interrogazione per la configurazione. Parametri di interrogazione supportati: regionprofile,tokenDurationSecs, eormPrefix.

Autenticazione

Il connettore gestisce automaticamente l'autenticazione Aurora DSQL generando token utilizzando credenziali. AWS Se non fornisci la AWS regione, il connettore la analizza a partire dal nome host.

Per ulteriori informazioni sull'autenticazione in Aurora DSQL, vedere. Autenticazione e autorizzazione per Aurora DSQL

Amministratore e utenti normali