naholyr

<?php

// Exception lanc�e par notify() quand le callback n'est pas valide
class EventCallbackError extends Exception { }

// Registre des �v�nements �cout�s : ce registre sait quel �v�nement est �cout� par quel objet
// Il permet la distribution globale d'un �v�nement
// C'est ensuite l'objet lui-m�me qui se charge de r�agir � l'�v�nement
// Voir principalement register(), unregister(), notifyGlobal(), notify()
class Events
{

    // Les �v�nements, et les objets qui les �coutent
    protected static $registeredEvents = array();

    // Pr�venir que cet objet �coute cet �v�nement
    public static function register(EventListener $listener, $eventName)
    {
        if (!isset(Events::$registeredEvents[$eventName])) {
            Events::$registeredEvents[$eventName] = array();
        }

        if (!Events::isRegistered($eventName, $listener)) {
            Events::$registeredEvents[$eventName][] = $listener;

            return true;
        }

        return false;
    }

    // L'�v�nement est-il enregistr� pour l'objet donn� ?
    public static function isRegistered($eventName, EventListener $listener)
    {
        foreach (Events::getListeners($eventName) as $a_listener) {
            if ($listener->getUUID() == $a_listener->getUUID()) {

                return true;
            }
        }

        return false;
    }

    // R�cup�rer les objets �coutant l'�v�nement donn�
    public static function getListeners($eventName)
    {
        if (isset(Events::$registeredEvents[$eventName])) {

            return Events::$registeredEvents[$eventName];
        } else {

            return array();
        }
    }

    // Effacer l'�coute d'un �v�nement
    public static function unregister(EventListener $listener, $eventName)
    {
        unset(Events::$registeredEvents[$eventName][$listener->getUUID()]);

        return true;
    }

    // Notification d'un �v�nement de mani�re globale
    // Retourne l'�v�nement (modifi�, voir $event->getReturnValue() et $event->getProcessed())
    public static function notifyGlobal($eventName, $settings = array())
    {
        $event = new Event($eventName, $settings);

        foreach (Events::getListeners($eventName) as $listener) {
            $listener->notifyEvent($event);
        }

        return $event;
    }

    // Notification d'un �v�nement � un objet donn�
    // M�me retour que notifyGlobal
    public static function notify(EventListener $listener, $eventName, $settings = array())
    {
        $event = new Event($eventName, $settings);

        if (Events::isRegistered($eventName, $listener)) {
            $listener->notifyEvent($event);
        }

        return $event;
    }

}

// Classe d�crivant un objet pouvant �couter des �v�nements
// Etendre cette classe pour rendre l'objet "�coutant"
// Appeler register() et unregister() pour �couter (ou arr�ter d'�couter) un �v�nement et associer cet �v�nement � un callback
// Appeler notify() pour ex�cuter l'�v�nement �cout�
// Une id�e d'am�lioration : on pourrait �tendre cette classe pour autoriser l'association de plusieurs callbacks � un �v�nement
class EventListener
{

    // Callbacks associ�s aux �v�nements
    protected $callbacks = array();

    // Universal Unique ID
    protected $UUID = null;

    // Retourne un identifiant unique pour l'objet
    public function getUUID()
    {
        if (is_null($this->UUID)) {
            $this->UUID = spl_object_hash($this); // PHP 5.2 required
        }

        return $this->UUID;
    }

    // Enregistre l'�v�nement et lui associe un callback
    public function registerEvent($eventName, $callback)
    {
        if (Events::register($this, $eventName)) {
            $this->callbacks[$eventName] = $callback;

            return true;
        }

        return false;
    }

    // Enregistre l'�v�nement et lui associe un callback
    public function unregisterEvent($eventName, $callback)
    {
        Events::register($this, $eventName);
        unset($this->callbacks[$eventName]);

        return true;
    }

    // Re�oit l'�v�nement, et ex�cute le callback associ�
    // La valeur de retour du callback est stock�e dans la "ReturnValue" de l'�v�nement
    public function notifyEvent(Event $event)
    {
        if (isset($this->callbacks[$event->getName()])) {
            $callback = $this->callbacks[$event->getName()];

            if (!is_callable($callback)) {

                throw new EventCallbackError("Cannot run " . (is_array($callback) ? $callback[0].'::'.$callback[1] : $callback));
            } else {
                $event->setProcessed($this);
                $return = call_user_func($callback, $event);
                $event->setReturnValue($this, $return);
            }
        }
    }

}

// Classe d�crivant un �v�nement
class Event
{

    /* string */ protected $name = '';
    /* array  */ protected $settings = array();
    /* array  */ public $returnValues = array();
    /* array  */ protected $processors = array();

    // Constructeur : nom, param�tres suppl�mentaires
    public function __construct($name, $settings = array())
    {
        $this->name = $name;
        $this->settings = $settings;
    }

    // Nom de l'�v�nement
    public function getName()
    {
        return $this->name;
    }

    // R�cup�re un param�tre
    // Le nom peut �tre une chaine, ou une chaine de la forme "tableau.valeur1.valeur2" pour aller r�cup�rer une valeur
    // de tableaux imbriqu�s (dans l'exemple $settings pourrait �tre array('tableau' => array('valeur1' => array('valeur2' => 'coucou')))
    public function get($name, $default = null)
    {
        $settings = $this->settings;

        while (($pos = strpos($name, '.')) !== false) {
            $index = substr($name, 0, $pos);
            if (isset($settings[$index])) {
                $settings = $settings[$index];
                $name = substr($name, $pos+1);
            } else {
                return $default;
            }
        }

        if (isset($settings[$name])) {

            return $settings[$name];
        }

        return $default;
    }

    // Retourne le nombre de fois que l'�v�nement a �t� trait�s (nombre d'objets l'�coutant)
    public function getProcessed()
    {
        return count($this->processors);
    }

    // Utilis� par l'objet �coutant pour indiquer que l'�v�nement a �t� trait�
    public function setProcessed(EventListener $listener)
    {
        $this->processors[] = $listener;
    }

    // Renvoie la liste des �couteurs qui ont trait� l'�v�nement
    public function getProcessors()
    {
        return $this->processors;
    }

    // D�finit la veleur de retour pour un �couteur donn�
    public function setReturnValue(EventListener $listener, $value)
    {
        $this->returnValues[$listener->getUUID()] = $value;
    }

    // Renvoie la valeur de retour du callback pour un �couteur donn�
    // Si aucun �couteur n'est sp�cifi�, on renvoie la derni�re valeur de retour non null
    public function getReturnValue(EventListener $listener = null)
    {
        if (is_null($listener)) {
            $lastNotNull = null;
            foreach ($this->returnValues as $value) {
                if (!is_null($value)) {
                    $lastNotNull = $value;
                }
            }

            return $lastNotNull;
        } else {

            return $this->returnValues[$listener->getUUID()];
        }
    }

}