konradmichalik / typo3-dump-server
This extension brings the Symfony Var Dump Server to TYPO3.
Package info
github.com/konradmichalik/typo3-dump-server
Type:typo3-cms-extension
pkg:composer/konradmichalik/typo3-dump-server
Requires
- php: ~8.2.0 || ~8.3.0 || ~8.4.0 || ~8.5.0
- ext-mbstring: *
- psr/event-dispatcher: ^1.0
- symfony/console: ^5.4 || ^6.4 || ^7.0 || ^8.0
- symfony/var-dumper: ^5.0 || ^6.0 || ^7.0 || ^8.0
- typo3/cms-core: ^11.5 || ^12.4 || ^13.4 || ^14.0
- typo3fluid/fluid: ^2.15 || ^4.2 || ^5.0
Requires (Dev)
- eliashaeussler/typo3-vendor-bundler: ^4.1.1
- eliashaeussler/version-bumper: ^2.4 || ^3.0 || ^4.0
- konradmichalik/ttt: ^0.4.0
- phpunit/phpunit: ^10.2 || ^11.0 || ^12.0 || ^13.0
- typo3/cms-base-distribution: ^11.5 || ^12.4 || ^13.4 || ^14.0
- typo3/cms-lowlevel: ^11.5 || ^12.4 || ^13.4 || ^14.0
Suggests
None
Provides
None
Conflicts
None
Replaces
None
- dev-main
- 1.0.0
- 0.8.0
- 0.7.1
- 0.7.0
- 0.6.0
- 0.5.1
- 0.5.0
- 0.4.0
- 0.3.0
- 0.2.0
- 0.1.0
- dev-test/raise-coverage-to-100-percent
- dev-docs/restructure-readme-docs
- dev-feat/agent-readable-dump-output
- dev-chore/bump-reusable-workflows-0.1.0
- dev-chore/pin-reusable-workflows-0.0.1
- dev-chore/update-ddev-typo3-multi-version-addon
- dev-chore/pin-type-coverage-php82-compat
- dev-docs/fix-coverage-badge
- dev-feature/vendor-bundler-classic-mode
- dev-feature/ttt-integration
- dev-maintenance
- dev-feature/pcov-full-coverage
- dev-fix/guard-dump-event-dispatch
- dev-docs/dump-server-security-notes
- dev-fix/html-descriptor-link-scheme-validation
- dev-perf/lazy-dump-server-probe
- dev-fix/ide-link-path-mapping
- dev-chore/ci-security-hardening
- dev-chore/static-typo3-support-badges
- dev-docs/update-security-policy
- dev-chore/remove-typo3-console-dependency
- dev-replace-extension-icon
- dev-chore/update-typo3-14-test-version
- dev-chore/php-platform-constraint
- dev-docs/development-guide
- dev-chore/copyright-2026
- dev-feature/typo3-context-provider
- dev-feature/ide-deep-links
- dev-refactor-local-setup
- dev-add-support-symfony-8
- dev-add-support-typo3-14
- dev-add-support-php-85
- dev-refactor-cgl
- dev-drop-php-81
- dev-change-github-username
- dev-fix-ter-upload
- dev-ext-emconf-strict
- dev-security
- dev-workflow-release
- dev-adjust-php-cs-fixer-configuration
This package is auto-updated.
Last update: 2026-09-19 08:22:25 UTC
README
TYPO3 extension typo3_dump_server
This extension brings the Symfony Var Dump Server to TYPO3.
Note
This package is an alternative approach to the default TYPO3 debugging methods or the universal use of xdebug.
The dump server gathers all dump call outputs, e.g. for preventing interference with HTTP or API responses.
✨ Features
- Dump server collecting
dump()output outside the HTTP/API response - IDE deep links — click a source path to open it in your editor
- Output formats —
cli,html, andjson(NDJSON), including AI-agent consumption - PSR-14 events — react to dumps programmatically
- Extension configuration — suppress frontend output when no server is running
🔥 Installation
Requirements
- TYPO3 >= 11.5
- PHP 8.2+
Composer
composer require --dev konradmichalik/typo3-dump-server
TER
Download the zip file from TYPO3 extension repository (TER).
🚀 Quick start
Start the dump server, then call dump() anywhere in your TYPO3 code. Output appears in the terminal instead of the frontend response.
vendor/bin/typo3 server:dump
dump($variable);
Warning
The dump server protocol is unauthenticated and unencrypted, and dumps often contain sensitive data (credentials, session data, personal data). Keep the server bound to a loopback address (127.0.0.1) — never expose it via 0.0.0.0 or a public interface. Install the extension as a dev dependency (composer require --dev), and make sure production deployments run composer install --no-dev (or an equivalent process that excludes dev dependencies) so it is not deployed to production systems.
⚡ Usage
Console command
Use the format option to change the output format to html:
vendor/bin/typo3 server:dump --format=html > dump.html
Note
The dump server will be available at tcp://127.0.0.1:9912 by default. Use the environment variable TYPO3_DUMP_SERVER_HOST to change the host.
TYPO3 context
The dump server automatically displays the TYPO3 version and application context (e.g. Development, Production) alongside each dump output.
Dump function
Use the dump function in your code:
dump($variable); // or \Symfony\Component\VarDumper::dump($variable);
ViewHelper
Use the symfony:dump ViewHelper in your Fluid templates:
<html xmlns:symfony="http://typo3.org/ns/KonradMichalik/Typo3DumpServer/ViewHelpers"> <symfony:dump>{variable}</symfony:dump>
📚 Documentation
| Page | What's inside |
|---|---|
| Output formats | cli, html, and json (NDJSON) output, plus the file sink for reading dumps without a running server, so agents can consume them |
| IDE deep links | Clickable source links in dump output, built-in IDEs and custom URL patterns |
| Extension configuration | Suppressing frontend dump output when no server is running |
| Events | Handling dumps programmatically via the PSR-14 DumpEvent |
| Development & feature testing | Manual QA checklist for contributors, covering every feature above |
🧑💻 Contributing
Please have a look at CONTRIBUTING.md.
💎 Credits
This project is highly inspired by the laravel-dump-server & the symfony var-dumper component itself.
⭐ License
This project is licensed under GNU General Public License 2.0 (or later).


