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 のイベントを指定できます。
例
例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");?>