International PHP Conference Berlin 2021


(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)

com_print_typeinfoПечатает определение класса PHP для интерфейса, наследующего IDispatch


com_print_typeinfo ( variant|string $variant , string|null $dispatch_interface = null , bool $display_sink = false ) : bool

Назначение функции состоит в создании "рыбы" класса для использования в качестве приёмника событий. Также вы можете использовать её для генерации заглушки для любого объекта COM при условии, что он поддерживает достаточное количество интерфейсов самодиагностики, и что вы знаете имя интерфейса, который вы хотите отобразить.

Список параметров


variant должен быть экземпляром класса COM, либо именем библиотеки типов (которое будет разобрано согласно набору правил, заданному в com_load_typelib()).


Имя интерфейса, наследующего IDispatch, который вы хотите отобразить.


Если true, то будет отображён соответствующий интерфейс приёмника событий.

Возвращаемые значения

Возвращает true в случае успешного завершения или false в случае возникновения ошибки.

Смотрите также

add a note add a note

User Contributed Notes 2 notes

csaba at alum dot mit dot edu
16 years ago
com_print_typeinfo is really useful if you're trying to figure out what properties and methods you have access to.  For example, I might do:

= new COM("Shell.Application");

The first line shows me the class of the object (what VBScript calls 'typename'), in my case IShellDispatch4.  It's frequently the case that if you plunk that in as the second argument to com_print_typeinfo, you get way more methods/properties coming back.  Thus:

= new COM("Shell.Application");
com_print_typeinfo($oExplorer, "IShellDispatch4");

Furthermore, you might get additional functions listed if you try lower number suffixes (or not).  At any rate, it would be useful for PHP to have a typename function like VBScript does.  For example, if you iterate through the Windows of $oExplorer you get both IE and Explorer windows and typename is the easy way to differentiate between them.  Here's what I'm using:

function typeName($objCOM) {
    if (empty(
$objCOM)) return "no COM object";
    if (
gettype($objCOM)!="object") return "not a COM object";
$typeInfo = ob_get_contents();
$pattern = "/^\\s*class (.*) \\{/";
    if (!(
$matchCnt = preg_match($pattern, $typeInfo, $aMatch))) return "Not found";

Csaba Gabor from Vienna
Richard Lynch
14 years ago
In my particular version of PHP, the second and third arguments are not, in fact, optional.

Passing in '' for both, however, yielded a bucketful of information.

To Top