Skip to content

fix: make frankenphp-worker.php template idempotent on watcher restart #10191

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
paulbalandan merged 1 commit into from
May 12, 2026
Merged

fix: make frankenphp-worker.php template idempotent on watcher restart #10191

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 5 additions & 3 deletions system/Commands/Worker/Views/frankenphp-worker.php.tpl
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -36,7 +36,9 @@ if (version_compare(PHP_VERSION, $minPhpVersion, '<')) {
*---------------------------------------------------------------
*/

define('FCPATH', __DIR__ . DIRECTORY_SEPARATOR);
if (! defined('FCPATH')) {
define('FCPATH', __DIR__ . DIRECTORY_SEPARATOR);
}

if (getcwd() . DIRECTORY_SEPARATOR !== FCPATH) {
chdir(FCPATH);
Expand All @@ -49,11 +51,11 @@ if (getcwd() . DIRECTORY_SEPARATOR !== FCPATH) {
*/

// This is the line that might need to be changed, depending on your folder structure.
require FCPATH . '../app/Config/Paths.php';
require_once FCPATH . '../app/Config/Paths.php';
// ^^^ Change this line if you move your application folder
$paths = new Paths();

require $paths->systemDirectory . '/Boot.php';
require_once $paths->systemDirectory . '/Boot.php';

// One-time boot - loads autoloader, environment, helpers, etc.
$app = Boot::bootWorker($paths);
Expand Down
1 change: 1 addition & 0 deletions user_guide_src/source/changelogs/v4.7.3.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -49,6 +49,7 @@ Bugs Fixed
- **Toolbar:** Fixed a bug where the Logs collector raised an undefined property error when using a third-party PSR-3 logger.
- **Time:** Fixed a bug where ``Time::createFromTimestamp()`` could fail for microsecond timestamps when ``LC_NUMERIC`` used a comma decimal separator.
- **Validation:** Fixed a bug where ``Validation::getValidated()`` dropped fields whose validated value was explicitly ``null``.
- **Worker Mode:** Fixed a bug where the ``frankenphp-worker.php`` template caused a ``Cannot redeclare class Config\Paths`` fatal error when FrankenPHP's watcher re-executed the worker script after a watched file changed.

See the repo's
`CHANGELOG.md <https://github.com/codeigniter4/CodeIgniter4/blob/develop/CHANGELOG.md>`_
Expand Down
10 changes: 10 additions & 0 deletions user_guide_src/source/installation/upgrade_473.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,16 @@ Please refer to the upgrade instructions corresponding to your installation meth
Mandatory File Changes
**********************

Worker Mode
===========

If you are using Worker Mode, you must update **public/frankenphp-worker.php** after
upgrading. The easiest way is to re-run the install command:

.. code-block:: console

php spark worker:install --force

****************
Breaking Changes
****************
Expand Down