# ibase_set_event_handler

(PHP 5, PHP 7 < 7.4.0)

ibase_set_event_handler — Enregistre une fonction de rappel sur un événement interBase

### Description

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

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.

### Liste de paramètres

`event_handler`

  Fonction de rappel 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 de rappel `event_handler` 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.

`event_name`

  Le nom de l'événement.

`event_names`

  15 événements tout au plus sont autorisés.

### Valeurs de retour

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

### Exemples

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");
?>`

### Voir aussi

- ibase_free_event_handler() - Libère un gestionnaire d'événements iBase
- ibase_wait_event() - Attend un événement interBase