interface event_service_interface

Contract for the event service responsible for emitting item lifecycle events.

Implementations of this interface MUST:

  • Never throw exceptions that could interrupt CRUD operations
  • Execute in a fire-and-forget or best-effort manner
  • Contain no business logic; only event dispatching or logging

Methods

void
item_created(item_interface $item)

Fired after an item is successfully created.

void
item_updated(item_interface $old, item_interface $new)

Fired after an item is successfully updated.

void
item_deleted(int $id)

Fired after an item is successfully deleted.

Details

at line 37
void item_created(item_interface $item)

Fired after an item is successfully created.

Parameters

item_interface $item

the created item with full entity data

Return Value

void

at line 47
void item_updated(item_interface $old, item_interface $new)

Fired after an item is successfully updated.

Requires both OLD and NEW states to calculate differences (Diffs).

Parameters

item_interface $old

State before update

item_interface $new

State after update

Return Value

void

at line 54
void item_deleted(int $id)

Fired after an item is successfully deleted.

Parameters

int $id

the ID of the deleted item

Return Value

void