PHP 8.4.2 Released!

    PHP y COM

    PHP puede ser usado para acceder a objetos COM y DCOM en plataformas Win32.

    1. He compilado un DLL para calcular algo. ¿Hay alguna forma de ejecutar ese DLL bajo PHP?
    2. ¿Qué quiere decir 'Unsupported variant type: xxxx (0xxxxx)'?
    3. ¿Es posible manipular objetos visuales en PHP?
    4. ¿Puedo almacenar un objeto COM en una sesión?
    5. ¿Cómo puedo atrapar errores de COM?
    6. ¿Puedo generar archivos DLL desde scripts PHP como puedo en Perl?
    7. ¿Qué quiere decir 'Unable to obtain IDispatch interface for CLSID {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}'?
    8. ¿Cómo puedo ejecutar un objeto COM desde un servidor remoto?
    9. Recibo 'DCOM is disabled in C:\ruta...\nombre_script.php on line 6', ¿qué puedo hacer?
    10. ¿Es posible leer/manipular un objeto ActiveX en una página con PHP?
    11. ¿Es posible obtener una instancia en ejecución de un componente?
    12. ¿Hay una forma de manejar un evento enviado desde un objeto COM?
    13. Estoy teniendo problemas al intentar invocar un método de un objeto COM el cual expone más de una interfaz. ¿Qué puedo hacer?
    14. Así que PHP funciona con COM, ¿qué hay de COM+?
    15. Si PHP puede manipular objetos COM, ¿podemos imaginar el uso de MTS para manejar recursos de componentes, en conjunto con PHP?
    He compilado un DLL para calcular algo. ¿Hay alguna forma de ejecutar ese DLL bajo PHP?

    Si se trata de un DLL simple no hay forma aun de ejecutarlo desde PHP. Si el archivo DLL contiene un servidor COM es posible que pueda acceder a él si implementa la interfaz IDispatch.

    ¿Qué quiere decir 'Unsupported variant type: xxxx (0xxxxx)'?

    Existen docenas de tipos VARIANT y combinaciones de ellos. La mayoría de ellos son soportados pero algunos aun deben ser implementados. Las matrices no están completamente soportadas. Solo las matrices unidimensionales de índice pueden ser pasadas entre PHP y COM. Si encuentra otros tipos que no sean soportados, por favor repórtelos como un bug (si aun no han sido reportados) y ofrezca tanta información como tenga disponible.

    ¿Es posible manipular objetos visuales en PHP?

    En general es posible, pero ya que PHP es usado frecuentemente como un lenguaje de scripting web, corre en el contexto de servidores web, por lo que objetos visuales nunca aparecerán en el escritorio de los servidores. Si usa PHP para una aplicación de scripting, p.ej. en conjunto con PHP-GTK, no hay limitaciones al acceder y manipular objetos visuales a través de COM.

    ¿Puedo almacenar un objeto COM en una sesión?

    No, no puede. Las instancias COM son tratadas como recursos y por lo tanto sólo están disponibles en el contexto de un script único.

    ¿Cómo puedo atrapar errores de COM?

    La extensión COM lanza excepciones com_exception, las cuales puede atrapar y luego inspeccionar el miembro code para determinar el siguiente paso.

    ¿Puedo generar archivos DLL desde scripts PHP como puedo en Perl?

    No, desafortunadamente no existe una herramienta de ese tipo disponible para PHP.

    ¿Qué quiere decir 'Unable to obtain IDispatch interface for CLSID {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}'?

    Este error puede tener varias razones:

    • el valor CLSID es incorrecto
    • el archivo DLL solicitado no existe
    • el componente solicitado no implementa la interfaz IDispatch

    ¿Cómo puedo ejecutar un objeto COM desde un servidor remoto?

    Exactamente como ejecuta objetos locales. Tan solo debe pasar la IP de la máquina remota como segundo parámetro al constructor COM.

    Asegúrese de que ha definido com.allow_dcom=true en su php.ini.

    Recibo 'DCOM is disabled in C:\ruta...\nombre_script.php on line 6', ¿qué puedo hacer?

    Edite su archivo php.ini y defina com.allow_dcom=true.

    ¿Es posible leer/manipular un objeto ActiveX en una página con PHP?

    Esto no tiene nada que ver con PHP. Los objetos ActiveX son cargados en el lado del cliente si son solicitados por el documento HTML. No hay relación con el script PHP y por lo tanto no hay una interacción directa posible con el lado del servidor.

    ¿Es posible obtener una instancia en ejecución de un componente?

    Esto es posible con la ayuda de monikers. Si desea obtener múltiples referencias a la misma instancia de word, puede crear esa instancia como se muestra:

    <?php
    $word     = new COM("C:\docs\word.doc");
    ?>

    Esto creará una nueva instancia si no hay una instancia en ejecución disponible, o devolverá un gestor a la instancia en ejecución, si existe.

    ¿Hay una forma de manejar un evento enviado desde un objeto COM?

    Puede definir el receptor de un evento y asociarlo usando com_event_sink(). Es posible usar com_print_typeinfo() para que PHP genere un esqueleto para la clase receptora del evento.

    Estoy teniendo problemas al intentar invocar un método de un objeto COM el cual expone más de una interfaz. ¿Qué puedo hacer?

    La respuesta es tan simple como poco satisfactoria. No estamos seguros pero parece que no es posible hacer nada.

    Así que PHP funciona con COM, ¿qué hay de COM+?

    COM+ extiende COM mediante un marco para administrar componentes a través de MTS y MSMQ pero no hay nada especial que PHP deba soportar para usar tales componentes.

    Si PHP puede manipular objetos COM, ¿podemos imaginar el uso de MTS para manejar recursos de componentes, en conjunto con PHP?

    PHP por sí mismo no maneja transacciones aun. Por lo tanto si un error ocurre no se inicia un proceso rollback. Si usa componentes que soporten transacciones tendrá que implementar la gestión de transacciones usted mismo.

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 3 notes

    up
    8
    Anonymous
    19 years ago
    Re: The Windows English CHM Sample with MS Word Automation.

    I see that $Word->Release() is called after $Word->Quit().
    This seems to be erroneous. Actually, $Word->Release() should not have to be called if proper COM garbage collection is taking place. Release() is a C++ construction not used in either Visual Basic or VBScript or even MS-JScript. Just to be sure, however, I ran the sample through php.exe (5.04 CLI on Windows XP SP1 with Office 2003) and got a RPC failed error on the line containing $Word->Release(). The rest of the sample works fine, and the results are as expected. So, I propose 2 scenarios:
    1.There is a problem with the documentation (more likely).
    2.There is a problem with PHP504 itself, as this problem is reproduced with any COM Automation call, not just Word.
    up
    6
    junk.ghost@virgin dOtt net
    20 years ago
    It may be obvious to everyone else but...

    If you want to write your own COM DLL in MSVC++6 and you want to pass it a string, you need the following in your .idl file:

    HRESULT function_name([in] BSTR parameter_name,
    [retval, out] BSTR * retval);

    retval is the result of your function as a string to be passed back.

    BSTR is an unsigned short *, so if you want to use your string with STL string etc. you may need to convert parameters to and from char *.

    The burden of my message is that from PHP

    $comThing = new COM("comThing.comThing");
    print $comThing->function_name("Jeremy");

    Jeremy will be marshalled as wide chars, which match BSTR.
    up
    2
    codeslinger at compsalot dot com
    17 years ago
    in response to item #1 above: "If this is a simple DLL there is no way yet to run it from PHP."

    Answer: There are several different packages/add-ons to php that enable low level access to the windows api. One of the most popular of these packages is available at http://www.winbinder.org

    Winbinder does have the ability to load a dll and call it's functions. Winbinder also provides a large set of windows apis for creating windows and controls. This is useful for creating stand-alone desktop apps. It is a possible alternative to php-gtk.

    I've had mixed results with Winbinder, some things work very well, others are buggy; source code is available. It's worth a look, Evaluate carefully.
    ＋add a note
    To Top