README

Yii Framework

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: