XII. Windows 的 COM 支持函数库
简介
COM 是一种允许（用任何语言编写的）可重用代码使用标准常规调用，同时将执行细节隐藏在 API 之后的技术，例如组件存储在某台机器上，同时可对机器执行内务处理。它可以被认为是一种带基础根对象的超级远程呼叫调用（Remote Procedure Call，RPC）机制。它将执行从接口中分离出来。
COM 促使执行从接口中分离，同时隐藏了执行细节，例如执行的位置和编写代码使用的语言。
需求
COM 函数仅可用于 PHP 的 Windows 版本。
运行时配置
这些函数的行为受 php.ini 的影响。
表格 1. COM 配置选项
| 名称 | 默认值 | 作用范围 |
|---|---|---|
| com.allow_dcom | "0" | PHP_INI_SYSTEM |
| com.autoregister_typelib | "0" | PHP_INI_SYSTEM |
| com.autoregister_verbose | "0" | PHP_INI_SYSTEM |
| com.autoregister_casesensitive | "1" | PHP_INI_SYSTEM |
| com.typelib_file | "" | PHP_INI_SYSTEM |
预定义常量
以下常量由本扩展模块定义，因此只有在本扩展模块被编译到 PHP 中，或者在运行时被动态加载后才有效。
- CLSCTX_INPROC_SERVER (integer)
- CLSCTX_INPROC_HANDLER (integer)
- CLSCTX_LOCAL_SERVER (integer)
- CLSCTX_REMOTE_SERVER (integer)
- CLSCTX_SERVER (integer)
- CLSCTX_ALL (integer)
- VT_NULL (integer)
- VT_EMPTY (integer)
- VT_UI1 (integer)
- VT_I2 (integer)
- VT_I4 (integer)
- VT_R4 (integer)
- VT_R8 (integer)
- VT_BOOL (integer)
- VT_ERROR (integer)
- VT_CY (integer)
- VT_DATE (integer)
- VT_BSTR (integer)
- VT_DECIMAL (integer)
- VT_UNKNOWN (integer)
- VT_DISPATCH (integer)
- VT_VARIANT (integer)
- VT_I1 (integer)
- VT_UI2 (integer)
- VT_UI4 (integer)
- VT_INT (integer)
- VT_UINT (integer)
- VT_ARRAY (integer)
- VT_BYREF (integer)
- CP_ACP (integer)
- CP_MACCP (integer)
- CP_OEMCP (integer)
- CP_UTF7 (integer)
- CP_UTF8 (integer)
- CP_SYMBOL (integer)
- CP_THREAD_ACP (integer)
参见
更多关于 COM 的信息请阅读 COM specification 或有可能的话看一看 Don Box 的 Yet Another COM Library (YACL)
- 目录
- COM -- COM 类
- DOTNET -- DOTNET class
- VARIANT -- VARIANT 类
- com_addref -- 增加组件引用计数。
- com_create_guid -- Generate a globally unique identifier (GUID)
- com_event_sink -- Connect events from a COM object to a PHP object
- com_get_active_object -- Returns a handle to an already running instance of a COM object
- com_get -- 获取 COM 组件的属性值
- com_invoke -- 调用 COM 组件的方法。
- com_isenum -- 获取一个 IEnumVariant
- com_load_typelib -- 装载一个 Typelib
- com_load -- 创建新的 COM 组件的引用
- com_message_pump -- Process COM messages, sleeping for up to timeoutms milliseconds
- com_print_typeinfo -- Print out a PHP class definition for a dispatchable interface
- com_propget -- com_get() 的别名
- com_propput -- com_set() 的别名
- com_propset -- com_set() 的别名
- com_release -- 减少组件引用计数。
- com_set -- 给 COM 组件的属性赋值
- variant_abs -- Returns the absolute value of a variant
- variant_add -- "Adds" two variant values together and returns the result
- variant_and -- performs a bitwise AND operation between two variants and returns the result
- variant_cast -- Convert a variant into a new variant object of another type
- variant_cat -- concatenates two variant values together and returns the result
- variant_cmp -- Compares two variants
- variant_date_from_timestamp -- Returns a variant date representation of a unix timestamp
- variant_date_to_timestamp -- Converts a variant date/time value to unix timestamp
- variant_div -- Returns the result from dividing two variants
- variant_eqv -- Performs a bitwise equivalence on two variants
- variant_fix -- Returns the integer portion ? of a variant
- variant_get_type -- Returns the type of a variant object
- variant_idiv -- Converts variants to integers and then returns the result from dividing them
- variant_imp -- Performs a bitwise implication on two variants
- variant_int -- Returns the integer portion of a variant
- variant_mod -- Divides two variants and returns only the remainder
- variant_mul -- multiplies the values of the two variants and returns the result
- variant_neg -- Performs logical negation on a variant
- variant_not -- Performs bitwise not negation on a variant
- variant_or -- Performs a logical disjunction on two variants
- variant_pow -- Returns the result of performing the power function with two variants
- variant_round -- Rounds a variant to the specified number of decimal places
- variant_set_type -- Convert a variant into another type "in-place"
- variant_set -- Assigns a new value for a variant object
- variant_sub -- subtracts the value of the right variant from the left variant value and returns the result
- variant_xor -- Performs a logical exclusion on two variants