archived-doc-ru/reference/com/ini.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 554db5a3a3ac77910d68349eefa37e2c9a9da628 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<section xml:id="com.configuration" xmlns="http://docbook.org/ns/docbook">
 &reftitle.runtime;
 &extension.runtime;
 <para>
  <table>
   <title>Опции конфигурации 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>Начиная с 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>
      Если включено, PHP будет разрешено работать в качестве клиента D-COM
      (Распределённый COM), что позволит скрипту PHP инстанциировать объекты COM
      на удалённом сервере.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.autoregister-typelib">
    <term>
     <parameter>com.autoregister_typelib</parameter>
    </term>
    <listitem>
     <para>
      Если включено, PHP попробует зарегистрировать константы
      библиотеки типов создаваемых объектов <classname>COM</classname>,
      если эти объекты реализуют
      интерфейс, требуемый для получения данной информации.
      Регистрозависимость регистрируемых констант контролируется
      директивой конфигурации &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>
      Если включено, о любых проблемах с загрузкой библиотеки типов в процессе
      создания экземпляра объекта будет сообщено с помощью механизма ошибок PHP.
      По умолчанию выключено, что означает, что никаких сообщений об ошибках
      при загрузке библиотеки типов сообщаться не будет.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.autoregister-casesensitive">
    <term>
     <parameter>com.autoregister_casesensitive</parameter>
    </term>
    <listitem>
     <para>
      Если включено (по умолчанию), константы, обнаруженные при автозагрузке
      библиотек типов, при инстанцировании объектов <classname>COM</classname>,
      будут зарегистрированы как регистрозависимые.
      Более подробно смотрите в описании функции <function>com_load_typelib</function>.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.code-page">
    <term>
     <parameter>com.code_page</parameter>
    </term>
    <listitem>
     <para>
      Контролирует кодировку по умолчанию при передаче строк объектам COM.
      Если задана пустая строка, PHP будет считать, что вы хотите использовать
      <constant>CP_ACP</constant> - системная кодировка ANSI по умолчанию.
     </para>
     <para>
      Если текст в вашем скрипте содержится в кодировке отличной от
      кодировки по умолчанию, то установка этого параметра позволит вам не указывать
      кодировку каждый раз при создании объекта класса <xref
      linkend="class.com"/> в его конструкторе. Пожалуйста помните, что
      использование этой директивы (как и любой другой директивы конфигурации) делает
      ваш скрипт менее переносимым, так что всё же рекомендуется указывать кодировку
      при каждом создании объекта COM.
     </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.dotnet-version">
    <term>
     <parameter>com.dotnet_version</parameter>
    </term>
    <listitem>
    <para>
     Версия платформы .NET для использования с объектами <classname>dotnet</classname>.
     Значение параметра - это первые три части номера версии фреймворка,
     разделённые точками и с префиксом <literal>v</literal>, например <literal>v4.0.30319</literal>.
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.typelib-file">
    <term>
     <parameter>com.typelib_file</parameter>
    </term>
    <listitem>
     <para>
      Значение должно соответствовать пути в файловой системе до
      файла, содержащего список библиотек типов, которые необходимо
      загрузить при запуске. Каждая строка файла будет рассматриваться
      как имя библиотеки типов, которая будет загружена как только
      вы вызовите функцию <function>com_load_typelib</function>.
      Константы будут зарегистрированы на постоянной основе, так что
      библиотеки нужно загружать всего один раз. Если имя библиотеки
      типов заканчивается на строку <literal>#cis</literal> или
      <literal>#case_insensitive</literal>, то константы будут
      зарегистрированы как регистронезависимые.
     </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
-->