com_event_sink

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

com_event_sink — 将COM对象的事件连接到PHP对象

描述

com_event_sink(variant $variant, object $sink_object, array|string|null $sink_interface = null): bool

指示COM将variant生成的事件汇入PHP对象sink_object。

请谨慎使用此功能；如果您正在执行类似于以下示例的操作，那么在Web服务器上下文中运行它实际上没有意义。

参数

variant
sink_object: sink_object 应该是具有以所需dispinterface命名的方法的类的实例；您可以使用com_print_typeinfo() 来帮助生成此目的的模板类。
sink_interface: PHP将尝试使用与variant关联的类型库指定的默认dispinterface类型，但是您可以通过将sink_interface设置为要使用的dispinterface的名称来覆盖此选择。

返回值

成功时返回true，失败时返回false。

变更日志

版本	描述
8.0.0	`sink_interface` 现在可以为空。

示例

示例 #1 COM事件接收器示例

<?php
class IEEventSinker {
 var $terminated = false;

 function ProgressChange($progress, $progressmax) {
 echo "下载进度：$progress / $progressmax\n";
 }

 function DocumentComplete(&$dom, $url) {
 echo "文档 $url 完成\n";
 }

 function OnQuit() {
 echo "退出！\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;
?>

注释

警告

在PHP 8.0.0之前，不支持从任何事件处理程序中调用exit()，并且可能导致PHP挂起。这可以通过从事件处理程序中抛出异常，在主代码中捕获异常，然后从那里调用exit() 来解决。

参见

com_print_typeinfo() - 打印可调度接口的PHP类定义
com_message_pump() - 处理COM消息，最多休眠timeoutms毫秒

发现问题？

了解如何改进此页面 • 提交拉取请求 • 报告错误

＋添加注释

用户贡献的注释 2条注释

顶

踩

veggie ¶

7年前

我成功地实现了语音识别。我不确定我调用sink函数的方式为什么有效，但我现在更关心结果。这个小例子让我笑得前仰后合。

<?php
/* 
 * 搜索更多语音信息：
 * 自动化接口和对象 (SAPI 5.4)
 */

//说明： 
//php friend.php
//然后启动Windows语音识别并打开，然后说一些话

$voice = new COM("SAPI.SpVoice");

print "按Ctrl+C结束。\n";
print "朋友：你好，朋友！\n";

$voice->Speak("你好，朋友！");

class listen
{
 
 function Recognition($StreamNumber, $StreamPosition, $RecognitionType, $ISpeechRecoResult)
 {
 
 $phrase = $ISpeechRecoResult->PhraseInfo;
 $text = $phrase->GetText();
 
 print "\n你："$text"\n";
 
 
 global $voice;
 $say = array('哦', '不错', '嗯', '有意思', '是吗', '嗯哼', '对', '什么', '哈哈', '你开玩笑吧', '你也一样，伙计');
 $idx = rand(0, count($say)-1);
 
 print "朋友： " . $say[$idx] . "\n";
 $voice->Speak($say[$idx]);
 
 }
 
}

$recog = new COM("SAPI.SpSharedRecognizer");

$context = $recog->CreateRecoContext();

//SRERecognition = 16 (默认)
//SREAllEvents = 393215
//$context->EventInterests = 393215;

//尝试监听上下文中的事件
$listen = new listen(); //事件处理器
if (!com_event_sink($context, $listen, "RecognizerStateChange"))
{
 print "无法接收事件\n";
 exit;
}

$grammar = $context->CreateGrammar();

$i = $grammar->DictationLoad();

$s = $grammar->DictationSetState(1); //1=开启，0=关闭

while(true)
{
 
 if(!com_message_pump(1000))
 {
 print ".";
 }
 
}

?>

顶

踩

fjortiz ¶

19年前

如果有人需要ADODB.Connection事件的骨架接收器

class ADOConnectionEventSink {

function BeginTransComplete( $translevel, $objerror, $status, $objconn ) {
return 0;
    }

function CommitTransComplete( $objerror, $status, $objconn ) {
return 0;
    }

function RolbackTransComplete( $objerror, $status, $objconn ) {
return 0;
    }

function WillConnect ( $ConnectionString, $userid, $psword, $options, $status, $objconn ) {
return 0;
    }

function ConnectComplete ( $objerror, $status, $objconn) {
return 0;
    }

function Disconnect( $status, $objConn ) {
return 0;
    }

function WillExecute ( $src, $cursortyp, $locktyp, $options, $status, $objcomm, $objrs, $objconn ) {
return 0;
    }

function ExecuteComplete ( $recaffected, $objerror, $status, $objcomm, $objrs, $objconn ) {
return 0;
    }

function InfoMessage ( $objerror, $status, $objconn) {
return 0;
    }
}

// 之后...
$db = new COM("ADODB.Connection", NULL, $charPage);
$sink = new ADOConnectionEventSink();
com_event_sink($db, $sink, "ConnectionEvents");
//...

＋添加注释