Forum und email

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.

Example#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().