(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
com_event_sink — Conecta eventos de um objeto COM a um objeto PHP
$variant
, object $sink_object
, array|string|null $sink_interface
= null
): bool
Instrui o COM a coletar eventos gerados por
variant
no objeto PHP
sink_object
.
Deve-se ter cuidado ao usar este recurso; se algo semelhante ao exemplo abaixo estiver sendo feito, não faz sentido executar em um contexto de servidor web.
variant
sink_object
sink_object
deve ser uma instância de uma classe com
métodos nomeados de acordo com aqueles da dispinterface desejada; pode-se usar
com_print_typeinfo() para ajudar a gerar uma classe de modelo
para esse propósito.
sink_interface
O PHP tentará usar o tipo de dispinterface padrão especificado pela
biblioteca de tipos associada com variant
, mas
pode-se substituir esta escolha definindo
sink_interface
como o nome da dispinterface
que será usada.
Versão | Descrição |
---|---|
8.0.0 |
sink_interface agora pode ser nulo.
|
Exemplo #1 Exemplo de com_event_sink
<?php
class IEEventSinker {
var $terminated = false;
function ProgressChange($progress, $progressmax) {
echo "Download progress: $progress / $progressmax\n";
}
function DocumentComplete(&$dom, $url) {
echo "Document $url complete\n";
}
function OnQuit() {
echo "Quit!\n";
$this->terminated = true;
}
}
$ie = new COM("InternetExplorer.Application");
$sink = new IEEventSinker();
com_event_sink($ie, $sink, "DWebBrowserEvents2");
$ie->Visible = true;
$ie->Navigate("http://www.example.org");
while(!$sink->terminated) {
com_message_pump(4000);
}
$ie = null;
?>
Antes do PHP 8.0.0, chamar exit() de qualquer um dos manipuladores de eventos não era suportado e poderia fazer com que o PHP travasse. Isso poderia ser contornado lançando uma exceção a partir do manipulador de eventos, capturando a exceção no código principal e chamando exit() a partir daí.