<?xml version="1.0" encoding="utf-8"?>

<!-- $Revision$ -->

<!-- EN-Revision: 3c1bec9d700807df36994cf368ba291214cd424d Maintainer: yannick Status: ready -->

<!-- Reviewed: no -->

<reference xml:id="ref.pdo-pgsql" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

<?phpdoc extension-membership="bundledexternal" ?>

<title>Fonctions du pilote PDO PostgreSQL (PDO_PGSQL)</title>

<titleabbrev>Pilote PDO PostgreSQL</titleabbrev>

<partintro>

<section xml:id="ref.pdo-pgsql.intro">

&reftitle.intro;

<para>

PDO_PGSQL est un pilote qui implémente l'<link

linkend="intro.pdo">interface de PHP Data Objects (PDO)</link> pour

autoriser l'accès de PHP aux bases de données PostgreSQL.

</para>

</section>

<section xml:id="ref.pdo-pgsql.resources">

&reftitle.resources;

<para>

Cette extension définit une ressource de flux, retournée

par la fonction <function>PDO::pgsqlLOBOpen</function>.

</para>

</section>

&reference.pdo-pgsql.configure;

&reference.pdo-pgsql.constants;

<section xml:id="ref.pdo-pgsql.general-notes">

<title>Notes générales</title>

<note>

<para>

Les champs <literal>bytea</literal> sont retournés sous forme de flux.

</para>

</note>

</section>

</partintro>

<refentry xml:id="ref.pdo-pgsql.connection">

<refnamediv>

<refname>PDO_PGSQL DSN</refname>

<refpurpose>Connexion aux bases de données PostgreSQL</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<para>

Le Data Source Name (DSN) de PDO_PGSQL est composé des éléments suivants,

délimités par des espaces ou des points-virgules :

<variablelist>

<varlistentry>

<term>Préfixe DSN</term>

<listitem>

<para>

Le préfixe DSN est <userinput>pgsql:</userinput>.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>host</literal></term>

<listitem>

<para>

L'hôte sur lequel le serveur de base de données se situe.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>port</literal></term>

<listitem>

<para>

Le port sur lequel le serveur de base de données s'exécute.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>dbname</literal></term>

<listitem>

<para>

Le nom de la base de données.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>user</literal></term>

<listitem>

<para>

Le nom de l'utilisateur pour la connexion. Si l'on spécifie

l'utilisateur dans le DSN, PDO ignorera la valeur de l'utilisateur en

argument dans le constructeur PDO.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>password</literal></term>

<listitem>

<para>

Le mot de passe de l'utilisateur pour la connexion. Si l'on

spécifie le mot de passe dans le DSN, PDO ignorera la valeur du mot

de passe en argument dans le constructeur PDO.

</para>

</listitem>

</varlistentry>

<varlistentry>

<term><literal>sslmode</literal></term>

<listitem>

<para>

Le mode SSL. Les valeurs supportées et leur signification sont listées dans

la section <link xlink:href="&url.pgsql.manual;">Documentation PostgreSQL</link>.

</para>

</listitem>

</varlistentry>

</variablelist>

<note>

<simpara>

Tous les points-virgules dans la chaîne DSN sont remplacés par des espaces,

parce que PostgreSQL s'attend à ce format.

Cela implique que les points-virgules dans l'un des composants

(par exemple <literal>password</literal> ou <literal>dbname</literal>)

ne sont pas supportés.

</simpara>

</note>

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

<example>

<title>Exemples avec PDO_PGSQL DSN</title>

<para>

L'exemple suivant montre PDO_PGSQL DSN pour se connecter à une base

de données PostgreSQL :

<programlisting>

<![CDATA[

pgsql:host=localhost;port=5432;dbname=testdb;user=bruce;password=mypass

]]>

</programlisting>

</para>

</example>

</para>

</refsect1>

</refentry>

&reference.pdo-pgsql.entities.pdo-overloaded;

</reference>

<!-- Keep this comment at the end of the file

Local variables:

mode: sgml

sgml-omittag:t

sgml-shorttag:t

sgml-minimize-attributes:nil

sgml-always-quote-attributes:t

sgml-indent-step:1

sgml-indent-data:t

indent-tabs-mode:nil

sgml-parent-document:nil

sgml-default-dtd-file:"~/.phpdoc/manual.ced"

sgml-exposed-tags:nil

sgml-local-catalogs:nil

sgml-local-ecat-files:nil

End:

vim600: syn=xml fen fdm=syntax fdl=2 si

vim: et tw=78 syn=sgml

vi: ts=1 sw=1

-->