Introduction

La base de données PostgreSQL est un produit Open Source, disponible sans frais. PostgreSQL, développé au département de Science informatique, à UC Berkeley, met en place la majorité des concepts des bases relationnelles actuellement disponibles sur le marché. PostgreSQL accepte le langage SQL92/SQL3, assure l'intégrité transactionnelle et l'extension de type. PostgreSQL est une évolution du code original de Berkeley.

Pré-requis

Pour accéder au support PostgreSQL, vous avez besoin de PostgreSQL 6.5 ou plus récent ; PostgreSQL 7.0 ou plus récent pour activer toutes les fonctionnalités du module PostgreSQL. PostgreSQL supporte de nombreux jeux de caractères, y compris les jeux multi-octets asiatiques. La version courante et plus de détails sur PostgreSQL sont accessibles sur le site » http://www.postgresql.org/ et la » Documentation PostgreSQL .

Installation

Afin d'activer le support PostgreSQL, l'option --with-pgsql[=DIR] est nécessaire lors de la compilation de PHP. DIR est le chemin du dossier d'installation de PostgreSQL, et par défaut il vaut /usr/local/pgsql . Si le module de chargement dynamique est disponible, le module PostgreSQL peut être chargé avec la directive extension du fichier php.ini ou via la fonction dl() .

Configuration à l'exécution

Le comportement de ces fonctions est affecté par la configuration dans le fichier php.ini .

Pour plus de détails sur les constantes PHP_INI_*, reportez-vous à Annexe I, Directives du php.ini .

Voici un éclaircissement sur l'utilisation des directives de configuration.

Types de ressources

Il y a deux types de ressource utilisé dans le module PostgreSQL. La première est l'identifiant pour la connexion à la base de données et le second est une ressource qui contient le résultat d'une requête.

Constantes pré-définies

Ces constantes sont définies par cette extension, et ne sont disponibles que si cette extension a été compilée avec PHP, ou bien chargée au moment de l'exécution.

Notes

Note: Les fonctions ne sont pas toutes supportées par toutes les versions. Cela dépend de votre version de libpq (La bibliothèque cliente de PostgreSQL C) et comment libpq est compilé. Si les extensions PHP PostreSQL sont manquantes, alors c'est parce que votre version de libpq ne les supporte pas.

Note: La plupart des fonctions PostgreSQL acceptent le paramètre connection comme premier paramètre optionnel. S'il n'est pas fourni, la dernière connexion ouverte est utilisée. Si elle n'existe pas, les fonctions retournent FALSE .

Note: PostgreSQL transforme automatiquement tous les identifiants (par exemple, les noms de tables/colonnes) en minuscule à la création d'objet et lors de la requête. Pour forcer l'utilisation des caractères majuscules ou minuscules et majuscules des identifiants, vous devez échapper l'identifiant en utilisant des guillemets ("").

Note: PostgreSQL n'a pas de commande spéciale pour récupérer les schémas des bases de données (par exemple, toutes les tables dans la base de données). À la place, il y a un schéma standard nommé information_schema dans PostgreSQL 7.4 et supérieure contenant les vues du système avec toutes les informations nécessaires, dans un format de requête facile. Voyez la » Documentation PostgreSQL pour tous les détails.

Exemples

Ce simple exemple montre comment se connecter, exécuter une requête et afficher les lignes résultantes et se déconnecter d'une base de données PostgreSQL.

Table des matières

pg_affected_rows — Retourne le nombre de lignes affectées

pg_cancel_query — Annule une requête asynchrone

pg_client_encoding — Lit l'encodage du client

pg_close — Termine une connexion PostgreSQL

pg_connect — Établit une connexion PostgreSQL

pg_connection_busy — Vérifie si la connexion PostgreSQL est occupée

pg_connection_reset — Relance la connexion au serveur PostgreSQL

pg_connection_status — Lit le statut de la connexion PostgreSQL

pg_convert — Convertit des tableaux associatifs en une commande PostgreSQL

pg_copy_from — Insère des lignes dans une table à partir d'un tableau

pg_copy_to — Copie une table dans un tableau

pg_dbname — Retourne le nom de la base de données PostgreSQL

pg_delete — Efface des lignes PostgreSQL

pg_end_copy — Synchronise avec le serveur PostgreSQL

pg_escape_bytea — Protège une chaîne pour insertion dans un champ bytea

pg_escape_string — Protège une chaîne de caractères pour l'insérer dans un champ texte

pg_execute — Envoie une requête pour exécuter une requête préparée avec les paramètres donnés et attend le résultat

pg_fetch_all_columns — Récupère toutes les lignes d'une colonne de résultats particulière en tant que tableau

pg_fetch_all — Lit toutes les lignes d'un résultat

pg_fetch_array — Lit une ligne de résultat PostgreSQL dans un tableau

pg_fetch_assoc — Lit une ligne de résultat PostgreSQL sous forme de tableau numérique

pg_fetch_object — Lit une ligne de résultat PostgreSQL dans un objet

pg_fetch_result — Retourne les valeurs d'un résultat

pg_fetch_row — Lit une ligne dans un tableau

pg_field_is_null — Teste si un champ PostgreSQL est à NULL

pg_field_name — Retourne le nom d'un champ PostgreSQL

pg_field_num — Retourne le numéro d'une colonne

pg_field_prtlen — Retourne la taille imprimée

pg_field_size — Retourne la taille interne de stockage d'un champ donné

pg_field_table — Retourne le nom ou l'oid d'une table

pg_field_type_oid — Retourne le type ID (OID) pour le numéro du champ correspondant

pg_field_type — Retourne le type d'un champ PostgreSQL donné par index

pg_free_result — Libère la mémoire

pg_get_notify — Lit le message SQL NOTIFY

pg_get_pid — Lit l'identifiant de processus du serveur PostgreSQL

pg_get_result — Lit un résultat PostgreSQL asynchrone

pg_host — Retourne le nom d'hôte

pg_insert — Insère un tableau dans une table

pg_last_error — Lit le dernier message d'erreur sur la connexion

pg_last_notice — Retourne la dernière note du serveur PostgreSQL

pg_last_oid — Retourne l'identifiant de la dernière ligne

pg_lo_close — Ferme un objet de grande taille PostgreSQL

pg_lo_create — Crée un objet de grande taille PostgreSQL

pg_lo_export — Exporte un objet de grande taille vers un fichier

pg_lo_import — Importe un objet de grande taille depuis un fichier

pg_lo_open — Ouvre un objet de grande taille PostgreSQL

pg_lo_read_all — Lit un objet de grande taille en totalité

pg_lo_read — Lit un objet de grande taille

pg_lo_seek — Modifie la position dans un objet de grande taille

pg_lo_tell — Retourne la position courante dans un objet de grande taille PostgreSQL

pg_lo_unlink — Efface un objet de grande taille PostgreSQL

pg_lo_write — Ecrit un objet de grande taille PostgreSQL

pg_meta_data — Lit les métadonnées de la table PostgreSQL

pg_num_fields — Retourne le nombre de champ

pg_num_rows — Retourne le nombre de lignes PostgreSQL

pg_options — Retourne les options PostgreSQL

pg_parameter_status — Consulte un paramètre de configuration courant du serveur

pg_pconnect — Établit une connexion PostgreSQL persistante

pg_ping — Ping la connexion à la base

pg_port — Retourne le numéro de port

pg_prepare — Envoie une requête pour créer une requête préparée avec les paramètres donnés et attend l'exécution

pg_put_line — Envoie une chaîne au serveur PostgreSQL

pg_query_params — Envoie une commande au serveur et attend le résultat, avec les capacités de passer des paramètres séparément de la commande texte SQL

pg_query — Exécute une requête PostgreSQL

pg_result_error_field — Retourne un champ individuel d'un rapport d'erreur

pg_result_error — Lit le message d'erreur associé à un résultat

pg_result_seek — Modifie la ligne courant dans un résultat

pg_result_status — Lit le statut du résultat

pg_select — Effectue une sélection PostgreSQL

pg_send_execute — Envoie une requête pour exécuter une requête préparée avec des paramètres donnés, sans attendre le(s) résultat(s)

pg_send_prepare — Envoie une requête pour créer une requête préparée avec les paramètres donnés, sans attendre la fin de son exécution

pg_send_query_params — Envoie une commande et sépare les paramètres au serveur sans attendre le(s) résultat(s)

pg_send_query — Exécute une requête PostgreSQL asynchrone

pg_set_client_encoding — Choisit l'encodage du client PostgreSQL

pg_set_error_verbosity — Détermine la le degré des messages retournés par pg_last_error() et pg_result_error()

pg_trace — Active le suivi d'une connexion PostgreSQL

pg_transaction_status — Retourne le statut de la transaction en cours du serveur

pg_tty — Retourne le nom de TTY associé à la connexion

pg_unescape_bytea — Supprime le protection d'une chaîne de type bytea

pg_untrace — Termine le suivi d'une connexion PostgreSQL

pg_update — Modifie les lignes d'une table

pg_version — Retourne un tableau avec les versions du client, du protocole et du serveur (si disponible)