Introducci贸n

COM es un acr贸nimo para Component Object Model (Modelo de Objetos por Componentes); es una capa orientada a objetos (asi como servicios asociados) que cubre la especificaci贸n DCE RPC (un est谩ndar abierto) y define una convenci贸n com煤n de llamado que permite que c贸digo escrito en cualquier lenguaje pueda llamar e inter-operar con c贸digo escrito en cualquier otro lenguaje (provisto que ambos lenguajes hagan uso de COM). No solo es posible escribir el c贸digo en cualquier lenguaje, tambi茅n es cierto que no necesita ser parte del mismo ejecutable; el c贸digo puede ser cargado desde un recurso DLL, encontrarse en otro proceso corriendo en la misma m谩quina, o, mediante DCOM (COM Distribuido), encontrarse en otro proceso en una m谩quina remota, todo esto sin requerir que su c贸digo sepa siquiera en d贸nde reside el componente.

Existe un sub-conjunto de COM conocido como Automatizaci贸n OLE que se compone de un grupo de interfaces OLE que permiten los enlaces flexibles con objetos COM, de modo que puedan ser susceptibles a introspecci贸n y llamados en tiempo de ejecuci贸n sin conocimientos en tiempo de compilaci贸n sobre el modo de operaci贸n del objeto. La extensi贸n COM de PHP utiliza las interfaces de Automatizaci贸n OLE para permitirle crear y llamar objetos compatibles desde sus scripts. T茅cnicamente hablando, 茅sta deber铆a ser llamada la "Extensi贸n de Automatizaci贸n OLE para PHP", ya que no todos los objetos COM son compatibles con OLE.

Ahora bien, 驴porqu茅 querr铆a o deber铆a usar COM? COM es una de las formas principales de unir aplicaciones y componentes en la plataforma Windows; mediante el usa de COM usted puede iniciar Microsoft Word, llenar una plantilla de documento y guardar el resultado como un documento Word y enviarlo a un visitante de su sitio web. Tambi茅n puede usar COM para realizar tareas administrativas para su red y para configurar su servidor web (IIS); tales son apenas los usos m谩s comunes; usted puede hacer mucho m谩s con COM.

A partir de PHP 5, esta extensi贸n (y su documentaci贸n) fue re-escrita por completo y se ha eliminado gran parte del material confuso e in煤til. Adicionalmente, se ofrece soporte para la creaci贸n de instancias y ensambles .Net usando la capa de interoperabilidad COM ofrecida por Microsoft.

Por favor lea este art铆culo para una vista general de los cambios en 茅sta extensi贸n en PHP 5.

Requisitos

Las funciones COM se encuentran disponibles 煤nicamente para la versi贸n Windows de PHP.

El soporte para .Net requiere PHP 5 y el entorno de desarrollo .Net.

Instalaci贸n

No se necesita ninguna instalaci贸n para usar estas funciones, son parte del n煤cleo de PHP.

La versi贸n para Windows de PHP tiene soporte nativo para esta extensi贸n. No se necesita cargar ninguna extensi贸n adicional para usar estas funciones.

Usted es responsable de la instalaci贸n del soporte para los varios objetos COM que piensa usar (tales como MS Word); nosotros no incluimos todos 茅stos con PHP, ni podemos hacerlo.

For Each

A partir de PHP 5, usted puede usar la sentencia la secci贸n de nombre foreach en Cap铆tulo 16 de PHP para iterar sobre los contenidos de un IEnumVariant COM/OLE est谩ndar. En t茅rminos m谩s simples, esto quiere decir que puede usar foreach en aquellas situaciones en donde podr铆a haber usado For Each en c贸digo VB/ASP.

Ejemplo 1. For Each en ASP <% Set objetoDominio = GetObject("WinNT://Domain") For Each obj in objetoDominio Response.Write obj.Name & "<br />" Next %>

Ejemplo 2. while() ... Next() en PHP 4 <?php $objetoDominio = new COM("WinNT://Domain"); while ($obj = $objetoDominio->Next()) {    echo $obj->Name . "<br />"; } ?>

Ejemplo 3. foreach en PHP 5 <?php $objetoDominio = new COM("WinNT://Domain"); foreach ($objetoDominio as $obj) {    echo $obj->Name . "<br />"; } ?>

Matrices y propiedades COM tipo-matriz

Muchos objetos COM exponen sus propiedades como matrices, o usando un acceso estilo-matriz. En PHP 4, es posible usar la sintaxis de matrices de PHP para leer/escribir tales propiedades, pero s贸lo es posible manipular una dimensi贸n. Si desea leer una propiedad multi-dimensional, puede crear el acceso en forma de un llamado de funci贸n, en donde cada par谩metro representa cada par谩metro del acceso a la matriz, aunque no hay forma de escribir tal tipo de propiedad.

PHP 5 introduce las siguientes caracter铆sticas nuevas para facilitar su vida:

• Acceso a matrices multi-dimensionales, o propiedades COM que requieren m煤ltiples par谩metros usando la sintaxis de matrices de PHP. Tambi茅n puede escribir o definir propiedades usando 茅sta t茅cnica.

• Iterar a trav茅s de SafeArrays ("verdaderas" matrices) usando la estructura de control la secci贸n de nombre foreach en Cap铆tulo 16. Esto funciona ya que los SafeArrays incluyen informaci贸n sobre su tama帽o. Si una propiedad estilo-matriz implementa IEnumVariant, entonces tambi茅n puede usar foreach para tales propiedades; eche un vistazo a la secci贸n de nombre For Each para m谩s informaci贸n sobre este tema.

Excepciones (PHP 5)

Esta extensi贸n arroja instancias de la clase com_exception siempre que se presente un error potencialmente fatal reportado por COM. Todas las excepciones COM tienen una propiedad code bien definida que corresponde con el valor de retorno HRESULT proveniente de las varias operaciones COM. Es posible usar 茅ste c贸digo para tomar decisiones program谩ticas sobre c贸mo manejar la excepci贸n.

Configuraci贸n en tiempo de ejecuci贸n

El comportamiento de estas funciones est谩 afectado por los valores definidos en php.ini.

A continuaci贸n se presenta una corta explicaci贸n de las directivas de configuraci贸n.

Constantes predefinidas

Estas constantes est谩n definidas por esta extensi贸n y estar谩n disponibles solamente cuando la extensi贸n ha sido o bien compilada dentro de PHP o grabada din谩micamente en tiempo de ejecuci贸n.

Ver tambi茅n

Para m谩s informaci贸n sobre COM, lea la especificaci贸n COM o quiz谩s eche un vistazo a la Otra Biblioteca COM M谩s (YACL por sus siglas en Ingl茅s) de Don Box. Puede encontrar informaci贸n adicional en nuestro FAQ sobre Cap铆tulo 57. Si est谩 pensando en usar aplicaciones MS Office en el lado del servidor, es buena idea que lea la informaci贸n encontrada aqu铆: Consideraciones para la Automatizaci贸n de Office en el Lado del Servidor.