PHP Conference Japan 2024

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、类 ID 或 Moniker,用于命名要加载的组件。 ProgID 通常是应用程序或 DLL 名称,后跟一个句点,然后是对象名称。例如:Word.Application 类 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 服务器名称
类型 描述
服务器 字符串 服务器的名称。
用户名 字符串 连接时使用的用户名。
密码 字符串 Username 的密码。
字符串 server 的域。
标志 整数 一个或多个以下常量,按逻辑或运算组合在一起:CLSCTX_INPROC_SERVERCLSCTX_INPROC_HANDLERCLSCTX_LOCAL_SERVERCLSCTX_REMOTE_SERVERCLSCTX_SERVERCLSCTX_ALL。如果此处未指定,则默认值为:如果您也省略了 Server,则为 CLSCTX_SERVER;如果您确实指定了服务器,则为 CLSCTX_REMOTE_SERVER。您应该查阅 Microsoft 的 CoCreateInstance 文档,以了解更多关于这些常量含义的信息;通常您永远不需要使用它们。

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

用户贡献注释

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