(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
。 Class ID 是唯一識別特定類別的 UUID。 Moniker 是一種特殊的命名形式,概念類似於 URL 結構,用於識別資源並指定其載入方式。例如,您可以載入 Word 並取得代表 Word 文件的物件,方法是將完整的文件路徑指定為模組名稱,或者您可以使用 LDAP:
作為 Moniker 來使用 ADSI 介面連接 LDAP。server_name
null
,則物件會使用應用程式的預設值執行。預設值通常是在本機電腦上執行,但系統管理員可能已將應用程式設定為在不同的電腦上啟動。 如果為 server 指定了非 null
的值,除非 php.ini 中的 com.allow_dcom 選項設定為 true
,否則 PHP 將拒絕載入物件。如果 server_name
是一個陣列,它應該包含以下元素(區分大小寫!)。請注意,它們都是可選的(儘管您需要同時指定使用者名稱和密碼);如果您省略 Server 設定,將使用預設伺服器(如上所述),且物件的實例化不會受到 com.allow_dcom php.ini 指令的影響。
鍵值 | 類型 | 說明 |
---|---|---|
Server | 字串 | 伺服器名稱。 |
Username | 字串 | 連線的使用者名稱。 |
Password | 字串 | Username 的密碼。 |
Domain | 字串 | server 的網域。 |
Flags | 整數 | 下列一個或多個常數,以邏輯 OR 運算結合:CLSCTX_INPROC_SERVER 、CLSCTX_INPROC_HANDLER 、CLSCTX_LOCAL_SERVER 、CLSCTX_REMOTE_SERVER 、CLSCTX_SERVER 和 CLSCTX_ALL 。如果這裡未指定,預設值為 CLSCTX_SERVER (如果您也省略了 `Server` 參數),或者如果您指定了伺服器,則為 CLSCTX_REMOTE_SERVER 。您應該查閱 Microsoft 的 CoCreateInstance 文件以了解更多關於這些常數的含義;通常您永遠不需要使用它們。 |
字碼頁
CP_ACP
(使用系統預設的 ANSI 字碼頁 - 如果省略此參數則為預設值)、CP_MACCP
、CP_OEMCP
、CP_SYMBOL
、CP_THREAD_ACP
(使用為目前執行緒設定的字碼頁/地區設定)、CP_UTF7
和 CP_UTF8
。您也可以使用給定字碼頁的數字;有關字碼頁及其數值的更多詳細資訊,請查閱 Microsoft 文件。