doc-fr/reference/mysqli/ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 607ec1f63c524e6951e7d3480377973788d495c5 Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<section xml:id="mysqli.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table xml:id="mysqli.configuration.options">
   <title>&ConfigureOptions; MySQLi</title>
   <tgroup cols="4">
    <thead>
     <row>
      <entry>&Name;</entry>
      <entry>&Default;</entry>
      <entry>&Changeable;</entry>
      <entry>&Changelog;</entry>
     </row>
    </thead>
    <tbody xml:id="mysqli.configuration.list">
     <row>
      <entry><link linkend="ini.mysqli.allow-local-infile">mysqli.allow_local_infile</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry>Antérieur à PHP 7.2.16 et 7.3.3 la valeur par défaut était "1".</entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.local-infile-directory">mysqli.local_infile_directory</link></entry>
      <entry></entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry>Disponible à partir de PHP 8.1.0.</entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.allow-persistent">mysqli.allow_persistent</link></entry>
      <entry>"1"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.max-persistent">mysqli.max_persistent</link></entry>
      <entry>"-1"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.max-links">mysqli.max_links</link></entry>
      <entry>"-1"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.default-port">mysqli.default_port</link></entry>
      <entry>"3306"</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.default-socket">mysqli.default_socket</link></entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.default-host">mysqli.default_host</link></entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.default-user">mysqli.default_user</link></entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.default-pw">mysqli.default_pw</link></entry>
      <entry>NULL</entry>
      <entry>PHP_INI_ALL</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.reconnect">mysqli.reconnect</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry></entry>
     </row>
     <row>
      <entry><link linkend="ini.mysqli.rollback-on-cached-plink">mysqli.rollback_on_cached_plink</link></entry>
      <entry>"0"</entry>
      <entry>PHP_INI_SYSTEM</entry>
      <entry></entry>
     </row>
    </tbody>
   </tgroup>
  </table>
  &ini.php.constants;
 </para>
 <para>
  Pour plus de détails et de définitions concernant les constantes PHP_INI_*
  ci-dessus, reportez-vous au chapitre sur les <link linkend="configuration.changes">
  modifications de configuration</link>.
 </para>
 
 &ini.descriptions.title;
 
 <para>
  <variablelist>
   
   <varlistentry xml:id="ini.mysqli.allow-local-infile">
    <term>
     <parameter>mysqli.allow_local_infile</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Autorise l'accès, depuis PHP, aux fichiers locaux chargés avec
      LOAD DATA
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.mysqli.local-infile-directory">
    <term>
     <parameter>mysqli.local_infile_directory</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Autorise un chargement restreint LOCAL DATA vers des fichiers se trouvant
      dans le dossier désigné.
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.mysqli.allow-persistent">
    <term>
     <parameter>mysqli.allow_persistent</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Active la possibilité de créer des connexions persistantes en
      utilisant la fonction <function>mysqli_connect</function>.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mysqli.max-persistent">
    <term>
     <parameter>mysqli.max_persistent</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Nombre maximal de connexions persistantes pouvant être réalisé.
      Définir à 0 pour "illimité".
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mysqli.max-links">
    <term>
     <parameter>mysqli.max_links</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Le nombre maximal de connexions MySQL par processus, incluant les
      connexions persistantes.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mysqli.default-port">
    <term>
     <parameter>mysqli.default_port</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Le numéro par défaut de port TCP à utiliser lors de la connexion
      au serveur si aucun autre port n'est fourni. S'il n'est pas défini,
      le port sera obtenu à partir de la variable d'environnement  
      <literal>MYSQL_TCP_PORT</literal>, l'entrée <literal>mysql-tcp</literal>
      dans <filename>/etc/services</filename> ou la constante de compilation
      <literal>MYSQL_PORT</literal>, dans cet ordre. Win32 n'utilisera que la 
      constante <literal>MYSQL_PORT</literal>.
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.mysqli.default-socket">
    <term>
     <parameter>mysqli.default_socket</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Le nom par défaut du socket à utiliser lors des connexions locales
      au serveur si aucun autre nom n'est fourni.
     </para>
    </listitem>
   </varlistentry>
   <varlistentry xml:id="ini.mysqli.default-host">
    <term>
     <parameter>mysqli.default_host</parameter>
     <type>string</type>
    </term>
   <listitem>
    <para>
     Le serveur par défaut à utiliser lors de la connexion à un
     serveur si aucun autre hôte n'est fourni.
    </para>
   </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.mysqli.default-user">
    <term>
     <parameter>mysqli.default_user</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Le nom d'utilisateur par défaut à utiliser lors de la connexion
      à un serveur si aucun autre nom n'est fourni.
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.mysqli.default-pw">
    <term>
     <parameter>mysqli.default_pw</parameter>
     <type>string</type>
    </term>
    <listitem>
     <para>
      Le mot de passe par défaut à utiliser lors de la connexion 
      à un serveur si aucun autre mot de passe n'est fourni.
     </para>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.mysqli.reconnect">
    <term>
     <parameter>mysqli.reconnect</parameter>
     <type>int</type>
    </term>
    <listitem>
     <para>
      Reconnexion automatique si la connexion est interrompue.
     </para>
     <note>
      <simpara>Cette directive &php.ini; est ignoré par le pilote mysqlnd.</simpara>
     </note>
    </listitem>
   </varlistentry>
   
   <varlistentry xml:id="ini.mysqli.rollback-on-cached-plink">
    <term>
     <parameter>mysqli.rollback_on_cached_plink</parameter>
     <type>bool</type>
    </term>
    <listitem>
     <para>
      Si cette option est activée, la fermeture d'une connexion permanente annule 
      toutes les transactions en attente de cette connexion avant d'être replacée 
      dans le pool de connexions persistantes. Sinon, les transactions en attente 
      seront restaurées uniquement lorsque la connexion est réutilisée ou 
      lorsqu'elle est réellement fermée.
     </para>
    </listitem>
   </varlistentry>
   
  </variablelist>
 </para>
 <para>
  Les utilisateurs ne peuvent changer <literal>MYSQL_OPT_READ_TIMEOUT</literal> via un appel
  de l'API ou au runtime.
  Notez que même si c'est possible, il y aura des différences sur la manière dont
  <literal>libmysqlclient</literal> et les flux vont interpréter la valeur de
  <literal>MYSQL_OPT_READ_TIMEOUT</literal>. 
 </para>
</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
-->