English | 简体中文 | 繁體中文
查询

com::__construct()函数—用法及示例

「 一个魔术方法(Magic Method),在通过 new 操作符创建一个 com 对象时自动调用的构造函数 」


函数名称:com::__construct()

适用版本:PHP 5, PHP 7

函数描述:com::__construct() 是一个魔术方法(Magic Method),在通过 new 操作符创建一个 com 对象时自动调用的构造函数。

语法:void com::__construct ( mixed $module_name [, mixed $server_name [, mixed $codepage [, mixed $typelib]]] )

参数:

  • module_name: 一个字符串,指定了要创建的 COM 服务器模块的名称。
  • server_name: 一个可选的字符串,指定了要与之通信的服务器的名称。
  • codepage: 一个可选的整数,指定了与之通信的服务器的代码页。
  • typelib: 一个可选的字符串,指定了要使用的类型库的名字。

返回值:无。

示例:

$excel = new COM("Excel.Application") or die("Unable to instantiate Excel");
echo "Excel module loaded\n";

上述示例中,通过使用 com::__construct() 以及 COM 类来实例化一个名为 "Excel.Application" 的 COM 对象。如果无法实例化该对象,将会显示错误信息。如果成功实例化,则会输出 "Excel module loaded"。

注意事项:

  • 该函数只在 Windows 平台下的 PHP 版本中可用。
  • 必须在 PHP 启用了 COM 扩展的情况下才能使用该函数。
  • 参数 module_name 是必需的,它指定了要创建的 COM 服务器模块的名称。通常是一个字符串,在系统注册表中查找对应的 COM 服务器。(如 "Excel.Application" 是 Excel 的 COM 服务器模块名称)
  • 如果参数 server_name 和 codepage 都未指定,则默认使用本地服务器和本地代码页。
  • 如果参数 typelib 未提供,则默认基于 system32 目录下的相应类型库。
  • 如果无法实例化 COM 对象,则函数会返回 FALSE,否则为 TRUE。
  • 当不再需要 COM 对象时,应该显式地调用对应的析构函数来释放资源,例如 unset($excel)。
  • 使用 COM 对象时,还可以调用其它方法和属性来完成各种操作,具体可以参考相关文档和示例。

补充纠错
热门PHP函数
分享链接