ibase_set_event_handler

(PHP 5)

ibase_set_event_handler --  Enregistre une fonction de callback sur un événement iBase

Description

resource ibase_set_event_handler ( callback event_handler, string event_name1 [, string event_name2 [, string ...]] )

resource ibase_set_event_handler ( resource connection, callback event_handler, string event_name1 [, string event_name2 [, string ...]] )

ibase_set_event_handler() enregistre la fonction utilisateur PHP event_handler en tant que gestionnaire d'événements pour les événements spécifiés par event_name1, event_name2... La fonction event_handler callback est appelée avec le nom de l'événement et la ressource de connexion en tant qu'arguments dès qu'un événement spécifié est posté dans la base de données. La fonction callback doit retourner FALSE si le gestionnaire doit être annulé. Toute autre valeur de retour est ignorée. Cette fonction accepte jusqu'à 15 arguments d'événement.

Exemple 1. Exemple avec ibase_set_event_handler()

<?php

function event_handler($event_name, $link) {
  if (
$event_name=="NEW ORDER") {
     
// Traitement du nouvel ordre
     
ibase_query($link, "UPDATE orders SET status='handled'");
  } else if (
$event_name=="DB_SHUTDOWN") {
     
// Libération du gestionnaire
     
return false;
  }
}

ibase_set_event_handler($link,"event_handler","NEW_ORDER","DB_SHUTDOWN");
?>

La valeur retournée est une ressource d'événement. Elle peut être utilisée pour libérer le gestionnaire d'événements en utilisant ibase_free_event_handler().

Voir aussi ibase_free_event_handler() et ibase_wait_event().