 |
|
C. Funzioni PostgreSQL
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, transazioni, integrità referenziale, stored procedures 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 http://www.postgresql.org/ e http://techdocs.postgresql.org/.
Installazione
In order to enable PostgreSQL support, --with-pgsql[=DIR] is required when you compile PHP. DIR is the PostgreSQL base install directory, defaults to /usr/local/pgsql. If shared object module is available, PostgreSQL module may be loaded using extension directive in php.ini or dl() function.
Configurazione di Runtime
Il comportamento di queste funzioni è influenzato dalle impostazioni di php.ini.
Tabella 1. PostgreSQL configuration options
| Name | Default | Changeable | Changelog |
|---|---|---|---|
| pgsql.allow_persistent | "1" | PHP_INI_SYSTEM | |
| pgsql.max_persistent | "-1" | PHP_INI_SYSTEM | |
| pgsql.max_links | "-1" | PHP_INI_SYSTEM | |
| pgsql.auto_reset_persistent | "0" | PHP_INI_SYSTEM | Available since PHP 4.2.0. |
| pgsql.ignore_notice | "0" | PHP_INI_ALL | Available since PHP 4.3.0. |
| pgsql.log_notice | "0" | PHP_INI_ALL | Available since PHP 4.3.0. |
Breve descrizione dei parametri di configurazione.
- pgsql.allow_persistent boolean
Whether to allow persistent Postgres connections.
- pgsql.max_persistent integer
The maximum number of persistent Postgres connections per process.
- pgsql.max_links integer
The maximum number of Postgres connections per process, including persistent connections.
- pgsql.auto_reset_persistent integer
Detect broken persistent links with pg_pconnect(). Needs a little overhead.
- pgsql.ignore_notice integer
Whether or not to ignore PostgreSQL backend notices.
- pgsql.log_notice integer
Whether or not to log PostgreSQL backends notice messages. The PHP directive pgsql.ignore_notice must be off in order to log notice messages.
Utilizzo e suggerimenti
| Avvertimento |
L'utilizzo del modulo PostgreSQL con PHP 4.0.6 non è raccomandato a causa di un bug nella gestione dei messaggi. Si usi PHP 4.1.0 o successivi. |
| Avvertimento | ||||||||||||||||||||||||||||||||||||||||||||
I nomi delle funzioni relative a PostgreSQL verranno cambiate a partire dalla versione 4.2.0 per conformarsi agli standard di sviluppo attuali. La maggior parte dei nuovi nomi avrà underscore aggiuntivi, per esempio pg_lo_open(). Alcune funzioni verranno rinominate per dare consistenza. Per esempio pg_exec() diventerà pg_query(). I vecchi nomi potranno essere usati nella versione 4.2.0 e in alcune versioni successive alla 4.2.0, ma potranno essere cancellati in futuro. Tabella 2. Nomi di funzione cambiati
La vecchia sintassi di pg_connect()/pg_pconnect() sarà deprecata per supportare, in futuro, connessioni asincrone. Si usi una stringa di connessione con pg_connect() e pg_pconnect(). |
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".
Tabella 3. Postmaster e PHP
| Postmaster | PHP | Status |
|---|---|---|
| postmaster & | pg_connect("dbname=NomeMioDatabase"); | OK |
| postmaster -i & | pg_connect("dbname=NomeMioDatabase"); | OK |
| postmaster & | pg_connect("host=localhost dbname=NomeMioDatabase"); | Unable to connect to PostgreSQL server: connectDB() failed: Is the postmaster running and accepting TCP/IP (with -i) connection at 'localhost' on port '5432'? in /path/to/file.php on line 20. |
| postmaster -i & | pg_connect("host=localhost dbname=NomeMioDatabase"); | OK |
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 (libpq - 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.
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.
- PGSQL_ASSOC (integer)
- PGSQL_NUM (integer)
- PGSQL_BOTH (integer)
- PGSQL_CONNECTION_BAD (integer)
- PGSQL_CONNECTION_OK (integer)
- PGSQL_SEEK_SET (integer)
- PGSQL_SEEK_CUR (integer)
- PGSQL_SEEK_END (integer)
- PGSQL_ESCAPE_STRING (integer)
- PGSQL_ESCAPE_BYTEA (integer)
- PGSQL_EMPTY_QUERY (integer)
- PGSQL_COMMAND_OK (integer)
- PGSQL_TUPLES_OK (integer)
- PGSQL_COPY_OUT (integer)
- PGSQL_COPY_IN (integer)
- PGSQL_BAD_RESPONSE (integer)
- PGSQL_NONFATAL_ERROR (integer)
- PGSQL_FATAL_ERROR (integer)
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.
- Sommario
- pg_affected_rows -- Restituisce il numero delle tuple coinvolte dall'ultimo comando
- pg_cancel_query -- Annulla una query asincrona
- pg_client_encoding -- Restituisce la codifica caratteri del client
- pg_close -- Chiude una connessione PostgreSQL
- pg_connect -- Stabilisce una connessione PostgreSQL
- pg_connection_busy -- Riferisce se una connessione è occupata o meno
- pg_connection_reset -- Rpristina la connessione (riconnette)
- pg_connection_status -- Restituisce lo stato di una connessione
- pg_convert -- Converte i valori di un array associativo in una forma compatibile con i comandi SQL.
- pg_copy_from -- Inserisce le tuple in una tabella prendendole da un array
- pg_copy_to -- Copia una tabella in un array
- pg_dbname -- Restituisce il nome del database
- pg_delete -- Cancella le tuple.
- pg_end_copy -- Esegue una sincronizzazione con il backend PostgreSQL
- pg_escape_bytea -- Aggiunge le sequenze di escape ai dati binari nel tipo bytea
- pg_escape_string -- Aggiunge le sequenze di escape nei tipi text/char
- pg_fetch_all -- Carica tutte le tuple in un array
- pg_fetch_array -- Carica una tupla in un array
- pg_fetch_assoc -- Fetch a row as an array
- pg_fetch_object -- Carica una tupla in un oggetto
- pg_fetch_result -- Restituisce i valori da una risorsa di risultato
- pg_fetch_row -- Carica una tupla in un array
- pg_field_is_null -- Verifica se un campo è NULL
- pg_field_name -- Restituisce il nome di un campo
- pg_field_num -- Restituisce la posizione del campo specificato
- pg_field_prtlen -- Restituisce la lunghezza "stampabile" di un valore
- pg_field_size -- Restituisce la reale dimensione di memorizzazione del campo
- pg_field_type_oid -- Returns the type ID (OID) for the corresponding field number
- pg_field_type -- Restituisce il nome del tipo del campo specificato
- pg_free_result -- Libera la memoria allocata per i risultati
- pg_get_notify -- Ping database connection
- pg_get_pid -- Ping database connection
- pg_get_result -- Recupera i risultati di una query asincrona
- pg_host -- Restituisce il nome dell'host associato alla connessione
- pg_insert -- Inserisce un array in una tabella.
- pg_last_error -- Restituisce l'ultimo messaggio d'errore di una connessione
- pg_last_notice -- Restituisce l'ultimo messaggio di notifica dal server PostgreSQL
- pg_last_oid -- Restituisce l'oid dell'ultimo oggetto
- pg_lo_close -- Chiude un large object
- pg_lo_create -- Crea un large object
- pg_lo_export -- Esporta un large object salvandolo su un file
- pg_lo_import -- Importa un large object da un file
- pg_lo_open -- Apre un large object
- pg_lo_read_all -- Legge interamente un large object e lo manda direttamente al browser
- pg_lo_read -- Legge un large object
- pg_lo_seek -- Ricerca la posizione di un large object
- pg_lo_tell -- Restituisce la posizione attuale in un large object
- pg_lo_unlink -- Cancella un large object
- pg_lo_write -- Scrive un large object
- pg_meta_data -- Ottiene la definizione di una tabella.
- pg_num_fields -- Restituisce il numero di campi
- pg_num_rows -- Restituiscein numero di tuple
- pg_options -- Estrae le opzioni associate alla connessione
- pg_parameter_status -- Returns the value of a server parameter
- pg_pconnect -- Open a persistent PostgreSQL connection
- pg_ping -- Ping database connection
- pg_port -- Restituisce il numero di porta associato alla connessione
- pg_put_line -- Invia una stringa terminata da NULL al backend PostgreSQL
- pg_query -- Esegue una query
- pg_result_error -- Restituisce i messaggio di errore associato al risultato
- pg_result_seek -- Set internal row offset in result resource
- pg_result_status -- Recupera lo stato del risultato di una query
- pg_select -- Seleziona delle tuple.
- pg_send_query -- Invia una query in modo asincrono
- pg_set_client_encoding -- Imposta la codifica del client
- pg_trace -- iAbilita il tracciamento di una connessione PostgreSQL
- pg_tty -- Restituisce il nome della tty associata alla connessione
- pg_unescape_bytea -- Escape binary for bytea type
- pg_untrace -- Disabilita il tracciamento di una connessione PostgreSQL
- pg_update -- Modifica le tuple della tabella
- pg_version -- Returns an array with client, protocol and server version (when available)
Hosting by: hurra.com
Generated: 2007-01-26 17:56:53