flightphp/tracy-extensions

A few Flight specific extensions for Tracy Debugger to help debug your code quickly.

v0.2.8 2026-06-13 20:21 UTC

Requires

• php: >=8.0
• flightphp/core: ^3.18.0
• tracy/tracy: ^2.10

Requires (Dev)

• ghostff/session: ^2.1
• phpunit/phpunit: ^9.6

MIT

• n0nag0n

README

This is a set of extensions to make working with Flight a little richer.

• Flight - Analyze all Flight variables.
• Database - Analyze all queries that have run on the page (if you correctly initiate the database connection)
• Request - Analyze all $_SERVER variables and examine all global payloads ($_GET, $_POST, $_FILES)
• Session - Analyze all $_SESSION variables if sessions are active.

This is the Panel

And each panel displays very helpful information about your application!

Installation

Run composer require flightphp/tracy-extensions --dev and you're on your way!

Configuration

There is very little configuration you need to do to get this started. You will need to initiate the Tracy debugger prior to using this https://tracy.nette.org/en/guide:

<?php

use Tracy\Debugger;
use flight\debug\tracy\TracyExtensionLoader;

// bootstrap code
require __DIR__ . '/vendor/autoload.php';

Debugger::enable();
// You may need to specify your environment with Debugger::enable(Debugger::DEVELOPMENT)

// if you use database connections in your app, there is a 
// required PDO wrapper to use ONLY IN DEVELOPMENT (not production please!)
// PdoQueryCapture extends Flight's SimplePdo (recommended) so you get all the
// helper methods (fetchAll, insert, update, etc) + automatic query capture for Tracy.
// It has a constructor compatible with PDO/SimplePdo.
$pdo = new PdoQueryCapture('sqlite:test.db', 'user', 'pass');
// or if you attach this to the Flight framework
Flight::register('db', PdoQueryCapture::class, ['sqlite:test.db', 'user', 'pass']);
// now whenever you make a query (via any method) it will capture the time, query, and parameters

// For full APM query tracking (beyond Tracy), install flightphp/apm and use:
// $db->logQueries() or enable via options; it fires the 'flight.db.queries' event.

// This connects the dots
if(Debugger::$showBar === true) {
	new TracyExtensionLoader(Flight::app());
}

// more code

Flight::start();