From 8fd896a9b120de1669eaa2a497413b7fd97fe60f Mon Sep 17 00:00:00 2001 From: Matt Friedman Date: Tue, 17 Mar 2026 07:52:22 -0700 Subject: [PATCH 1/2] Add documentation for app.php becoming index.php --- development/development/upgrade/400.rst | 27 +++++++++++++++++++++++++ 1 file changed, 27 insertions(+) diff --git a/development/development/upgrade/400.rst b/development/development/upgrade/400.rst index cdc3f6ae..3c8c962b 100644 --- a/development/development/upgrade/400.rst +++ b/development/development/upgrade/400.rst @@ -57,6 +57,33 @@ All Jabber/XMPP features have been removed in phpBB 4.0: This removal was driven by lack of browser support for XMPP and limited adoption within the phpBB community. +Front Controller Changes +======================== + +In phpBB 4.0, the front controller used for Symfony routing has been changed +from ``app.php`` to ``index.php``. + +In phpBB 3.3.x, routes were accessed via ``app.php``:: + + /app.php/faq + +In phpBB 4.0, routes are now accessed via ``index.php``:: + + /index.php/faq + +Direct access via ``app.php`` is no longer supported. Extensions and external +integrations must use ``index.php``. + +Extensions using phpBB routing helpers (for example, +``controller_helper::route()``) do not require changes, as URLs will be +generated correctly. + +However, any hardcoded references to ``app.php`` must be updated. This includes: + +- Template files +- PHP code constructing URLs manually +- JavaScript referencing application routes + Class and function changes ========================== Several classes and functions have been changed or removed. If your extension or code uses phpBB internals, you’ll want to: From b01200c4d97857f048eeb79c0179b8dd249f8ac6 Mon Sep 17 00:00:00 2001 From: Matt Friedman Date: Tue, 17 Mar 2026 07:52:52 -0700 Subject: [PATCH 2/2] Update Symfony and PHP versions mentioned --- development/development/upgrade/400.rst | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/development/development/upgrade/400.rst b/development/development/upgrade/400.rst index 3c8c962b..c3936efb 100644 --- a/development/development/upgrade/400.rst +++ b/development/development/upgrade/400.rst @@ -15,19 +15,20 @@ Basics PHP --- -phpBB 4.0 requires PHP 8.1 or higher. Most PHP code compatible with phpBB 3.3 should work in phpBB 4.0 with minimal changes, +phpBB 4.0 requires PHP 8.2 or higher. Most PHP code compatible with phpBB 3.3 should work in phpBB 4.0 with minimal changes, but you may need to make adjustments depending on deprecated or changed functionality. Symfony ------- -phpBB 4.0 uses Symfony 6.4, a significant upgrade from the version bundled with phpBB 3.3. As Symfony introduced breaking +phpBB 4.0 uses Symfony 7.4, a significant upgrade from the version bundled with phpBB 3.3. As Symfony introduced breaking changes across versions, we recommend reviewing the following Symfony upgrade guides when updating custom code or extensions: - `Upgrade Symfony from 3.x to 4.0 `_ - `Upgrade Symfony from 4.4 to 5.0 `_ - `Upgrade Symfony from 5.x to 6.0 `_ +- `Upgrade Symfony from 6.x to 7.0 `_ -Additional guides are available in the `Symfony GitHub repository `_. +Additional guides are available in the `Symfony GitHub repository `_. Twig ----