doc-fr/reference/com/ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 554db5a3a3ac77910d68349eefa37e2c9a9da628 Maintainer: yannick Status: ready -->
<!-- Reviewed: no -->
<section xml:id="com.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
 <table>
  <title>&ConfigureOptions; pour COM</title>
  <tgroup cols="4">
   <thead>
    <row>
     <entry>&Name;</entry>
     <entry>&Default;</entry>
     <entry>&Changeable;</entry>
     <entry>&Changelog;</entry>
    </row>
   </thead>
   <tbody xml:id="com.configuration.list">
    <row>
     <entry><link linkend="ini.com.allow-dcom">com.allow_dcom</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_SYSTEM</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.com.autoregister-typelib">com.autoregister_typelib</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.com.autoregister-verbose">com.autoregister_verbose</link></entry>
     <entry>"0"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.com.autoregister-casesensitive">com.autoregister_casesensitive</link></entry>
     <entry>"1"</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.com.code-page">com.code_page</link></entry>
     <entry>""</entry>
     <entry><constant>INI_ALL</constant></entry>
     <entry></entry>
    </row>
    <row>
     <entry><link linkend="ini.com.dotnet-version">com.dotnet_version</link></entry>
     <entry>""</entry>
     <entry><constant>INI_SYSTEM</constant></entry>
     <entry>À partir de PHP 8.0.0</entry>
    </row>
    <row>
     <entry><link linkend="ini.com.typelib-file">com.typelib_file</link></entry>
     <entry>""</entry>
     <entry><constant>INI_SYSTEM</constant></entry>
     <entry></entry>
    </row>
   </tbody>
  </tgroup>
 </table>
 &ini.php.constants;
 </para>

 &ini.descriptions.title;

 <para>
  <variablelist>
   <varlistentry xml:id="ini.com.allow-dcom">
    <term>
     <parameter>com.allow_dcom</parameter>
    </term>
    <listitem>
    <para>
     Si cette directive est activée, PHP aura la permission d'opérer comme
     un client D-COM (Distributed COM) et permettra à PHP d'instancier des
     objets COM sur un serveur distant.
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.autoregister-typelib">
    <term>
     <parameter>com.autoregister_typelib</parameter>
    </term>
    <listitem>
    <para>
     Si cette directive est activée, PHP essayera de déclarer des constantes
     provenant de la bibliothèque typelibrary des objets <classname>COM</classname> qu'il instancie, si ces 
     objets implémentent l'interface demandée pour obtenir les données demandées.
     La sensibilité des constantes à la casse est contrôlée par la directive
     de configuration &php.ini; <link linkend="ini.com.autoregister-casesensitive">com.autoregister_casesensitive</link>.
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.autoregister-verbose">
    <term>
     <parameter>com.autoregister_verbose</parameter>
    </term>
    <listitem>
    <para>
     Quand cette directive est activée, tout problème rencontré lors 
     du chargement d'une typelibrary durant l'instanciation de l'objet
     sera reporté en utilisant le mécanisme d'erreurs de PHP. Par
     défaut, elle est désactivée, ce qui ne donne aucune indication sur
     l'échec de l'opération lors d'une recherche ou d'un chargement de
     la bibliothèque de type.
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.autoregister-casesensitive">
    <term>
     <parameter>com.autoregister_casesensitive</parameter>
    </term>
    <listitem>
    <para>
     Cette directive est activée par défaut et fait que les constantes
     trouvées dans les bibliothèques de types autochargé lors de l'instanciation d'objets <classname>COM</classname> seront enregistrées en mode 
     sensible à la casse. Voyez <function>com_load_typelib</function> 
     pour plus de détails.
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.code-page">
    <term>
     <parameter>com.code_page</parameter>
    </term>
    <listitem>
    <para>
     Cette directive permet de spécifier le code-page des jeux de caractères à
     utiliser lors de l'envoi et la réception de chaînes vers des objets COM.
     Si elle est vide, PHP pensera que vous voulez <constant>CP_ACP</constant>,
     qui est le code-page système ANSI par défaut.
    </para>
    <para>
     Si le texte dans vos scripts est encodé avec un différent encodage ou jeu
     de caractères par défaut, configurer cette directive vous évitera d'avoir
     à passer tout votre code comme paramètre du constructeur de la classe <xref
     linkend="class.com"/>. Notez qu'en utilisant cette directive (comme toute
     configuration de PHP), votre code PHP perd en portabilité. Vous devez
     utiliser le paramètre du constructeur à chaque fois que possible.
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.dotnet-version">
    <term>
     <parameter>com.dotnet_version</parameter>
    </term>
    <listitem>
    <para>
     La version du framework .NET framework à utiliser pour les objets
     <classname>dotnet</classname>. La valeur de cette configuration
     correspond aux trois premiers numéros du numéro de la version du framework,
     séparé par des poins, et préxié par la lettre <literal>v</literal>, i.e.
     <literal>v4.0.30319</literal>.
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.typelib-file">
    <term>
     <parameter>com.typelib_file</parameter>
    </term>
    <listitem>
    <para>
     Lorsqu'elle est configurée, cette directive doit être le chemin vers un
     fichier qui contient une liste de bibliothèques à charger au démarrage.
     Chaque ligne sera interprétée comme le nom de la bibliothèque de types et
     chargée comme si vous aviez utilisé <function>com_load_typelib</function>.
     Les constantes seront enregistrées de façon persistante, pour que la bibliothèque
     ne soit chargée qu'une seule fois. Si le nom d'une bibliothèque de types
     se termine par <literal>#cis</literal> ou <literal>#case_insensitive</literal>,
     alors les constantes de cette bibliothèque de types seront enregistrées en mode
     insensible à la casse.
    </para>
    </listitem>
   </varlistentry>
  </variablelist>
 </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
-->