pdo-mysql.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: b2a7a5fab7231fa8634096f111ae0fa0dc60bcfe Maintainer: Fan2Shrek Status: ready -->
<!-- Reviewed: yes -->
<reference xml:id="class.pdo-mysql" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
 <title>La classe Pdo\Mysql</title>
 <titleabbrev>Pdo\Mysql</titleabbrev>

 <partintro>

  <!-- {{{ ClassName intro -->
  <section xml:id="pdo-mysql.intro">
   &reftitle.intro;
   <simpara>
    Une sous-classe de <classname>PDO</classname> représentant une connexion
    utilisant le pilote MySQL PDO.
   </simpara>
   <para>
    Ce pilote supporte un analyseur de requêtes SQL dédié pour le dialecte MySQL.
    Il peut gérer les éléments suivants :
    <itemizedlist>
     <listitem>
      <simpara>
       Les littéraux à guillemets simples et doubles avec le doublement et le backslash comme mécanismes d'échappement
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Les littéraux à accent grave avec le doublement comme mécanisme d'échappement
      </simpara>
     </listitem>
     <listitem>
      <simpara>
       Deux tirets, les commentaires de style C et les commentaires de type hash
      </simpara>
     </listitem>
    </itemizedlist>
   </para>
  </section>
  <!-- }}} -->

  <section xml:id="pdo-mysql.synopsis">
   &reftitle.classsynopsis;

   <!-- {{{ Synopsis -->
   <classsynopsis class="class">
    <ooclass>
     <classname>Pdo\Mysql</classname>
    </ooclass>

    <ooclass>
     <modifier>extends</modifier>
     <classname>PDO</classname>
    </ooclass>

    <classsynopsisinfo role="comment">&InheritedConstants;</classsynopsisinfo>
    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:partintro/db:section/db:classsynopsis/db:fieldsynopsis[preceding-sibling::db:classsynopsisinfo[1][@role='comment' and text()='&Constants;']]))">
     <xi:fallback/>
    </xi:include>

    <classsynopsisinfo role="comment">&Constants;</classsynopsisinfo>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-use-buffered-query">Pdo\Mysql::ATTR_USE_BUFFERED_QUERY</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-local-infile">Pdo\Mysql::ATTR_LOCAL_INFILE</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-local-infile-directory">Pdo\Mysql::ATTR_LOCAL_INFILE_DIRECTORY</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-init-command">Pdo\Mysql::ATTR_INIT_COMMAND</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-max-buffer-size">Pdo\Mysql::ATTR_MAX_BUFFER_SIZE</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-read-default-file">Pdo\Mysql::ATTR_READ_DEFAULT_FILE</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-read-default-group">Pdo\Mysql::ATTR_READ_DEFAULT_GROUP</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-compress">Pdo\Mysql::ATTR_COMPRESS</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-direct-query">Pdo\Mysql::ATTR_DIRECT_QUERY</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-found-rows">Pdo\Mysql::ATTR_FOUND_ROWS</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-ignore-space">Pdo\Mysql::ATTR_IGNORE_SPACE</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-multi-statements">Pdo\Mysql::ATTR_MULTI_STATEMENTS</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-server-public-key">Pdo\Mysql::ATTR_SERVER_PUBLIC_KEY</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-ssl-key">Pdo\Mysql::ATTR_SSL_KEY</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-ssl-cert">Pdo\Mysql::ATTR_SSL_CERT</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-ssl-ca">Pdo\Mysql::ATTR_SSL_CA</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-ssl-capath">Pdo\Mysql::ATTR_SSL_CAPATH</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-ssl-cipher">Pdo\Mysql::ATTR_SSL_CIPHER</varname>
    </fieldsynopsis>
    <fieldsynopsis>
     <modifier>public</modifier>
     <modifier>const</modifier>
     <type>int</type>
     <varname linkend="pdo-mysql.constants.attr-ssl-verify-server-cert">Pdo\Mysql::ATTR_SSL_VERIFY_SERVER_CERT</varname>
    </fieldsynopsis>

    <classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>
    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo-mysql')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='Pdo\\Mysql'])">
     <xi:fallback/>
    </xi:include>

    <classsynopsisinfo role="comment">&InheritedMethods;</classsynopsisinfo>
    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[@role='PDO'])">
     <xi:fallback/>
    </xi:include>
    <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.pdo')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[@role='PDO'])">
     <xi:fallback/>
    </xi:include>
   </classsynopsis>
   <!-- }}} -->

  </section>

  <section xml:id="pdo-mysql.constants">
   &reftitle.constants;
   <variablelist>
    <varlistentry xml:id="pdo-mysql.constants.attr-use-buffered-query">
     <term><constant>Pdo\Mysql::ATTR_USE_BUFFERED_QUERY</constant></term>
     <listitem>
      <simpara>
       Par défaut, toutes les requêtes sont exécutées en
       <link linkend="mysqlinfo.concepts.buffering">mode tamponné</link>.
       Si cet attribut est défini à &false; sur un objet
       <classname>Pdo\Mysql</classname>,
       le pilote MySQL utilisera le mode non tamponné.
      </simpara>
      <example><title>Activation du mode non tamponné MySQL</title>
       <programlisting role="php">
<![CDATA[
<?php
$pdo = new Pdo\Mysql("mysql:host=localhost;dbname=world", 'my_user', 'my_password');
$pdo->setAttribute(PDO::MYSQL_ATTR_USE_BUFFERED_QUERY, false);

$unbufferedResult = $pdo->query("SELECT Name FROM City");
foreach ($unbufferedResult as $row) {
    echo $row['Name'] . PHP_EOL;
}
?>
]]>
       </programlisting>
      </example>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-local-infile">
     <term><constant>Pdo\Mysql::ATTR_LOCAL_INFILE</constant></term>
     <listitem>
      <simpara>
       Enable <literal>LOAD LOCAL INFILE</literal>.
      </simpara>
      <note>
       <simpara>
        Peut uniquement être utilisé dans le tableau <parameter>driver_options</parameter>
        lors de la construction d'une nouvelle connexion à la base de données.
       </simpara>
      </note>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-local-infile-directory">
     <term><constant>Pdo\Mysql::ATTR_LOCAL_INFILE_DIRECTORY</constant></term>
     <listitem>
      <simpara>
       Permet de restreindre le chargement de données locales aux fichiers situés
       dans ce répertoire désigné.
      </simpara>
      <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo-mysql.constants.attr-local-infile')//db:note/.)">
       <xi:fallback/>
      </xi:include>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-init-command">
     <term><constant>Pdo\Mysql::ATTR_INIT_COMMAND</constant></term>
     <listitem>
      <simpara>
       La commande à exécuter lors de la connexion au serveur MySQL.
       Sera automatiquement réexécutée lors de la reconnexion.
      </simpara>
      <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo-mysql.constants.attr-local-infile')//db:note/.)">
       <xi:fallback/>
      </xi:include>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-read-default-file">
     <term><constant>Pdo\Mysql::ATTR_READ_DEFAULT_FILE</constant></term>
     <listitem>
      <simpara>
       Lire les options du fichier d'options nommé au lieu de
       <filename>my.cnf</filename>.
      </simpara>
      <note>
       <simpara>
        Cette option n'est pas disponible si mysqlnd est utilisé,
        car mysqlnd ne lit pas les fichiers de configuration mysql.
       </simpara>
      </note>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-read-default-group">
     <term><constant>Pdo\Mysql::ATTR_READ_DEFAULT_GROUP</constant></term>
     <listitem>
      <simpara>
       Lit les options du groupe nommé du fichier <filename>my.cnf</filename> ou
       le fichier spécifié avec
       <constant>Pdo\Mysql::ATTR_READ_DEFAULT_FILE</constant>.
      </simpara>
      <note>
       <simpara>
        Cette option n'est pas disponible si mysqlnd est utilisé,
        car mysqlnd ne lit pas les fichiers de configuration mysql.
       </simpara>
      </note>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-compress">
     <term><constant>Pdo\Mysql::ATTR_COMPRESS</constant></term>
     <listitem>
      <simpara>
       Active la compression de la communication réseau.
      </simpara>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-direct-query">
     <term><constant>Pdo\Mysql::ATTR_DIRECT_QUERY</constant></term>
     <listitem>
      <simpara>
       &Alias; <constant>PDO::ATTR_EMULATE_PREPARES</constant>.
      </simpara>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-found-rows">
     <term><constant>Pdo\Mysql::ATTR_FOUND_ROWS</constant></term>
     <listitem>
      <simpara>
       Renvoie le nombre de lignes trouvées (correspondantes),
       pas le nombre de lignes modifiées.
      </simpara>
      <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo-mysql.constants.attr-local-infile')//db:note/.)">
       <xi:fallback/>
      </xi:include>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-ignore-space">
     <term><constant>Pdo\Mysql::ATTR_IGNORE_SPACE</constant></term>
     <listitem>
      <simpara>
       Permet les espaces après les noms de fonctions SQL.
       Rends tous les noms de fonctions SQL des mots réservés.
      </simpara>
      <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo-mysql.constants.attr-local-infile')//db:note/.)">
       <xi:fallback/>
      </xi:include>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-max-buffer-size">
     <term><constant>Pdo\Mysql::ATTR_MAX_BUFFER_SIZE</constant></term>
     <listitem>
      <simpara>
       La taille maximale du tampon. Par défaut, 1 Mo.
      </simpara>
      <note>
       <simpara>
        Cette constante n'est pas supportée lorsqu'elle est compilée sans mysqlnd.
       </simpara>
      </note>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-multi-statements">
     <term><constant>Pdo\Mysql::ATTR_MULTI_STATEMENTS</constant></term>
     <listitem>
      <simpara>
       Désactive l'exécution de requêtes multiples dans
       <methodname>PDO::prepare</methodname> et
       <methodname>PDO::query</methodname> lorsque définit à &false;.
      </simpara>
      <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo-mysql.constants.attr-local-infile')//db:note/.)">
       <xi:fallback/>
      </xi:include>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-server-public-key">
     <term><constant>Pdo\Mysql::ATTR_SERVER_PUBLIC_KEY</constant></term>
     <listitem>
      <simpara>
       <acronym>RSA</acronym> le chemin du fichier de clé publique utilisé avec l'authentification basée sur SHA-256.
      </simpara>
      <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo-mysql.constants.attr-local-infile')//db:note/.)">
       <xi:fallback/>
      </xi:include>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-ssl-key">
     <term><constant>Pdo\Mysql::ATTR_SSL_KEY</constant></term>
     <listitem>
      <simpara>
       Le chemin du fichier de clé <acronym>SSL</acronym>.
      </simpara>
      <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo-mysql.constants.attr-local-infile')//db:note/.)">
       <xi:fallback/>
      </xi:include>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-ssl-cert">
     <term><constant>Pdo\Mysql::ATTR_SSL_CERT</constant></term>
     <listitem>
      <simpara>
       Le chemin du certificat <acronym>SSL</acronym>.
      </simpara>
      <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo-mysql.constants.attr-local-infile')//db:note/.)">
       <xi:fallback/>
      </xi:include>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-ssl-ca">
     <term><constant>Pdo\Mysql::ATTR_SSL_CA</constant></term>
     <listitem>
      <simpara>
       Le chemin du certificat d'autorité <acronym>SSL</acronym>.
      </simpara>
      <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo-mysql.constants.attr-local-infile')//db:note/.)">
       <xi:fallback/>
      </xi:include>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-ssl-capath">
     <term><constant>Pdo\Mysql::ATTR_SSL_CAPATH</constant></term>
     <listitem>
      <simpara>
       Le chemin du répertoire qui contient les certificats d'autorité
       <acronym>SSL</acronym> <acronym>CA</acronym>,
       stockés au format <acronym>PEM</acronym>.
      </simpara>
      <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo-mysql.constants.attr-local-infile')//db:note/.)">
       <xi:fallback/>
      </xi:include>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-ssl-cipher">
     <term><constant>Pdo\Mysql::ATTR_SSL_CIPHER</constant></term>
     <listitem>
      <simpara>
       Une liste d'un ou plusieurs chiffrements autorisés à utiliser pour
       <acronym>SSL</acronym>, dans un format compris par OpenSSL.
       Par exemple : <literal>DHE-RSA-AES256-SHA:AES128-SHA</literal>
      </simpara>
      <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo-mysql.constants.attr-local-infile')//db:note/.)">
       <xi:fallback/>
      </xi:include>
     </listitem>
    </varlistentry>
    <varlistentry xml:id="pdo-mysql.constants.attr-ssl-verify-server-cert">
     <term><constant>Pdo\Mysql::ATTR_SSL_VERIFY_SERVER_CERT</constant></term>
     <listitem>
      <simpara>
       Apporte un moyen de désactiver la vérification du certificat du serveur <acronym>SSL</acronym>.
      </simpara>
      <note>
       <simpara>
        Cette option est disponible uniquement avec mysqlnd.
       </simpara>
      </note>
      <xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('pdo-mysql.constants.attr-local-infile')//db:note/.)">
       <xi:fallback/>
      </xi:include>
     </listitem>
    </varlistentry>
   </variablelist>
  </section>
 </partintro>

 &reference.pdo-mysql.pdo.entities.mysql;

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