Php/docs/function.ibase-set-event-handler

提供:Dev Guides
< Php
移動先:案内検索

ibase_set_event_handler

(PHP 5, PHP 7 < 7.4.0)

ibase_set_event_handlerイベントが発生した際にコールされるコールバック関数を登録する


説明

ibase_set_event_handler ( callable $event_handler , string $event_name , string ...$even_names ) : resource

ibase_set_event_handler ( resource $connection , callable $event_handler , string $event_name , string ...$event_names ) : resource

この関数は、指定したイベントのハンドラとして PHP ユーザー関数を登録します。


パラメータ

event_handler

コールバックは、データベースから特定のイベントが送信された場合に、 イベント名とリンクリソースを引数としてコールされます。

イベントハンドラがキャンセルされた場合は、 コールバックは false を返す必要があります。 その他の返り値は無視されます。 この関数は、最大 15 のイベントを引数として受け取ります。

event_name

イベントの名前。

event_names

最大で 15 のイベントを指定できます。


返り値

返される値はイベントのリソースです。このリソースは、 ibase_free_event_handler() でイベントハンドラを開放する際に使用可能です。


例1 ibase_set_event_handler() の例

<?phpfunction event_handler($event_name, $link){    if ($event_name == "NEW ORDER") {        // 新しい注文を処理します        ibase_query($link, "UPDATE orders SET status='handled'");    } else if ($event_name == "DB_SHUTDOWN") {        // イベントハンドラを解放します        return false;    }}ibase_set_event_handler($link, "event_handler", "NEW_ORDER", "DB_SHUTDOWN");?>

参考