Files
doc-fr/reference/mysqli/configure.xml
George Peter Banyard c9b617b55a Apply commit 40667918dcff1d5c9f7ecdc88b5caca24ba0686c
Added table ids as needed by the docs at mysql.com
2021-02-02 02:03:11 +00:00

201 lines
7.3 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 40667918dcff1d5c9f7ecdc88b5caca24ba0686c Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<section xml:id="mysqli.installation" xmlns="http://docbook.org/ns/docbook"
xmlns:xlink="http://www.w3.org/1999/xlink">
&reftitle.install;
<para>
L'extension <literal>mysqli</literal> a été introduite dans PHP 5.0.0.
Le pilote natif MySQL (MySQL Native Driver) a été introduit dans PHP 5.3.0.
</para>
<section xml:id="mysqli.installation.linux">
<title>Installation sur Linux</title>
<para>
Les distributions Linux incluent des versions binaires de PHP qui peuvent
être installées. Même si ces binaires sont construits avec les extensions
MySQL, les bibliothèques clientes doivent souvent être installées au
moyen d'un paquet additionnel. Voyez si c'est le cas pour votre distribution.
</para>
<para>
Par exemple, sur Ubuntu le package <literal>php5-mysql</literal> installe les
extensions PHP ext/mysql, ext/mysqli, et pdo_mysqls. Sur CentOS, le package
<literal>php-mysql</literal> installe aussi ces trois extensions PHP.
</para>
<para>
Alternativement, vous pouvez compiler cette extension vous-même. Construire
PHP depuis les sources permet de préciser les extensions MySQL à embarquer,
mais aussi les bibliothèques clientes de chaque extension.
</para>
<para>
Le driver natif MySQL est la bibliothèque client recommandé, vu qu'il apporte
un gain de performance et donne l'accès à des fonctionnalités
qui ne sont pas disponibles lors de l'utilisation de la bibliothèque
cliente MySQL. Reportez-vous à la section
<link linkend="mysqli.overview.mysqlnd">Qu'est-ce que le driver
natif MySQL de PHP ?</link> pour une brève description des avantages
du driver natif MySQL.
</para>
<para>
<literal>/path/to/mysql_config</literal> représente le chemin du programme
<literal>mysql_config</literal> fourni avec MySQL serveur.
</para>
<table xml:id="mysqli.installation.time.matrix">
<title>Matrice de support pour la compilation mysqli</title>
<tgroup cols="5">
<thead>
<row>
<entry>&Version; PHP</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>5.4.x et ultérieur</entry>
<entry>mysqlnd</entry>
<entry><option role="configure">--with-mysqli</option></entry>
<entry><option role="configure">--with-mysqli=/path/to/mysql_config</option></entry>
<entry>mysqlnd par défaut</entry>
</row>
<row>
<entry>5.3.x</entry>
<entry>libmysqlclient</entry>
<entry><option role="configure">--with-mysqli=mysqlnd</option></entry>
<entry><option role="configure">--with-mysqli=/path/to/mysql_config</option></entry>
<entry>mysqlnd est supporté</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-mysqli=/path/to/mysql_config</option></entry>
<entry>mysqlnd n'est pas supporté</entry>
</row>
</tbody>
</tgroup>
</table>
<para>
Il est à noter qu'il est possible de mélanger les extensions MySQL ainsi que les
bibliothèques clientes. Par exemple, il est possible d'activer l'extension
MySQL pour utiliser la bibliothèque cliente MySQL (libmysqlclient) tout en configurant
l'extension <literal>mysqli</literal> pour utiliser le driver natif MySQL.
Toutes les combinaisons d'extensions et bibliothèques clientes sont possibles.
</para>
</section>
<section xml:id="mysqli.installation.windows">
<title>Installation sur les systèmes Windows</title>
<para>
Sur Windows, PHP est généralement installé avec un installeur binaire.
</para>
<section xml:id="mysqli.installation.windows.php53">
<title>PHP 5.3.0 et plus récent</title>
<para>
Sur Windows, pour les versions PHP 5.3 et supérieur, l'extension
<literal>mysqli</literal> est activée par défaut et utilise
MySQL Native Driver par défaut. Ceci signifie
que vous n'avez pas à vous inquiéter au sujet de
<filename>libmysql.dll</filename>.
</para>
</section>
<section xml:id="mysqli.installation.windows.php52">
<title>PHP 5.0, 5.1, 5.2</title>
<para>
Sur ces anciennes versions non supporté de PHP (PHP 5.2 a atteint sa fin de vie
le '6 janvier 2011'), des procédures de configuration supplémentaires sont
nécessaire pour activer <literal>mysqli</literal> et spécifier la bibliothèque
client que vous voulez utiliser.
</para>
<para>
L'extension <literal>mysqli</literal> n'est pas activée par défaut, donc la DLL
<filename>php_mysqli.dll</filename> doit être activée dans &php.ini;. Pour cela,
trouvez le fichier &php.ini; (souvent <filename>c:\php</filename>) et enlevez
le caractère de commentaire (;) devant la ligne
<literal>extension=php_mysqli.dll</literal> dans la section
<literal>[PHP_MYSQLI]</literal>.
</para>
<para>
Aussi, si vous voulez utiliser MySQL Client Library avec
<literal>mysqli</literal>, vous devez vérifier que PHP a accès à ce fichier.
La MySQL Client Library est incluse dans le fichier
<filename>libmysql.dll</filename> de la distribution Windows de PHP.
Ce fichier doit se trouver dans le <envar>PATH</envar> de Windows pour pouvoir
être chargé sans problème. Voyez la FAQ intitulée
"<link linkend="faq.installation.addtopath">Comment puis-je ajouter mon dossier PHP
au PATH de Windows</link>" pour plus d'informations. Copier le fichier
<filename>libmysql.dll</filename> dans le dossier système de Windows fonctionne aussi
(souvent <filename>c:\Windows\system</filename>) car ce dossier est par défaut présent
dans le <envar>PATH</envar> de Windows. Cependant, cette pratique est hautement
découragée.
</para>
<para>
Pour activer une extension PHP (telle que
<filename>php_mysqli.dll</filename>), la directive PHP
<link linkend="ini.extension-dir">extension_dir</link> doit pointer vers
le dossier contenant les extensions PHP. Voyez aussi
<link linkend="install.windows.manual">Installation manuelle sous Windows
</link>. Par exemple, <literal>extension_dir</literal> pourrait valoir
<filename>c:\php\ext</filename>.
</para>
<note>
<para>
Si lorsque vous démarrez le serveur web, une erreur telle que
<literal>"Unable to load dynamic library './php_mysqli.dll'"</literal> se
produit, c'est que <filename>php_mysqli.dll</filename> et/ou
<filename>libmysql.dll</filename> ne peut être trouvée sur le système.
</para>
</note>
</section>
</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
-->