wip

Author: michalsn

app/Config/WorkerMode.php

@@ -21,8 +21,6 @@ class WorkerMode
      * - `autoloader`: PSR-4 autoloading configuration
      * - `locator`: File locator
      * - `exceptions`: Exception handler
-     * - `logger`: Logger instance
-     * - `timer`: Performance timer
      * - `commands`: CLI commands registry
      * - `codeigniter`: Main application instance
      * - `superglobals`: Superglobals wrapper
@@ -35,8 +33,6 @@ class WorkerMode
         'autoloader',
         'locator',
         'exceptions',
-        'logger',
-        'timer',
         'commands',
         'codeigniter',
         'superglobals',

system/Commands/Worker/Views/frankenphp-worker.php.tpl

@@ -87,8 +87,11 @@ $handler = static function () use ($app, $workerConfig) {
         ->setFilesArray($_FILES)
         ->setRequestArray($_REQUEST);
 
-    // Handle the request
-    $app->run();
+    try {
+        $app->run();
+    } catch (Throwable $e) {
+        Services::exceptions()->exceptionHandler($e);
+    }
 
     if ($workerConfig->garbageCollection) {
         // Force garbage collection
@@ -117,20 +120,8 @@ while (frankenphp_handle_request($handler)) {
     // Reset services except persistent ones
     Services::resetForWorkerMode($workerConfig);
 
-    // Reset performance
-    Events::cleanupForWorkerMode();
-
-    // Reset persistent services that accumulate state
-    if (Services::has('timer')) {
-        Services::timer()->reset();
-    }
-
-    if (Services::has('logger')) {
-        Services::logger()->reset();
-    }
-
-    // Reset debug toolbar collectors (development only)
-    if (CI_DEBUG && Services::has('toolbar')) {
+    if (CI_DEBUG) {
+        Events::cleanupForWorkerMode();
         Services::toolbar()->reset();
     }
 }

system/Debug/Timer.php

@@ -148,13 +148,4 @@ public function record(string $name, callable $callable)
 
         return $returnValue;
     }
-
-    /**
-     * Reset all timers for worker mode.
-     * Clears all timer data between requests.
-     */
-    public function reset(): void
-    {
-        $this->timers = [];
-    }
 }

system/Events/Events.php

@@ -286,12 +286,13 @@ public static function getPerformanceLogs()
     }
 
     /**
-     * Cleanup performance log for worker mode.
+     * Cleanup performance log and request-specific listeners for worker mode.
      *
      * Called at the END of each request to clean up state.
      */
     public static function cleanupForWorkerMode(): void
     {
         static::$performanceLog = [];
+        static::removeAllListeners('DBQuery');
     }
 }

system/Log/Logger.php

@@ -376,15 +376,4 @@ public function determineFile(): array
 
         return ['unknown', 'unknown'];
     }
-
-    /**
-     * Reset log cache for worker mode.
-     * Clears cached log entries between requests.
-     */
-    public function reset(): void
-    {
-        if ($this->cacheLogs) {
-            $this->logCache = [];
-        }
-    }
 }

user_guide_src/source/changelogs/v4.7.0.rst

@@ -15,6 +15,7 @@ Highlights
 **********
 
 - Update minimal PHP requirement to ``8.2``.
+- Added experimental **FrankenPHP Worker Mode** support for improved performance.
 
 ********
 BREAKING
@@ -245,21 +246,26 @@ Libraries
 - **Image:** The ``ImageMagickHandler`` has been rewritten to rely solely on the PHP ``imagick`` extension.
 - **Image:** Added ``ImageMagickHandler::clearMetadata()`` method to remove image metadata for privacy protection.
 - **ResponseTrait:** Added ``paginate``` method to simplify paginated API responses. See :ref:`ResponseTrait::paginate() <api_response_trait_paginate>` for details.
+- **Session:** Added connection persistence for Redis and Memcached session handlers via ``PersistsConnection`` trait, improving performance in worker mode by reusing connections across requests.
 - **Time:** added methods ``Time::addCalendarMonths()`` and ``Time::subCalendarMonths()``
 - **Time:** Added ``Time::isPast()`` and ``Time::isFuture()`` convenience methods. See :ref:`isPast <time-comparing-two-times-isPast>` and :ref:`isFuture <time-comparing-two-times-isFuture>` for details.
-- **View:** Added the ability to override namespaced views (e.g., from modules/packages) by placing a matching file structure within the **app/Views/overrides** directory. See :ref:`Overriding Namespaced Views <views-overriding-namespaced-views>` for details.
 - **Toolbar:** Fixed an issue where the Debug Toolbar was incorrectly injected into responses generated by third-party libraries (e.g., Dompdf) that use native PHP headers instead of the framework's Response object.
-
+- **View:** Added the ability to override namespaced views (e.g., from modules/packages) by placing a matching file structure within the **app/Views/overrides** directory. See :ref:`Overriding Namespaced Views <views-overriding-namespaced-views>` for details.
+- **Worker Mode:** Added experimental FrankenPHP Worker Mode support, allowing CodeIgniter to handle multiple HTTP requests within the same PHP process for 2-3x performance improvements. See :doc:`Worker Mode </installation/worker_mode>` for details.
 
 Commands
 ========
 
+- Added ``php spark worker:install`` command to generate FrankenPHP worker mode files (Caddyfile and worker entry point).
+- Added ``php spark worker:uninstall`` command to remove worker mode files.
+
 Testing
 =======
 
 Database
 ========
 
+- **BaseConnection:** Added ``ping()`` method to check if the database connection is still alive. Postgre uses native ``pg_ping()``, other drivers use ``SELECT 1``.
 - **Exception Logging:** All DB drivers now log database exceptions uniformly. Previously, each driver had its own log format.
 
 Query Builder
@@ -301,10 +307,17 @@ Message Changes
 Changes
 *******
 
+- **Boot:** Added ``Boot::bootWorker()`` method for one-time worker initialization.
+- **CodeIgniter:** Added ``CodeIgniter::resetForWorkerMode()`` method to reset request-specific state between worker requests.
+- **Config:** Added ``app/Config/WorkerMode.php`` for worker mode configuration (persistent services, garbage collection).
 - **Cookie:** The ``CookieInterface::EXPIRES_FORMAT`` has been changed to ``D, d M Y H:i:s T`` to follow the recommended format in RFC 7231.
+- **DatabaseConfig:** Added ``Config::validateForWorkerMode()`` and ``Config::cleanupForWorkerMode()`` methods for database connection management in worker mode.
+- **Events:** Added ``Events::cleanupForWorkerMode()`` method.
 - **Format:** Added support for configuring ``json_encode()`` maximum depth via ``Config\Format::$jsonEncodeDepth``.
 - **Paths:** Added support for changing the location of the ``.env`` file via the ``Paths::$envDirectory`` property.
+- **Services:** Added ``Services::resetForWorkerMode()`` and ``Services::validateForWorkerMode()`` methods.
 - **Toolbar:** Added ``$disableOnHeaders`` property to **app/Config/Toolbar.php**.
+- **Toolbar:** Added ``Toolbar::reset()`` method to reset debug toolbar collectors.
 
 
 ************

user_guide_src/source/installation/worker_mode.rst

@@ -91,9 +91,9 @@ Getting Started
 Installation
 ============
 
-1. Install FrankenPHP following the `official documentation <https://frankenphp.dev/docs/>`_
+1. Install FrankenPHP following the `official documentation <https://frankenphp.dev/>`_
 
-   You can use a static binary or Docker. Here we will assume we use a static binary,
+   You can use a static binary or Docker. Here, we will assume we use a static binary,
    which can be `downloaded directly <https://github.com/php/frankenphp/releases/>`_.
 
 2. Install the Worker Mode template files using the spark command:
@@ -203,8 +203,6 @@ Service               Purpose
 ``autoloader``        PSR-4 autoloading configuration. Safe to persist as class maps don't change.
 ``locator``           File locator for finding framework files. Caches file paths for performance.
 ``exceptions``        Exception handler. Stateless, safe to reuse.
-``logger``            Logger instance. Maintains file handles for efficient logging.
-``timer``             Performance timer. Reset internally per request.
 ``commands``          CLI commands registry. Only used during worker startup.
 ``codeigniter``       Main application instance. Orchestrates the request/response cycle.
 ``superglobals``      Superglobals wrapper. Properly isolated per request internally.