函数名称: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 对象时,还可以调用其它方法和属性来完成各种操作,具体可以参考相关文档和示例。