maslosoft/signals

Wireless Cross-Component Communication

4.0.1 2022-05-20 12:21 UTC

Requires

• php: >=7.4
• maslosoft/addendum: ^7
• maslosoft/cli-shared: ^1 | ^2
• maslosoft/embedi: ^2
• psr/log: ^1|^2|^3
• symfony/console: >=2.7 <5.0

Requires (Dev)

• codeception/codeception: ^4
• codeception/module-asserts: ^2
• codeception/specify: ^2
• maslosoft/hedron: ^1 | ^2
• maslosoft/sitcom: ^1 | ^2
• maslosoft/zamm: ^1 | ^2

AGPL-3.0-only, proprietary

• Peter Maselkowski

• event
• signal
• events
• signals
• slot
• slots

README

Wireless Cross-Component Communication

[](https://scrutinizer-ci.com/g/Maslosoft/Signals/?branch=master) [](https://scrutinizer-ci.com/g/Maslosoft/Signals/?branch=master)

Quick Install

composer require maslosoft/signals

Wireless cross-component communication

This component allows for interaction of application components, without prior or explicit assignment.

Setup

Use composer to install

composer require maslosoft/signals:"*"

Or by hard way, download somewhere in your project and ensure autoloading works for Maslosoft\Signals\* and you include dep too;

Setup signals. After calling init any further instance will be configured same as below $signal.

$signal = new Maslosoft\Signals\Signal();
$signal->runtimePath = RUNTIME_PATH;
$signal->paths = [
	MODELS_PATH
];
$signal->init();

Generate signals definition, only once, hook it to your build script etc.

$signal = new Maslosoft\Signals\Signal();
(new Maslosoft\Signals\Utility($signal))->generate();

Usage

Emiting signal

Define signal:

namespace MyNamespace\Signals;

class AccountMenuItems extends AdminMenuItems
{
	public $item = [];
}

Define class with slot with @SlotFor annotation

namespace Maslosoft\Ilmatar\Modules;

class MyModule
{
	/**
	 * @SlotFor(MyNamespace\Signals\AccountMenuItems)
	 */
	public function reactOnAccountMenu(MyNamespace\Signals\AccountMenuItems $signal)
	{
		$signal->item = [
			'url' => '/content/myBlog',
			'label' => 'My blog'
		];
	}
}

Emit signal and get results of this call:

$signal = new Maslosoft\Signals\Signal();
$result = $signal->emit(new AdminMenuItems());

echo $result[0]->item[0]['label']; // My blog

Gathering signals