README

Uma implementação simples de gerenciamento de eventos baseada no padrão Observer, permitindo registrar eventos, adicionar/remover observadores e notificar listeners de forma desacoplada.

🚀 Visão Geral

A classe EventManager fornece uma estrutura estática para:

• Registrar eventos
• Associar observadores a eventos
• Notificar observadores quando um evento ocorre
• Gerenciar o ciclo de vida dos observers

Ela depende da classe Observers, responsável por armazenar e executar os observadores.

🧠 Conceitos

• Evento: Identificado por um nome (string)
• Observer (Observador): Um objeto que contém um método com o mesmo nome do evento
• Notificação: Execução dos métodos dos observadores registrados

📚 Métodos

add($name, $observer = null)

Registra um novo evento ou adiciona um observador a um evento existente.

EventManager::add('onUserCreate', $observer);

• $name: Nome do evento
• $observer: Objeto com método correspondente ao evento

retrieve($event)

Retorna o objeto do evento registrado.

$event = EventManager::retrieve('onUserCreate');

exists($event)

Verifica se o evento existe.

EventManager::exists('onUserCreate'); // true ou false

attach($event, $observer)

Adiciona um observador a um evento existente.

EventManager::attach('onUserCreate', $observer);

deattach($event, $index)

Remove um observador de um evento.

EventManager::deattach('onUserCreate', 'ObserverClassName');

notify($event, &$paramn)

Notifica todos os observadores do evento.

EventManager::notify('onUserCreate', $data);

• $paramn deve ser um objeto (passado por referência)

clear($event)

Remove todos os observadores de um evento.

EventManager::clear('onUserCreate');

keys($event)

Lista os observadores registrados no evento.

$list = EventManager::keysObservers('onUserCreate');

🧩 Exemplo de Uso

class UserObserver {
    public function onUserCreate($data) {
        echo "Usuário criado: " . $data->name;
    }
}

// Criar observer
$observer = new UserObserver();

// Registrar evento + observer
EventManager::add('onUserCreate', $observer);

// Disparar evento
$data = (object)['name' => 'João'];
EventManager::notify('onUserCreate', $data);

⚠️ Regras Importantes

• O observer deve ser um objeto
• O observer deve possuir um método com o mesmo nome do evento
• O parâmetro passado em notify deve ser um objeto
• Eventos são armazenados estaticamente (escopo global da aplicação)

🏗️ Estrutura Interna

• EventManager::$events: Array estático que armazena os eventos
• Cada evento é uma instância da classe Observers

📌 Possíveis Melhorias

• Suporte a closures/callbacks
• Namespaces mais desacoplados
• Tratamento de exceções mais granular
• Logs de execução

📄 Licença

A Licença Apache 2.0 é uma licença de software de código aberto permissiva e popular. Ela permite o uso, modificação, distribuição e comercialização do software, inclusive em projetos fechados, desde que mantenha os créditos de autoria, inclua uma cópia da licença e relate as alterações feitas…