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

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 14af302c9c0e561fa6f9cdd956268758ba9a89c5 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->

 <reference xml:id="ref.pdo-pgsql" xmlns="http://docbook.org/ns/docbook">
  <?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;

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

     </variablelist>
    </para>
    <note>
     <para>
      Les champs <literal>bytea</literal> sont retournés sous forme de flux.
     </para>
    </note>
   </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
-->