(PHP 4 > 4.1.0, PHP 5, PHP 7, PHP 8)
com::__construct — com クラスのコンストラクタ
$module_name
,$server_name
= null
,$codepage
= CP_ACP
,$typelib
= ""新しい com オブジェクトを構築します。
module_name
Word.Application
ClassID は、与えられたクラスを一意に識別するUUIDです。
Moniker は、URL スキームの概念に似た特別な名前付けのやり方で、
リソースを識別し、どのようにロードするかを指定します。
たとえば、Microsoft Word をロードし、
Word ドキュメントを表現するオブジェクトを取得するために、
フルパスをモジュール名として指定できます。
また、LDAP への ADSI インターフェイスを使う moniker として
LDAP:
が使えます。
server_name
null
の場合、そのアプリケーションのデフォルトが使われ、実行されます。
デフォルトは通常はローカルマシン上で実行することですが、
管理者が異なるマシン上で起動するアプリケーションを設定するかもしれません。
server に null
でない値を指定すると、PHP は
com.allow_dcom
php.ini 設定オプションが true
でない限りオブジェクトのロードを拒否します。
server_name
が配列の場合、
次の要素が含まれるべきです(大文字小文字を区別します!)。
但し、これらは全てオプション(ユーザー名とパスワードは一緒に指定する必要があります)
であることに注意してください。つまり、サーバーの設定を省略すると、
(既に述べたとおり)デフォルトのサーバーが使われ、オブジェクトのインスタンス化は
com.allow_dcom
php.ini ディレクティブによって影響を受けません。
キー | タイプ | 説明 |
---|---|---|
Server | string | サーバー名 |
Username | string | 接続するユーザ名 |
Password | string | Username のパスワード |
Domain | string | server のドメイン |
Flags | integer | 以下の定数をひとつ以上、論理ORで指定します:
CLSCTX_INPROC_SERVER ,
CLSCTX_INPROC_HANDLER ,
CLSCTX_LOCAL_SERVER ,
CLSCTX_REMOTE_SERVER ,
CLSCTX_SERVER および
CLSCTX_ALL 。
指定されなかった場合のデフォルト値は
Server も省略した場合は、
CLSCTX_SERVER ですが、
server を指定した場合は CLSCTX_REMOTE_SERVER です。
これらの定数の意味の詳細情報は、
Microsoft の CoCreateInstance のドキュメントも参照ください。
通常、それらを使わないことはないはずです。
|
codepage
CP_ACP
(システムデフォルトの ANSI コードページを使う - このパラメータが省略された場合のデフォルト値),
CP_MACCP
,
CP_OEMCP
, CP_SYMBOL
,
CP_THREAD_ACP
(現在実行中のスレッドのコードページ/ロケールを使う),
CP_UTF7
および CP_UTF8
です。
コードページの数値も使えます。
コードページとその数値に関する詳細な情報は、Microsoft のドキュメントを参照ください。