PHP EVENTS MANAGER

<?php

/*
** PHP Events Manager
** Version 1.2.1 (26/08/2007)
** Auteur : Psykocrash (SERRAJ Younes)
** 
** PHP Events Manager. Programmation évènementielle en PHP5.
** Copyright (C) 2007 SERRAJ Younes - Tous droits réservés.
** 
** Licence : http://www.gnu.org/licenses/lgpl.txt
** 
** Cette bibliothèque est un logiciel libre ; vous pouvez la redistribuer ou
** la modifier suivant les termes de la Licence Générale Publique Limitée
** GNU telle que publiée par la Free Software Foundation dans la version 2.1 
** de la License.
** 
** Cette bibliothèque est distribuée dans l’espoir qu’elle sera utile, mais
** SANS AUCUNE GARANTIE : sans même la garantie implicite de
** COMMERCIABILISABILITÉ ou d’ADÉQUATION À UN OBJECTIF PARTICULIER. Consultez
** la Licence Générale Publique Limitée pour plus de détails.
** ** Vous devriez avoir reçu une copie de la Licence Générale Publique Limitée
** avec cette bibliothèque ; si ce n’est pas le cas, écrivez à la :
** Free Software Foundation, Inc., 59 Temple Place, Suite 330, Boston,
** MA 02111-1307, USA.
*/

if (!defined('PEM_PHP5_'))
	{
		define('PEM_PHP5_', true);
		
		class PEM
			{
				protected static $events_list = array();
				public static $safe_mode = false;
				
				/*
				** Cette fonction cré un évènement
				** sur lequel pourront être placés
				** des hooks.
				*/
				public static function create_event($event_name)
					{
						$event_exists = self::event_exists($event_name);
						if (self::$safe_mode === true && $event_exists === true)
							throw new Exception("[Safe Mode] L'évènement ''" . htmlspecialchars($event_name) . "'' existe déjà.");
						if (!$event_exists)
							self::$events_list[$event_name] = array();
					}
				
				/*
				** Cette fonction vérifie si un
				** d'évènement existe.
				**
				** Return: true/false.
				*/
				public static function event_exists($event_name)
					{
						if (!is_array(self::$events_list)) return false;
						if (array_key_exists($event_name, self::$events_list) === true)
							return true;
						else
							return false;
					}
				
				/*
				** Cette fonction déclanche un évènement.
				*/
				public static function raise_event($event_name, $params = '')
					{
						if (!self::event_exists($event_name))
							throw new Exception("L'évènement ''" . htmlspecialchars($event_name) . "'' n'existe pas.");
						foreach (self::$events_list[$event_name] as $function_name_to_call)
							{
								if (!function_exists($function_name_to_call))
									throw new Exception("La fonction ''" . htmlspecialchars($function_name_to_call) . "'' n'existe pas.");
								if (is_array($params))
									call_user_func_array($function_name_to_call, $params);
								else
									call_user_func($function_name_to_call, $params);
							}
					}
				
				/*
				** Cette fonction supprime un évènement
				** et tous les hooks liés.
				*/
				public static function delete_event($event_name)
					{
						if (!self::event_exists($event_name))
							{
								if (self::$safe_mode === true)
									throw new Exception("[Safe Mode] L'évènement ''" . htmlspecialchars($event_name) . "'' n'existe pas.");
							}
						else
							unset(self::$events_list[$event_name]);
					}
				
				/*
				** Cette fonction cré un hook sur
				** un évènement.
				*/
				public static function create_hook($event_name, $function_name_to_call)
					{
						if (!function_exists($function_name_to_call))
							throw new Exception("La fonction ''" . htmlspecialchars($function_name_to_call) . "'' n'existe pas.");
						if (!self::event_exists($event_name))
							throw new Exception("L'évènement ''" . htmlspecialchars($event_name) . "'' n'existe pas.");
						$hook_exists = self::hook_exists($event_name, $function_name_to_call);
						if (self::$safe_mode === true && $hook_exists === true)
							throw new Exception("[Safe Mode] Le hook ''" . htmlspecialchars($event_name) . '->' . htmlspecialchars($function_name_to_call) . "'' existe déjà.");
						self::$events_list[$event_name][$function_name_to_call] = $function_name_to_call;
					}
				
				/*
				** Cette fonction vérifie si un
				** hook existe.
				**
				** Return: true/false.
				*/
				public static function hook_exists($event_name, $function_name_to_call)
					{
						if (!self::event_exists($event_name))
							throw new Exception("L'évènement ''" . htmlspecialchars($event_name) . "'' n'existe pas.");
						if (array_key_exists($function_name_to_call, self::$events_list[$event_name]) === true)
							return true;
						else
							return false;
					}
				
				/*
				** Cette fonction supprime un hook
				** existant.
				*/
				public static function delete_hook($event_name, $function_name_to_call)
					{
						if (!self::hook_exists($event_name, $function_name_to_call))
							{
								if (self::$safe_mode === true)
									throw new Exception("Le hook ''" . htmlspecialchars($event_name) . '->' . htmlspecialchars($function_name_to_call) . "'' n'existe pas.");
							}
						else
							unset(self::$events_list[$event_name][$function_name_to_call]);
					}
			}
	}

?>

Télécharger le zip

25 août 2007 14:03:01 :

Possibilité de déclencher les évènements en les appelant comme des méthodes de la classe PEM. Gestion des erreurs via exceptions. Correction de deux bugs.

26 août 2007 18:37:51 :

Classe désormais statique. Utilisation des comparaisons strictes.