Debug listeners

Last updated:
Edit on GitHub

The document provides information on the event:trigger:listener command.

What does the command do?

The command debugs an event message with a specific listener mapped to it.

Where is the command used?

Upon triggering the publish process, an event or events are posted to the event queue. Each event message posted to the queue contains the following information about the event that triggered it: event name, ID, names of the corresponding listeners and transfer classes, list of modified columns, as well as foreign keys necessary to backtrack the updated Propel entities. However, it does not contain the actual data that has changed, making it hard to debug the issue when the transformed data is not stored in the specific storage table. In this case, you need to debug the event message with a specific event listener mapped to it using the event:trigger:listener command.

How to use the command

To debug an event message with a specific listener mapped to it, use the vendor/bin/console event:trigger:listener command with the following parameters:

PARAMETER NAME TRANSCRIPTION
Event listener name Defines the listener name.
Data Data for filling up the event and entity transfer—for example, id=1.
Input format Defines the input format. The default format is querystring.
Event name Defines the event name to be triggered.

Usage examples

// Triggers ProductAbstractStoragePublishListener for the product abstract with ID equal to 1.
vendor/bin/console event:trigger:listener 'Spryker\\Zed\\ProductStorage\\Communication\\Plugin\\Event\\Listener\\ProductAbstractStoragePublishListener' id=1

// Triggers ProductAbstractStoragePublishListener for the product abstract with {additional data} and ID equal to 1.
vendor/bin/console event:trigger:listener 'Spryker\\Zed\\ProductStorage\\Communication\\Plugin\\Event\\Listener\\ProductAbstractStoragePublishListener' id=1{additional data}

// Triggers ProductAbstractStoragePublishListener for the product abstract with ID equal to 1. The output is in JSON.
vendor/bin/console event:trigger:listener 'Spryker\\Zed\\ProductStorage\\Communication\\Plugin\\Event\\Listener\\ProductAbstractStoragePublishListener' {\"id\":1} -f json

// Triggers ProductAbstractStoragePublishListener for the product abstract with the  PRODUCT_ABSTRACT_PUBLISH event name and ID equal to 1. The output is in JSON.
vendor/bin/console event:trigger:listener 'Spryker\\Zed\\ProductStorage\\Communication\\Plugin\\Event\\Listener\\ProductAbstractStoragePublishListener' {\"id\":1} -f json -e PRODUCT_ABSTRACT_PUBLISH