ibase_set_event_handler(3) [php man page]

IBASE_SET_EVENT_HANDLER(3)						 1						IBASE_SET_EVENT_HANDLER(3)

ibase_set_event_handler - Register a callback function to be called when events are posted

SYNOPSIS

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

DESCRIPTION

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

	This function registers a PHP user function as event handler for the specified events.

PARAMETERS

	      o $event_handler
		- The callback is called with the event name and the link resource as arguments whenever one of the specified events is posted	by
		the  database.	 The  callback	must return FALSE if the event handler should be canceled. Any other return value is ignored. This
		function accepts up to 15 event arguments.

	      o $event_name1
		- An event name.

	      o $event_name2
		- At most 15 events allowed.

RETURN VALUES

	The return value is an event resource. This resource can be used to free the event handler using ibase_free_event_handler(3).

EXAMPLES

       Example #1

	      ibase_set_event_handler(3) example

	      <?php

	      function event_handler($event_name, $link)
	      {
		  if ($event_name == "NEW ORDER") {
		      // process new order
		      ibase_query($link, "UPDATE orders SET status='handled'");
		  } else if ($event_name == "DB_SHUTDOWN") {
		      // free event handler
		      return false;
		  }
	      }

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

SEE ALSO

       ibase_free_event_handler(3), ibase_wait_event(3).

PHP Documentation Group 												IBASE_SET_EVENT_HANDLER(3)

EVENT_SET(3)								 1							      EVENT_SET(3)

event_set - Prepare an event

SYNOPSIS

       bool event_set (resource  $event, mixed	$fd, int  $events, mixed  $callback, [mixed  $arg])

DESCRIPTION

	Prepares  the event to be used in event_add(3). The event is prepared to call the function specified by the $callback on the events speci-
       fied in parameter $events, which is a set of the following flags: EV_TIMEOUT, EV_SIGNAL, EV_READ, EV_WRITE and EV_PERSIST.

	If EV_SIGNAL bit is set in parameter $events, the $fd is interpreted as signal number.

	After initializing the event, use event_base_set(3) to associate the event with its event base.

	In case of matching event, these three arguments are passed to the $callback function:

	      o $fd
		- Signal number or resource indicating the stream.

	      o $events
		- A flag indicating the event. Consists of the following flags: EV_TIMEOUT, EV_SIGNAL, EV_READ, EV_WRITE and EV_PERSIST.

	      o $arg
		- Optional parameter, previously passed to event_set(3) as $arg.

PARAMETERS

	      o $event
		- Valid event resource.

	      o $fd
		- Valid PHP stream resource. The stream must be castable to file descriptor, so you most likely won't be able to use any  of  fil-
		tered streams.

	      o $events
		-  A  set of flags indicating the desired event, can be EV_READ and/or EV_WRITE. The additional flag EV_PERSIST makes the event to
		persist until event_del(3) is called, otherwise the callback is invoked only once.

	      o $callback
		- Callback function to be called when the matching event occurs.

	      o $arg
		- Optional callback parameter.

RETURN VALUES

       event_set(3) returns TRUE on success or FALSE on error.

CHANGELOG

       +--------+------------------------------+
       |Version |			       |
       |	|			       |
       |	|	  Description	       |
       |	|			       |
       +--------+------------------------------+
       | 0.0.4	|			       |
       |	|			       |
       |	|			       |
       |	| EV_SIGNAL support was added. |
       |	|			       |
       +--------+------------------------------+
PHP Documentation Group 													      EVENT_SET(3)