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

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 554db5a3a3ac77910d68349eefa37e2c9a9da628 Maintainer: hirokawa Status: ready -->
<!-- CREDITS: takagi,mumumu -->
<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>
     これを on にすると、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>
     これを on にすると、
     生成した <classname>COM</classname>オブジェクトのタイプライブラリから取得した
     定数を PHP に登録しようと試みます。ただし、それはオブジェクトが
     当該情報を取得するためのインターフェイスを提供している場合のみです。
     登録する定数の大文字小文字を区別するかどうかについては、
     <link linkend="ini.com.autoregister-casesensitive">com.autoregister_casesensitive</link> &php.ini; 設定ディレクティブで制御します。
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.autoregister-verbose">
    <term>
     <parameter>com.autoregister_verbose</parameter>
    </term>
    <listitem>
    <para>
     これを on にすると、オブジェクト生成時のタイプライブラリの読み込み中に
     発生したすべての問題が PHP のエラー機構を用いて報告されます。
     デフォルトは off で、この場合はタイプライブラリの検索や読み込みの際の
     エラーは一切報告されません。
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.autoregister-casesensitive">
    <term>
     <parameter>com.autoregister_casesensitive</parameter>
    </term>
    <listitem>
    <para>
     これを on にすると (デフォルト)、
     <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"/> クラスのコンストラクタのパラメータとして
     コードページを指定する必要がなくなります。
     (他の PHP 設定ディレクティブとともに) このディレクティブを使用すると、
     PHP スクリプトの移植可能性が悪くなることに注意しましょう。
     できる限り、COM のコンストラクタにパラメータを指定する方式をとるべきです。
    </para>
    </listitem>
   </varlistentry>

   <varlistentry xml:id="ini.com.dotnet-version">
    <term>
     <parameter>com.dotnet_version</parameter>
    </term>
    <listitem>
    <para>
     <classname>dotnet</classname> オブジェクトが使う、.NET framework のバージョン。
     この値は、framework のバージョン番号のうち、ドットで区切られた最初の3つの部分で、
     <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
-->