2024 日本 PHP 研討會

com::__construct

(PHP 4 > 4.1.0, PHP 5, PHP 7, PHP 8)

com::__constructcom 類別建構子

說明

public com::__construct(
    字串 $module_name,
    陣列|字串|null $server_name = null,
    整數 $codepage = CP_ACP,
    字串 $typelib = ""
)

建構一個新的 COM 物件。

參數

module_name
可以是 ProgID、Class ID 或 Moniker,用於命名要載入的元件。 ProgID 通常是應用程式或 DLL 名稱,後接一個句點,再接物件名稱。例如:Word.Application Class ID 是唯一識別特定類別的 UUID。 Moniker 是一種特殊的命名形式,概念類似於 URL 結構,用於識別資源並指定其載入方式。例如,您可以載入 Word 並取得代表 Word 文件的物件,方法是將完整的文件路徑指定為模組名稱,或者您可以使用 LDAP: 作為 Moniker 來使用 ADSI 介面連接 LDAP。
server_name
要載入和執行元件的 DCOM 伺服器名稱。如果為 null,則物件會使用應用程式的預設值執行。預設值通常是在本機電腦上執行,但系統管理員可能已將應用程式設定為在不同的電腦上啟動。 如果為 server 指定了非 null 的值,除非 php.ini 中的 com.allow_dcom 選項設定為 true,否則 PHP 將拒絕載入物件。

如果 server_name 是一個陣列,它應該包含以下元素(區分大小寫!)。請注意,它們都是可選的(儘管您需要同時指定使用者名稱和密碼);如果您省略 Server 設定,將使用預設伺服器(如上所述),且物件的實例化不會受到 com.allow_dcom php.ini 指令的影響。

DCOM 伺服器名稱
鍵值 類型 說明
Server 字串 伺服器名稱。
Username 字串 連線的使用者名稱。
Password 字串 Username 的密碼。
Domain 字串 server 的網域。
Flags 整數 下列一個或多個常數,以邏輯 OR 運算結合:CLSCTX_INPROC_SERVERCLSCTX_INPROC_HANDLERCLSCTX_LOCAL_SERVERCLSCTX_REMOTE_SERVERCLSCTX_SERVERCLSCTX_ALL。如果這裡未指定,預設值為 CLSCTX_SERVER(如果您也省略了 `Server` 參數),或者如果您指定了伺服器,則為 CLSCTX_REMOTE_SERVER。您應該查閱 Microsoft 的 CoCreateInstance 文件以了解更多關於這些常數的含義;通常您永遠不需要使用它們。

字碼頁
指定用於將字串轉換為 Unicode 字串,以及反向轉換的字碼頁。每當 PHP 字串作為參數傳遞或從此 COM 物件的方法返回時,都會應用此轉換。字碼頁具有黏性,這意味著它會傳播到從物件返回的物件和變體。 可能的值為 CP_ACP(使用系統預設的 ANSI 字碼頁 - 如果省略此參數則為預設值)、CP_MACCPCP_OEMCPCP_SYMBOLCP_THREAD_ACP(使用為目前執行緒設定的字碼頁/地區設定)、CP_UTF7CP_UTF8。您也可以使用給定字碼頁的數字;有關字碼頁及其數值的更多詳細資訊,請查閱 Microsoft 文件。
新增註記

使用者貢獻的註記

此頁面沒有使用者貢獻的註記。
To Top