https://github.com/cakephp/event

[READ-ONLY] The event dispatcher library for CakePHP. This repo is a split of the main code that can be found in https://github.com/cakephp/cakephp
https://github.com/cakephp/event

Last synced: about 2 months ago
JSON representation

[READ-ONLY] The event dispatcher library for CakePHP. This repo is a split of the main code that can be found in https://github.com/cakephp/cakephp

• Host: GitHub
• URL: https://github.com/cakephp/event
• Owner: cakephp
• License: other
• Created: 2014-08-24T17:35:29.000Z (almost 10 years ago)
• Default Branch: master
• Last Pushed: 2024-04-28T02:59:52.000Z (about 2 months ago)
• Last Synced: 2024-05-04T06:21:04.764Z (about 2 months ago)
• Language: PHP
• Homepage:
• Size: 191 KB
• Stars: 22
• Watchers: 27
• Forks: 6
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.txt

Lists

• awesome-php - CakePHP Event - An event dispatcher library. (Table of Contents / Event)
• awesome-projects - CakePHP Event - An event dispatcher library. (PHP / Event)
• awesome-php-zh_CN - Cake Event - 一个事件调度的库 (CP) (事件 Event)
• awesome-php - Cake Event - 一个事件调度类库 (事件( Event ))
• awesome-php - Cake Event - 一个事件调度类库 (事件( Event ))
• awesome-php - Cake Event - An event dispatcher library (CP). (Event)
• awesome-php - CakePHP Event - An event dispatcher library. (Table of Contents / Event)
• awesome-php - Cake Event - 一个事件调度类库 (URL)
• awesome-php-new - CakePHP Event - An event dispatcher library. (Table of Contents / Event)
• awesome-php - Cake Event - An event dispatcher library (CP). (Event)
• awesome-php - CakePHP Event - An event dispatcher library. (Table of Contents / Event)
• awesome-php - CakePHP Event - An event dispatcher library. (Table of Contents / Event)
• awesome-stripe - CakePHP Event - An event dispatcher library. (Table of Contents / Event)
• PHP_awesome-directus-duh-REKT-iss- - CakePHP Event - An event dispatcher library. (Table of Contents / Event)
• awesome-php - CakePHP Event - An event dispatcher library. (Table of Contents / Event)
• awesome-php - CakePHP Event - An event dispatcher library. (Table of Contents / Event)
• awesome-php - CakePHP Event - An event dispatcher library. (Table of Contents / Event)
• awesome-php-cn - CakePHP Event - 事件调度程序库. (目录 / 事件 Event)

README

        
[![Total Downloads](https://img.shields.io/packagist/dt/cakephp/event.svg?style=flat-square)](https://packagist.org/packages/cakephp/event)

[![License](https://img.shields.io/badge/license-MIT-blue.svg?style=flat-square)](LICENSE.txt)

# CakePHP Event Library

This library emulates several aspects of how events are triggered and managed in popular JavaScript

libraries such as jQuery: An event object is dispatched to all listeners. The event object holds information

about the event, and provides the ability to stop event propagation at any point.

Listeners can register themselves or can delegate this task to other objects and have the chance to alter the

state and the event itself for the rest of the callbacks.

## Usage

Listeners need to be registered into a manager and events can then be triggered so that listeners can be informed

of the action.

```php

use Cake\Event\Event;

use Cake\Event\EventDispatcherTrait;

class Orders

{

	use EventDispatcherTrait;

	public function placeOrder($order)

	{

		$this->doStuff();

		$event = new Event('Orders.afterPlace', $this, [

			'order' => $order

		]);

		$this->getEventManager()->dispatch($event);

	}

}

$orders = new Orders();

$orders->getEventManager()->on(function ($event) {

	// Do something after the order was placed

	...

}, 'Orders.afterPlace');

$orders->placeOrder($order);

```

The above code allows you to easily notify the other parts of the application that an order has been created.

You can then do tasks like send email notifications, update stock, log relevant statistics and other tasks

in separate objects that focus on those concerns.

## Documentation

Please make sure you check the [official documentation](https://book.cakephp.org/4/en/core-libraries/events.html)