PHP 8.4.1 Released!

PHP e COM

PHP pode ser usado para acessar objetos COM e DCOM em plataformas Win32.

Eu construí uma DLL para calcular algo. Existe uma maneira de executar essa DLL no PHP?

Se for uma DLL simples, ainda não tem como executá-la no PHP. Se a DLL contiver um serviço COM, você pode acessá-lo se ele implementar a interface IDispatch.

O que 'Unsupported variant type: xxxx (0xxxxx)' significa?

Existem dezenas de tipos VARIANT e combinações dos mesmos. A maioria deles já é suportada mas alguns ainda tem que ser implementados. Arrays não são completamente suportados. Apenas arrays indexados com uma única dimensão podem ser passados entre o PHP e COM. Se você achar outros tipos que não são suportados, por favor relate-os como um problema (se não tiverem sido relatados ainda) e passe o máximo de informação disponível.

É possível manipular objetos visuais no PHP?

Geralmente é, mas como o PHP é principalmente usado como linguagem de script para web, ele é executado no contexto dos servidores web, então objetos visuais nunca aparecerão no desktop do servidor. Se você usa o PHP para script de aplicações (por exemplo, em conjunto com PHP-GTK) não há limitação no acesso e manipulação de objetos visuais através de COM.

Posso guardar um objeto COM em uma sessão?

Não, não pode. Instâncias COM são tratadas como recursos (tipo "resource") e, portanto, só estão disponíveis no contexto de um script único.

Como eu capturo erros de COM?

A extensão COM lança exceções do tipo com_exception, que você pode capturar e então inspecionar o membro code para determinar o que fazer em seguida.

Posso gerar arquivos DLL a partir de scripts PHP como eu posso no Perl?

Não, infelizmente não existe tal ferramenta disponível para o PHP.

O que significa 'Unable to obtain IDispatch interface for CLSID {xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx}'?

Esse erro pode ter várias razões:

  • o CLSID está errado
  • a DLL requisitada não existe ou não pode ser lida
  • o componente requisitado não implementa a interface IDispatch

Como posso executar um objeto COM a partir de um servidor remoto?

Exatamente como você executa objetos locais. Você só tem que passar o IP da máquina remota como segundo parâmetro para o construtor COM.

Tenha certeza de marcar com.allow_dcom=true no seu php.ini.

Eu vejo o erro 'DCOM is disabled in C:\path...\scriptname.php on line 6', o que posso fazer?

Edite seu arquivo php.ini e marque com.allow_dcom=true.

É possível carregar/manipular um objeto ActiveX em uma página com PHP?

Isso não tem nada a ver com o PHP. Objetos ActiveX são carregados no lado do cliente se eles forem requisitados pelo documento HTML. Não há relação com o script PHP e, portanto, nenhuma possível interação direta com o lado do servidor.

É possível obter uma instância em execução de um componente?

É possível com a ajuda de monikers. Se você quiser obter referências múltiplas para a mesma instância do Word, você pode criar essa instância como mostrado abaixo:

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

Isso criará uma nova instância se não houver nenhuma instância em execuçaõ disponível e retornará um identificador para a instância em execução, se disponível.

Existe alguma maneria de lidar com um evento enviado por um objeto COM?

Você pode definir um interceptador de eventos e vinculá-lo usando com_event_sink(). Você pode usar com_print_typeinfo() para que o PHP gere um esqueleto para a classe interceptadora de eventos.

Estou tendo problemas ao tentar invocar um método de um objeto COM que expõe mais de uma interface. O que posso fazer?

A resposta é tão simples quanto insatisfatória. Não sabemos exatamente mas achamos que não há nada que você possa fazer.

Então PHP funciona com COM. E com COM+?

COM+ estende COM por meio de um framework para manipular componentes através de MTS e MSMQ, mas não há nada de especial que o PHP precise suportar para usar tais componentes.

Se o PHP pode manipular objetos COM, podemos imaginar o uso de MTS para manipular recursos de componentes, em conjuto com o PHP?

O PHP em si não lida com transações ainda. Por isso, se um erro ocorrer, nenhuma reversão é iniciada. Se você usar componentes que suportem transações você terá que implementar a manipulação de transações por conta própria.

adicione uma nota

Notas Enviadas por Usuários (em inglês) 3 notes

up
10
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
9
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
4
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.
To Top