README

Worker Debug

Enhanced debugging capabilities for Yii2 applications with FrankenPHP worker mode
Real-time performance monitoring, comprehensive request inspection, and worker-aware debugging

Features

Demo

Explore the ready-to-run Yii2 + FrankenPHP application template with Worker Debug pre-configured.

Installation

composer require --dev yii2-extensions/worker-debug:^0.1

Quick start

Add the following to your development configuration (config/web.php)

<?php

declare(strict_types=1);

use yii2\extensions\debug\WorkerDebugModule;

if (YII_ENV_DEV) {
    // configuration adjustments for 'dev' environment
    $config['bootstrap'][] = 'debug';
    $config['modules']['debug'] = [
        'class' => WorkerDebugModule::class,
        // uncomment the following to add your IP if you are not connecting from localhost.
        //'allowedIPs' => ['127.0.0.1', '::1'],
    ];
}

Important

The Worker Debug extension is specifically designed for development environments.
Never enable it in production as it may expose sensitive application data.

Why Worker Debug?

Traditional Yii2 debug toolbar relies on PHP's global state and request lifecycle that doesn't align with FrankenPHP's persistent worker mode. The Worker Debug extension addresses this by:

• Accurate Timing – Correctly tracks request duration in worker environments
• State Isolation – Ensures debug data doesn't leak between requests
• Performance Optimization – Minimal overhead on worker processes
• Enhanced Visibility – Better insights into worker-specific behavior

Documentation

For detailed configuration options and advanced usage.

• 🧪 Testing Guide
• 🛠️ Development Guide

Package information

Quality code

Our social networks

License