array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'pt_BR', ), 'this' => array ( 0 => 'function.com-event-sink.php', 1 => 'com_event_sink', 2 => 'Conecta eventos de um objeto COM a um objeto PHP', ), 'up' => array ( 0 => 'ref.com.php', 1 => 'Funções de COM', ), 'prev' => array ( 0 => 'function.com-create-guid.php', 1 => 'com_create_guid', ), 'next' => array ( 0 => 'function.com-get-active-object.php', 1 => 'com_get_active_object', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'pt_BR', 'path' => 'reference/com/functions/com-event-sink.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

com_event_sink

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

com_event_sink — Conecta eventos de um objeto COM a um objeto PHP

Descrição

com_event_sink(variant $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.

Parâmetros

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.

Valor Retornado

Retorna true em caso de sucesso ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.0.0 sink_interface agora pode ser nulo.

Exemplos

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;
?>

Notas

Cuidado

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í.

Veja Também