webware / traccio

1.1.0 2026-10-22 04:02 UTC

Requires

• php: ~8.4.1 || ~8.5.0
• tracy/tracy: ^2.11.0

Requires (Dev)

• ext-pdo: *
• ext-pdo_sqlite: *
• infection/infection: ^0.35.0
• laminas/laminas-diactoros: ^3.8
• mezzio/mezzio: ^3.26
• php-db/phpdb-sqlite: ^0.2.0
• phpbench/phpbench: ^1.7
• phpunit/phpunit: ^13.3.0
• roave/backward-compatibility-check: ^8.21.0
• roave/security-advisories: dev-master
• webware/webware-tools: ^1.0.0-rc.7

BSD-3-Clause

• Joey Smith

• webware
• webware traccio

Published on Packagist.org on 2026-10-22 04:04 UTC

README

Tracy Debugger integration and profiler for Mezzio applications.

Traccio wires Tracy into a Mezzio middleware pipeline and provides purpose-built debug bar panels for configuration, routes, HTTP requests, and SQL query profiling.

Documentation

• v1 documentation
  • Getting Started
  • Configuration

Requirements

Requirement	Version
PHP	~8.2 || ~8.3 || ~8.4 || ~8.5
tracy/tracy	^2.11
mezzio/mezzio	^3.26 (host app)

Database profiling additionally requires a PhpDb adapter and the php-db/phpdb package.

Quick start

1. Install

composer require webware/traccio

2. Register the ConfigProvider

The laminas-component-installer plugin offers to do this for you.

// config/config.php
use Laminas\ConfigAggregator\ConfigAggregator;
use Webware\Traccio\ConfigProvider;

$aggregator = new ConfigAggregator([
    ConfigProvider::class,
    // ... other providers
]);

3. Enable debug

// config/autoload/traccio.global.php
use Tracy\Debugger;

return [
    'debug'         => true,
    Debugger::class => [
        'enable' => Debugger::Development,
    ],
];

4. Pipe the middleware

// config/pipeline.php
use Webware\Traccio\Http\Middleware\TracyDebuggerMiddleware;

$app->pipe(TracyDebuggerMiddleware::class);

Pipe it first, so Tracy is initialised before your application runs. Panels appear automatically when their dependencies are present in the container.

Panels

Panel	Bar label	Requires
ConfigPanel	Config	nothing
RoutesPanel	Routes	Mezzio\Router\RouteCollectorInterface
SqlProfilerPanel	Database	PhpDb\Adapter\Profiler\ProfilerInterface
RequestPanel	Request	RequestPanelMiddleware piped late

See Configuration for every option, the full Tracy property list, and database profiling setup.

License

BSD-3-Clause. See LICENSE for details.