doc-fr/reference/pdo_sqlsrv/reference.xml

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

<reference xml:id="ref.pdo-sqlsrv" xmlns="http://docbook.org/ns/docbook">
 <?phpdoc extension-membership="pecl" ?>
 <title>Fonctions Microsoft SQL Server (PDO_SQLSRV)</title>
 <titleabbrev>MS SQL Server (PDO)</titleabbrev>
 <partintro>
  
  <section xml:id="pdo-sqlsrv.intro">
   &reftitle.intro;
   <para>
    PDO_SQLSRV est un pilote qui implémente l'<link linkend="intro.pdo">interface
    PDO (PHP Data Objects)</link> pour permettre l'accès depuis PHP aux bases de
    données MS SQL Server (version SQL Server 2005 et supérieures) et SQL Azure.
   </para>
  </section>
  &reference.pdo-sqlsrv.configure;
  &reference.pdo-sqlsrv.constants;
 </partintro>
 
 <refentry xml:id="ref.pdo-sqlsrv.connection">
  <refnamediv>
   <refname>PDO_SQLSRV DSN</refname>
   <refpurpose>Connexion à des bases de données MS SQL Server et SQL Azure</refpurpose>
  </refnamediv>
  
  <refsect1 role="description">
   &reftitle.description;
   <para>
    Le fichier DSN (Data Source Name) PDO_SQLSRV est composé des éléments suivants :
    <variablelist>
     <varlistentry>
      <term>préfixe DSN</term>
      <listitem>
       <para>
        Le préfixe DSN est <userinput>sqlsrv:</userinput>.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>APP</literal></term>
      <listitem>
       <para>
        Le nom de l'application, utilisé pour les traces.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>ConnectionPooling</literal></term>
      <listitem>
       <para>
        Spécifie si la connexion est assignée à un pool de connexions 
        (1 ou &true;) ou non (0 ou &false;).
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>Database</literal></term>
      <listitem>
       <para>
        The name of the database.Le nom de la base de données.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>Encrypt</literal></term>
      <listitem>
       <para>
        Spécifie si la communication avec le server SQL Server est encryptée
        (1 ou &true;) ou non-encryptée (0 ou &false;).
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>Failover_Partner</literal></term>
      <listitem>
       <para>
        Sépcifie le serveur et l'instance de la base de données miroir (si elle
        est activée et configurée) à utiliser quand le serveur principal est 
        inaccessible.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>LoginTimeout</literal></term>
      <listitem>
       <para>
        Spécifie le nombre de secondes d'attente avant de stopper et mettre en
        erreur la tentative de connexion.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>MultipleActiveResultSets</literal></term>
      <listitem>
       <para>
        Désactive, ou active explictement, le support pour des jeux de résultats
        multiples (Multiple Active Result Sets, MARS).
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>QuotedId</literal></term>
      <listitem>
       <para>
        Spécifie s'il faut utiliser les règles SQL-92 pour les identifiants entre guillemets
        (1 ou &true;) ou s'il faut utiliser les règles Transact-SQL standard (0 ou &false;).
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>Server</literal></term>
      <listitem>
       <para>
        Le nom du serveur de base de données.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>TraceFile</literal></term>
      <listitem>
       <para>
        Le chemin du fichier utilisé pour les traces.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>TraceOn</literal></term>
      <listitem>
       <para>
        Spécifie si les traces ODBC sont activées (1 ou &true;) ou désactivées
        (0 ou &false;) à l'activation de la connexion.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>TransactionIsolation</literal></term>
      <listitem>
       <para>
        Spécifie le niveau d'icolation de la transaction. les valeurs possibles
        pour cette option sont
        PDO::SQLSRV_TXN_READ_UNCOMMITTED, PDO::SQLSRV_TXN_READ_COMMITTED, 
        PDO::SQLSRV_TXN_REPEATABLE_READ, PDO::SQLSRV_TXN_SNAPSHOT, et 
        PDO::SQLSRV_TXN_SERIALIZABLE.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>TrustServerCertificate</literal></term>
      <listitem>
       <para>
        Spécifie si le client doit faire confiance (1 ou &true;) ou rejeter
        (0 ou &false;) un certificat serveur autosigné.
       </para>
      </listitem>
     </varlistentry>
     <varlistentry>
      <term><literal>WSID</literal></term>
      <listitem>
       <para>
        Spécifie le nom de l'ordinateur pour les traces.
       </para>
      </listitem>
     </varlistentry>
    </variablelist>
   </para>
  </refsect1>
  
  <refsect1 role="examples">
   &reftitle.examples;
   <para>
    <example>
     <title>Exemples de DSN PDO_SQLSRV</title>
     <para>
      L'exemple suivant montre comment se connecter à la base de données MS SQL Server spécifiée :
      <programlisting>
<![CDATA[
$c = new PDO("sqlsrv:Server=localhost;Database=bddtest", "Utilisateur", "MotDePasse");
]]>
      </programlisting>
     </para>
     <para>
      L'exemple suivant montre comment se connecter à la base de données MS SQL Server spécifiée 
      sur un port spécifique :
      <programlisting>
<![CDATA[
$c = new PDO("sqlsrv:Server=localhost,1521;Database=bddtest", "Utilisateur", "MotDePasse");
]]>
      </programlisting>
     </para>
     <para>
      L'exemple suivant montre comment se connecter à une base de données SQL Azure avec 
      l'ID serveur 12345abcde. Notez que, quand vous vous connectez à Azure avec PDO, 
      votre nom d'utilisateur sera Utilisateur@12345abcde (Utilisateur@IdServeur).
      <programlisting>
<![CDATA[
$c = new PDO("sqlsrv:Server=12345abcde.database.windows.net;Database=bddtest", "Utilisateur@12345abcde", "MotDePasse");
]]>
      </programlisting>
     </para>
    </example>
   </para>
  </refsect1>
 </refentry>
 
</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
-->