Event DI Extension feature

Zdravím všechny,

v době, kdy jsem přecházel na Nette 3, jsem hledal náhradu za Kdyby/Events, bez nutnosti instalovat půlku Symfony a k tomu nainstalovat knihovny, které počítají trajektorii na Mars a následně spustí jeho teraformaci. Ti co používají NPM vědí o čem mluvím.

Přemýšlím, že bych se podělil o své řešení, které by bylo fajn přímo v Nette pro všechny. Proto od vás chci vědět, jestli se taková funkce bude líbit a jestli mám připravit pull request do Nette. Zbytečně se mi to dělat nechce.

Moje motivace je použít pouze nativní součásti Nette:

• DI Extension
• Eventy nad SmartObject

Dost často je potřeba udělat nějakou akci (poslat SMS, email…), když se stane jiná (registrace, změna hesla…) a předávat do registrace mailer a SMS sender je poměrně nepraktické, protože pak něco takového testovat je problém.

<?php declare(strict_types=1);

class Registration
{
	use Nette\SmartObject;

	/** @var callable[] */
	public array $onRegister = [];

	public function register(... $data): void
	{
		/** ... */

		$this->onRegister($data);
	{
}

To dost často spousta lidí napojí někde v presenteru na nějakou closure nebo to předeleguje jinam, což asi úplně blbě není, ale dost to znepřehlední Presenter/Component a stejně ty závislosti musím někde vzít.

Na toto se hodí návrhový vzor Producer/Consumer. Producer už máme výše a chtěli bychom vytvořit i consumer.

<?php declare(strict_types=1);

class ProjectMailer
{
	use Nette\SmartObject;

	private Nette\Mail\Mailer $mailer;


	public function __construct(Nette\Mail\Mailer $mailer)
	{
		$this->mailer = $mailer;
	}


	public function sendRegistrationMail(array $data): void
	{
		$message = new Nette\Mail\Message(...$data);

		$this->mailer->send(message);
	}


	public function sendSupportMail(string $email, string $name, array $data): void
	{
		$message = new Nette\Mail\Message(...$data);

		$this->mailer->send(message);
	}
}

Tento kód je dobře samostatně testovatelný, čitelný a mohu na jednu událost do šířky připojovat další akce (poslat SMS, zalogovat, spočítat statistiky…), které mohou mít vlastní třídu přímo s jednou odpovědností.

Jak to propojit?

Myslím, že by se o to mohl v klidu postarat DI kontejner.

events:
	listeners:
		project_mailer:
			create: ProjectMailer
			events:
				Registration::onRegister: sendRegistrationMail
				SupportForm::onConfirm: sendSupportMail

Takto vypadá konfigurace DI extension, která by vše spojila pouze na vygenerovaném DI kontejneru. Vše je samozřejmě lazy. Eventy do Registration se přidají až v době, kdy se Registration vytváří a ProjectMailer se vytváří až v momentě zavoláním eventu.

• Co si to tom myslíte? – @DavidGrudl
• Má smysl tuto funkci přidat nativně do Nette?
• Mám připravit pull request?
• V jakém balíčku (DI, Application, Utils…) by tato funkce měla být?

Editoval Lukes (4. 3. 2020 19:20)