doc-fr/reference/pdo_pgsql/reference.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: ce612fcdfb5bebeaa7ebe7a0907a990d55e339d2 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 PostgreSQL (PDO_PGSQL)</title>
  <titleabbrev>PostgreSQL (PDO)</titleabbrev>
  <partintro>

   <section xml:id="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="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="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>
         L'hôte sur lequel le serveur de base de données se situe.
        </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 vous spécifiez
         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 vous
         spécifiez 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 prises en charge 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;

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