Dispatcher.php

TLDR

The Dispatcher.php file in the Illuminate\Contracts\Events namespace defines the Dispatcher interface. This interface provides methods for registering event listeners, determining if an event has listeners, dispatching events, and managing queued events.

Methods

listen

Register an event listener with the dispatcher.

hasListeners

Determine if a given event has listeners.

subscribe

Register an event subscriber with the dispatcher.

until

Dispatch an event until the first non-null response is returned.

dispatch

Dispatch an event and call the listeners.

push

Register an event and payload to be fired later.

flush

Flush a set of pushed events.

forget

Remove a set of listeners from the dispatcher.

forgetPushed

Forget all of the queued listeners.

<?php

namespace Illuminate\Contracts\Events;

interface Dispatcher
{
    /**
     * Register an event listener with the dispatcher.
     *
     * @param  \Closure|string|array  $events
     * @param  \Closure|string|array|null  $listener
     * @return void
     */
    public function listen($events, $listener = null);

    /**
     * Determine if a given event has listeners.
     *
     * @param  string  $eventName
     * @return bool
     */
    public function hasListeners($eventName);

    /**
     * Register an event subscriber with the dispatcher.
     *
     * @param  object|string  $subscriber
     * @return void
     */
    public function subscribe($subscriber);

    /**
     * Dispatch an event until the first non-null response is returned.
     *
     * @param  string|object  $event
     * @param  mixed  $payload
     * @return mixed
     */
    public function until($event, $payload = []);

    /**
     * Dispatch an event and call the listeners.
     *
     * @param  string|object  $event
     * @param  mixed  $payload
     * @param  bool  $halt
     * @return array|null
     */
    public function dispatch($event, $payload = [], $halt = false);

    /**
     * Register an event and payload to be fired later.
     *
     * @param  string  $event
     * @param  array  $payload
     * @return void
     */
    public function push($event, $payload = []);

    /**
     * Flush a set of pushed events.
     *
     * @param  string  $event
     * @return void
     */
    public function flush($event);

    /**
     * Remove a set of listeners from the dispatcher.
     *
     * @param  string  $event
     * @return void
     */
    public function forget($event);

    /**
     * Forget all of the queued listeners.
     *
     * @return void
     */
    public function forgetPushed();
}