Udalosti

Štyri udalosti sú v RoundlyConsulting\Addresses\Events. Každá nesie jednu verejnú vlastnosť $address, používa Dispatchable a SerializesModels a implementuje ShouldDispatchAfterCommit:

use Illuminate\Support\Facades\Event;
use RoundlyConsulting\Addresses\Events\AddressCreated;
use RoundlyConsulting\Addresses\Events\PrimaryAddressChanged;

// e.g. in AppServiceProvider::boot()
Event::listen(function (AddressCreated $event): void {
    $address = $event->address;              // the new Address
    $owner = $event->address->addressable;   // its owner
});

Event::listen(function (PrimaryAddressChanged $event): void {
    // e.g. recalculate shipping for $event->address->addressable
});

Alebo použite samostatnú triedu listenera:

namespace App\Listeners;

use RoundlyConsulting\Addresses\Events\AddressUpdated;

final class RecalculateTaxOnAddressChange
{
    public function handle(AddressUpdated $event): void
    {
        $owner = $event->address->addressable;
        // recalculate tax for $owner
    }
}

Až po commite

Mimo transakcie sa udalosť odošle hneď po zápise. Vnútri transakcie vašej aplikácie počká na commit, v poradí, v akom zápisy prebehli, a rollback ju zahodí — listener tak nikdy nezareaguje na adresu, ktorá sa nikdy neuložila, ani na úpravu či zmazanie, ktoré sa vrátili späť:

use Illuminate\Support\Facades\DB;
use RoundlyConsulting\Addresses\Facades\Addresses;

DB::transaction(function () use ($customer, $data, $order): void {
    Addresses::for($customer)->add($data);   // AddressCreated is held back…
    $order->save();
});                                          // …and dispatched here, once committed

Event::fake() zaznamená odoslanie okamžite, takže toto odloženie neukáže; overte ho skutočným listenerom cez Event::listen a transakciou.

Čo udalosti neodošle

• Priame zápisy cez Eloquent — $customer->addresses()->create([...]), $address->update([...]) — ani factories neodošlú AddressCreated ani AddressUpdated.
• Hromadné mazanie dopytom, napríklad $customer->addresses()->delete(), neodošle AddressDeleted.
• Povýšenie alebo opätovné uloženie adresy, ktorá už primárna je, neodošle PrimaryAddressChanged — pozrite Primárne adresy.
• Obnovenie, po ktorom sa adresa vráti ako bežná, lebo miesto medzitým obsadila iná primárna, neodošle PrimaryAddressChanged a restoreQuietly() neodošle nič.

Keďže udalosti používajú SerializesModels, listenery vo fronte dostanú Address znova načítanú z databázy.