Introduzione

Il database PostgreSQL � un prodotto OpenSource ed � disponibile gratuitamente. Postgres, sviluppato originariamente nel Dipartimento di Informatica dell'Universit� di Berkeley, ha anticipato molti dei concetti su oggetti e relazioni che ora stanno diventando disponibili in alcuni database commerciali. Postgres fornisce supporto per il linguaggio SQL/92/SQL99, integrit� transazionale ed estensibilit� dei tipi. PostgreSQL � un discendente open source dell'originario codice di Berkeley.

Requisiti

Per utilizzare il supporto a PostgreSQL, occorre PostgreSQL 6.5 o versioni pi� recenti. PostgreSQL 7.0 o successivi permettono di abilitare tutte le funzionalit� di questo modulo. PostgreSQL ammette molte codifiche di carattere, tra cui la codifica multibyte. La versione corrente e maggiori informazioni su PostgreSQL sono disponibili su .

Istallazione

Per abilitare il supporto PostgreSQL, --with-pgsql[=DIR] � richiesto quando si compila il PHP. Se � disponibile il modulo di libreria dinamico, questo pu� essere caricato usando la direttiva extension in php.ini o la funzione dl().

Configurazione Runtime

Le direttive ini previste sono descritte in php.ini-dist che � distribuito con il pacchetto dei sorgenti.

Utilizzo e suggerimenti

Non tutte le funzioni sono supportate su tutte le architetture. Dipende dalla versione di libpq (L'interfaccia Client C per PostgreSQL) e da come libpq � compilato. Se c'� una funzione mancante, libpq non supporta la feature richiesta per quella funzione.

� importante usare versioni di libpq pi� recenti rispetto al Server PostgreSQL al quale ci si vuole collegare. Se si usa una versione di libpq pi� vecchia rispetto al Server PostgreSQL al quale ci si vuole collegare, si andr� probabilmente incontro a problemi.

Fin dalla versione 6.3 (03/02/1998) PostgreSQL usa gli unix domain socket di default. La porta TCP, di default, NON verr� aperta. La tabella sottostante descrive queste nuove possibilit� di connessione. Questo socket pu� essere trovato in /tmp/.s.PGSQL.5432. Questa opzione pu� venire abilitata con la flag '-i' da postmaster e il suo significato �: "ascolta i socket TCP/IP cos� come gli Unix domain socket".

Si pu� stabilire una connessione al server PostgreSQL usando le seguenti coppie di valori impostate nella stringa di comando: $conn = pg_connect("host=IlMioHost port=LaMiaPorta tty=myTTY options=LeMieOpzioni dbname=IlMioDB user=IlMioUtente password=LaMiaPassword ");

L'uso della sintassi in uso precedentemente: $conn = pg_connect ("host", "port", "options", "tty", "dbname") � deprecato.

Le variabili d'ambiente modificano il comportamento server/client di PostgreSQL. Per esempio, il modulo PostgreSQL si baser� sulla variabile PGHOST quando il nome dell'host � omesso nella stringa di connessione. Le variabili d'ambiente riconosciute sono diverse da versione a versione. Consultare il Manuale del Programmatore PostgreSQL (lbpq - Variabili d'Ambiente) per ulteriori dettagli.

Assicurarsi di aver impostato le variabili d'ambiente per l'utente appropriato. Usare $_ENV o getenv() per controllare quali variabili d'ambiente sono disponibili al processo corrente.

PGHOST=pgsql.example.com
PGPORT=7890
PGDATABASE=web-system
PGUSER=web-user
PGPASSWORD=segreta
PGDATESTYLE=ISO
PGTZ=JST
PGCLIENTENCODING=EUC-JP

export PGHOST PGPORT PGDATABASE PGUSER PGPASSWORD PGDATESTYLE PGTZ PGCLIENTENCODING

Costanti Predefinite

Queste costanti sono definite da questa estensione e sono disponibili solo se l'estensione � stata compilata nel PHP o se � stata caricata dinamicamente a runtime.

Esempi

A partire da PostgreSQL 7.1.0, il tipo di dato text ha 1GB come dimensione massima. Nelle versioni pi� vecchie di PostgreSQL il tipo di dato text � limitato dalla dimensione del block. (Default 8KB. Massimo 32KB, specificato al momento della compilazione)

Per usare l'interfaccia large object (lo), � necessario includerla entro un blocco di una transazione. Un blocco di transazione inizia con un comando SQL BEGIN e se la transazione � stata valida, termina con COMMIT o END. Se la transazione fallisce, essa deve venire chiusa con ROLLBACK o ABORT.

<?php
    $database = pg_connect ("dbname=jacarta");
    pg_query ($database, "begin");
    $oid = pg_lo_create ($database);
    echo "$oid\n";
    $handle = pg_lo_open ($database, $oid, "w");
    echo "$handle\n";
    pg_lo_write ($handle, "dati large object");
    pg_lo_close ($handle);
    pg_query ($database, "commit");
?>