Step 10 — Middleware

When Alex reports a bug, support needs one request ID across logs and curl output.

What you will learn#

• Generate middleware with make:middleware
• Register in [app_middlewares]
• See X-Request-Id on responses

Generate middleware#

php pionia make:middleware RequestId

Copy the class entry from environment/generated.ini into environment/settings.ini:

[app_middlewares]
request_id = Application\Middlewares\RequestIdMiddleware

Verify header#

curl -sI -X POST http://127.0.0.1:8000/api/v1/ \
  -H "Content-Type: application/json" \
  -d '{"service":"task","action":"list"}' | grep -i x-request-id

Deep dive: Middleware guide.

Common mistakes#

• Middleware only in generated.ini — copy to settings.ini for all environments.
• Using middleware for auth — use mustAuthenticate() on services instead.