ryanhellyer/production-stats

Production-ready performance monitoring for Laravel and Symfony - automatically track and inject performance statistics into HTML responses.

2.0.1 2026-07-21 16:00 UTC

Requires

• php: ^8.2
• symfony/http-foundation: ^6.0|^7.0

Requires (Dev)

• illuminate/http: ^10.0|^11.0|^12.0|^13.0
• illuminate/support: ^10.0|^11.0|^12.0|^13.0
• phpcsstandards/php_codesniffer: ^3.13|^4.0
• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.5|^12.5
• symfony/config: ^6.0|^7.0
• symfony/dependency-injection: ^6.0|^7.0
• symfony/event-dispatcher: ^6.0|^7.0
• symfony/http-kernel: ^6.0|^7.0
• symfony/yaml: ^6.0|^7.0

Suggests

• illuminate/http: Required for Laravel integration (auto-installed with Laravel)
• symfony/config: Required for Symfony integration (auto-installed with Symfony)
• symfony/dependency-injection: Required for Symfony integration (auto-installed with Symfony)
• symfony/http-kernel: Required for Symfony integration (auto-installed with Symfony)

Replaces

• ryanhellyer/laravel-production-stats: 2.0.1

GPL-2.0

• Ryan Hellyer

• symfony
• performance
• monitoring
• stats
• laravel
• production
• load-time

Published on Packagist.org on 2026-07-21 16:00 UTC

README

Production-ready performance monitoring for Laravel and Symfony applications. Automatically injects performance statistics as HTML comments—lightweight, secure, and production-safe.

For years I've added basic performance stats to WordPress sites as HTML comments in the footer. They're always available in the HTML source, don't bother users, and help determine if a site is cached and how quickly pages generate. When I moved to Laravel, I missed this functionality and kept manually adding stats to templates. This package automates that process.

Note: While this package injects into your pages, is typically not sensitive information, you shouldn't use this package if you don't want site visitors being able to see this data.

Features

• Automatic tracking - Measures page load time and generation timestamp
• Production-ready - Unlike development-only tools, safe for production use
• Non-intrusive - Injects as HTML comments, invisible to end users
• Safe - Only processes HTML responses, won't break JSON/XML
• Zero configuration - Works immediately after installation

Requirements

• PHP 8.2+
• Laravel 10+ or Symfony 6+

Installation

composer require ryanhellyer/production-stats

Laravel

No further steps needed—the package auto-discovers and registers itself.

Symfony

Register the bundle in config/bundles.php:

return [
    // ...
    RyanHellyer\ProductionStats\Symfony\ProductionStatsBundle::class => ['all' => true],
];

Usage

No configuration needed. The package automatically tracks page load times and generation timestamps, injecting them as HTML comments before the closing </body> tag.

Example Output

<!-- Page generated in 42 ms at 2025-12-12 14:43:42 -->
</body>

View in your browser's page source.

Testing

Run the test suite with:

composer test           # all tests
composer test-core      # core logic only (no framework deps needed)
composer test-laravel   # Laravel adapter tests
composer test-symfony   # Symfony adapter tests

What Gets Tracked

• Page load time - Time to render from Laravel bootstrap to response (milliseconds)
• Generation timestamp - When the page was generated

Changelog

2.0.1 — 2026-07-20

• Minor documentation upgrades

2.0 — 2026-07-20

• Added Symfony support via event subscriber and bundle
• Extracted shared injection logic into framework-agnostic Core\HtmlResponseInjector
• Moved Laravel adapter to Laravel\ namespace with backward-compatibility stub
• Added test-core, test-laravel, test-symfony test suites
• Framework dependencies moved to suggest; symfony/http-foundation is sole hard requirement

1.1.1 — 2026-05-17

• Fixed composer.json dependencies and description punctuation

1.1 — 2025-12-07

• Added PHPStan static analysis and fixed type issues
• Added PHP CodeSniffer and fixed code style
• Removed composer.lock from version tracking
• Added test script and documentation
• Added .gitignore
• Added PHPUnit tests

1.0 — 2025-12-07

• Initial package release
• Automatic page load time tracking
• Generation timestamp display

License

GPL-2.0 - See LICENSE file for details.

Author

Ryan Hellyer - [e-mail] | GitHub

Support

Ping me via ryan.hellyer.kiwi/contact if you encounter any problems.