doc-fr/reference/mysql/configure.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 40667918dcff1d5c9f7ecdc88b5caca24ba0686c Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->

<section xml:id="mysql.installation" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 &reftitle.install;

 <warning>
  &mysql.alternative.note;
 </warning>
 
 <para xml:id="mysql.configure">
  Pour compiler, utilisez tout simplement l'option de configuration
  <option role="configure">--with-mysql[=DIR]</option>
  où le paramètre optionnel <literal>[DIR]</literal> pointe vers
  le dossier d'installation de MySQL.
 </para>
 <para>
  Bien que cette extension MySQL soit compatible avec MySQL 4.1.0 et supérieur,
  elle ne supporte pas les fonctionnalités supplémentaires que cette version fournit.
  Pour cela, utilisez plutôt l'extension <link linkend="book.mysqli">MySQLi</link>.
 </para>
 <para>
  Si vous voulez installer l'extension mysqli en même temps que l'extension
  mysql, vous devez utiliser la même bibliothèque client afin d'éviter les
  conflits.
 </para>

 <section xml:id="mysql.installation.linux">
  <title>Installation sur les systèmes Linux</title>
  <para>
   Note : <literal>[DIR]</literal> est le chemin vers la bibliothèque cliente
   MySQL (<emphasis>en-têtes et bibliothèques</emphasis>), qui peut être
   téléchargée depuis le site de <link xlink:href="&url.mysql;">MySQL</link>.
  </para>
  <table xml:id="mysql.installation.compile.support">
   <title>Matrice du support de ext/mysql</title>
   <tgroup cols="5">
    <thead>
     <row>
      <entry>PHP &Version;</entry>
      <entry>&Default;</entry>
      <entry>&ConfigureOptions; : <link linkend="mysqlnd.overview">mysqlnd</link></entry>
      <entry>&ConfigureOptions; : <literal>libmysqlclient</literal></entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody>
     <row>
      <entry>4.x.x</entry>
      <entry>libmysqlclient</entry>
      <entry>&NotAvailable;</entry>
      <entry><option role="configure">--without-mysql</option> pour désactiver</entry>
      <entry>MySQL est actif par défaut, les bibliothèques clientes MySQL sont incluses en interne</entry>
     </row>
     <row>
      <entry>5.0.x, 5.1.x, 5.2.x</entry>
      <entry>libmysqlclient</entry>
      <entry>&NotAvailable;</entry>
      <entry><option role="configure">--with-mysql=[DIR]</option></entry>
      <entry>
       MySQL n'est pas actif par défaut, et les bibliothèques clientes MySQL
       ne sont plus incluses en interne
      </entry>
     </row>
     <row>
      <entry>5.3.x</entry>
      <entry>libmysqlclient</entry>
      <entry><option role="configure">--with-mysql=mysqlnd</option></entry>
      <entry><option role="configure">--with-mysql=[DIR]</option></entry>
      <entry>mysqlnd est maintenant disponible</entry>
     </row>
     <row>
      <entry>5.4.x</entry>
      <entry>mysqlnd</entry>
      <entry><option role="configure">--with-mysql</option></entry>
      <entry><option role="configure">--with-mysql=[DIR]</option></entry>
      <entry>mysqlnd est maintenant incluse par défaut</entry>
     </row>
    </tbody>
   </tgroup>
  </table>
 </section>

 <section xml:id="mysql.installation.windows">
  <title>Installation sur les systèmes Windows</title>
  <section xml:id="mysql.installation.windows.php52">
   <title>PHP 5.0.x, 5.1.x, 5.2.x</title>
   <para>
    MySQL n'est plus activé par défaut, ainsi, la bibliothèque
    <filename>php_mysql.dll</filename> doit être activée dans le &php.ini;.
    De plus, PHP doit avoir accès à la bibliothèque cliente MySQL.
    Un fichier nommé <filename>libmysql.dll</filename> est inclus dans
    la distribution de PHP pour Windows et pour que PHP puisse discuter
    avec MySQL, ce fichier doit être disponible dans le <envar>PATH</envar>
    du système Windows. Lisez la FAQ intitulée 
    "<link linkend="faq.installation.addtopath">Où dois-je ajouter mon répertoire PHP à la variable
    <envar>PATH</envar> sous Windows ?</link>" pour plus d'informations sur 
    la réalisation de cela. Néanmoins, le fait de copier le fichier 
    <filename>libmysql.dll</filename> dans le répertoire système de Windows fonctionne
    (car le dossier système est par défaut dans le <envar>PATH</envar> système), 
    mais cela n'est pas du tout recommandé.
   </para>
   <para>
    Pour activer n'importe quelle extension PHP (comme
    <filename>php_mysql.dll</filename>), la directive PHP
    <link linkend="ini.extension-dir">extension_dir</link> doit être définie
    et doit pointer vers le dossier où sont stockées les extensions PHP.
    Lisez également le
    <link linkend="install.windows.manual">manuel d'installation sous Windows</link>. 
    Par exemple, voici une valeur possible pour la directive
    extension_dir en PHP 5 :
    <literal>c:\php\ext</literal>
   </para>
   <note>
    <para>
     Si lorsque vous démarrez le serveur web une erreur similaire à ceci apparaît :
     <literal>"Unable to load dynamic library './php_mysql.dll'"</literal>, 
     c'est parce que <filename>php_mysql.dll</filename> et/ou
     <filename>libmysql.dll</filename> n'ont pû être trouvés par le système.
    </para>
   </note>
  </section>
  <section xml:id="mysql.installation.windows.php53">
   <title>PHP 5.3.0+</title>
   <para>
    Le <link linkend="mysqlnd.overview">driver MySQL natif</link> est activé par défaut.
    Incluez <filename>php_mysql.dll</filename>, mais <filename>libmysql.dll</filename>
    n'est plus nécessaire, ni utilisé.
   </para>
  </section>
 </section>

 <section xml:id="mysql.installation.notes">
  <title>Notes sur l'installation de MySQL</title>
  <warning>
   <para>
    Des crashes et des problèmes de démarrage de PHP peuvent
    être rencontrés lorsque vous chargez cette fonction en même temps que
    l'extension recode. Voyez l'extension <link linkend="ref.recode">recode</link> 
    pour plus de détails.
   </para>
  </warning>
  <note>
   <para>
    Si vous avez besoin d'autres jeux de caractères que celui par
    défaut (<emphasis>latin</emphasis>), vous devez installer la
    bibliothèque externe libmysqlclient (non fournie), compilée avec ce
    jeu de caractères.
   </para>
  </note>
 </section>
</section>

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