How do I access a specific header in an Ecotone handler?

You can use the #[Header('name')] attribute on a specific method parameter to inject a single header value, or use the #[Headers] attribute to inject the entire metadata array.

Can I modify message headers using interceptors?

Yes, by setting 'changeHeaders: true' on #[Before], #[After], or #[Presend] interceptors, you can return an array of headers that will be merged into the message metadata.

How can I verify metadata in my unit tests?

When using EcotoneLite for testing, you can use methods like getRecordedEventHeaders() or getRecordedCommandHeaders() to verify that specific metadata was correctly attached to messages.

Do headers propagate automatically from commands to events?

Yes, Ecotone automatically propagates userland/custom headers (like userId or tenantId) from commands to resulting events, ensuring context is preserved across the flow.

Ecotone Message Metadata

Name: Ecotone Message Metadata
Author: ecotoneframework

byecotoneframework

•

API Development

Manages and propagates message metadata and headers within PHP applications using the Ecotone Framework.

This skill enables Claude to implement and manage complex message metadata (headers) patterns within the Ecotone Framework ecosystem. It provides expert guidance on reading headers using attributes like #[Header], enriching messages with declarative attributes, and utilizing automatic propagation of userland headers from commands to events. It is particularly useful for developers building event-driven systems that require consistent handling of cross-cutting concerns such as multi-tenancy, authentication context, and audit trails across message boundaries.

Key Features

01Declarative metadata access using #[Header] and #[Headers] attributes

02Dynamic header enrichment via Before, After, and Presend interceptors

03Automated propagation of custom headers from commands to subsequent events

0452 GitHub stars

05Comprehensive testing patterns for metadata verification with EcotoneLite

06Convention-based header resolution for cleaner handler signatures

Use Cases

01Implementing multi-tenancy by propagating tenant identifiers across all system messages

02Enriching outgoing messages with security tokens or correlation IDs via interceptors

03Tracking user context and session data for audit logging in event-driven architectures

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add ecotoneframework/ecotone-dev ecotone-metadata

For use in Claude.ai and ChatGPT

Download Skill