No longer maintained

I am not longer going to maintain this project. Please visit this fork to get one that is maintained:

https://github.com/nathanmac/CodeIgniter-Events

CodeIgniter Events Library

Build extendible applications with an events system.

Version 1.0.0

• Author: Eric Barnes
• Author: Dan Horrigan

Public Methods

register

Registers a Callback for a given event

• $event string
• $callback array
• Example: Events::register('test_string', array('Class_name', 'string_return'));

trigger

Triggers an event and returns the results.

• $event string - The name of the event
• $data mixed - Any data that is to be passed to the listener
• $return_type string - Either 'array', 'json', 'serialized', or 'string'
• Example: Events::trigger('test_string', 'test', 'string');

has_listeners

Checks if the event has any listeners

• $event string - The name of the event
• return bool

Usage Overview

All Events functions are static.

You can add a listener to an event with the register() function:

The second parameter of register() is an array that is callable via call_user_func().

You trigger an Event by calling the trigger() function:

The 3rd parameter is the type of data you wish trigger() to return. Your options are as follows:

• 'array'
• 'json'
• 'serialized'
• 'string' (the default)

Example Usage

Because events need to be registered before being used it is a good idea to have a system in place to load any of these before you trigger any events.

Here is an example using a third party library to register the event.