archived-doc-fr/reference/pdo_pgsql/reference.xml

<?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
-->