<?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

-->