cgoit/contao-additional-header-logging-bundle

Extends the Contao log by adding configurable HTTP request headers for debugging and analysis.

1.0.0 2026-04-21 14:12 UTC

Requires

• php: ^8.3
• contao/core-bundle: ^5.7
• monolog/monolog: ^3.0
• symfony/config: ^7.2
• symfony/dependency-injection: ^7.2
• symfony/event-dispatcher: ^7.2
• symfony/http-foundation: ^7.2
• symfony/http-kernel: ^7.2

Requires (Dev)

• contao/manager-plugin: ^2.0
• terminal42/contao-build-tools: dev-main

Conflicts

• contao/manager-plugin: <2.0 || >=3.0

LGPL-3.0-or-later

• Carsten Götzinger

README

Do you need more insight into incoming requests in your Contao application? Are you missing specific HTTP headers in your logs for debugging, analytics or security purposes?

This bundle allows you to configure a list of HTTP headers that will be logged in addition to the default Contao log information.

Define the headers you are interested in, and they will automatically be included in your Contao log entries.

Typical use cases include:

• Debugging reverse proxy or CDN setups (e.g. X-Forwarded-For, X-Real-IP)
• Tracking custom application headers
• Inspecting authentication or API-related headers
• Security analysis and request tracing

Install

composer require cgoit/contao-additional-header-logging-bundle

Configuration

Configure the headers under Settings in your Contao Backend.

Notes

• Header names are case-insensitive.
• Only headers present in the request will be logged.
• Be careful when logging sensitive headers (e.g. authentication tokens).