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() 来解决。

    参见

    改进此页面

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

    用户贡献的备注 2 个备注

    1
    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     ".";
    }

    }

    ?>
    0
    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");
    //...
    ＋添加备注
    To Top