com::__construct

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

com::__constructcom 类构造函数

说明

public com::__construct(
    string $module_name,
    array|string|null $server_name = null,
    int $codepage = CP_ACP,
    string $typelib = ""
)

构造一个新的 com 对象。

参数

module_name
可以是 ProgID、Class ID 或 Moniker,用于命名要加载的组件。 ProgID 通常是应用程序或 DLL 的名称,后面跟着一个句点,然后是对象名称。例如:Word.Application Class ID 是唯一标识给定类的 UUID。 Moniker 是一种特殊的命名形式,类似于 URL 方案的概念,它标识资源并指定其加载方式。例如,您可以加载 Word 并通过指定 Word 文档的完整路径作为模块名称来获取表示 Word 文档的对象,或者您可以使用 LDAP: 作为 Moniker 来使用 ADSI 接口连接 LDAP。
server_name
要加载和运行组件的 DCOM 服务器的名称。如果为 null,则使用应用程序的默认值运行对象。默认情况下,通常在本地计算机上运行它,尽管管理员可能已将应用程序配置为在其他计算机上启动。 如果为 server 指定非 null 值,则除非 com.allow_dcom php.ini 选项设置为 true,否则 PHP 将拒绝加载该对象。

如果 server_name 是一个数组,它应该包含以下元素(区分大小写!)。请注意,它们都是可选的(尽管您需要同时指定用户名和密码);如果您省略 Server 设置,将使用默认服务器(如上所述),并且对象的实例化不会受到 com.allow_dcom php.ini 指令的影响。

DCOM 服务器名称
key type description
Server string 服务器的名称。
Username string 连接时的用户名。
Password string Username 的密码。
Domain string server 的域。
Flags integer 以下常量中的一个或多个,按逻辑 OR 运算连接在一起:CLSCTX_INPROC_SERVERCLSCTX_INPROC_HANDLERCLSCTX_LOCAL_SERVERCLSCTX_REMOTE_SERVERCLSCTX_SERVERCLSCTX_ALL。如果没有在此处指定,则默认值为 CLSCTX_SERVER(如果您也省略了 Server),或者为 CLSCTX_REMOTE_SERVER(如果您确实指定了服务器)。您应该查阅 Microsoft 文档以获取有关 CoCreateInstance 的更多信息,了解这些常量的含义;通常您永远不必使用它们。

codepage
指定用于将字符串转换为 Unicode 字符串以及将 Unicode 字符串转换回字符串的代码页。只要将 PHP 字符串作为参数传递或从此 COM 对象的方法返回,就会应用转换。代码页具有粘性,这意味着它会传播到从对象返回的对象和变体。 可能的值是 CP_ACP(使用系统默认的 ANSI 代码页 - 如果省略此参数,则为默认值)、CP_MACCPCP_OEMCPCP_SYMBOLCP_THREAD_ACP(使用为当前执行线程设置的代码页/区域设置)、CP_UTF7CP_UTF8。您也可以使用给定代码页的数字;请参阅 Microsoft 文档以获取有关代码页及其数值的更多详细信息。
添加备注

用户贡献的备注

此页面没有用户贡献的备注。
To Top