Skip to content

Add documentation for symfony and controller changes #314

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

Open
iMattPro wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Add documentation for symfony and controller changes #314

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
8fd896a
Add documentation for app.php becoming index.php
iMattPro Mar 17, 2026
b01200c
Update Symfony and PHP versions mentioned
iMattPro Mar 17, 2026
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
34 changes: 31 additions & 3 deletions development/development/upgrade/400.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 <https://github.com/symfony/symfony/blob/4.4/UPGRADE-4.0.md>`_
- `Upgrade Symfony from 4.4 to 5.0 <https://github.com/symfony/symfony/blob/5.4/UPGRADE-5.0.md>`_
- `Upgrade Symfony from 5.x to 6.0 <https://github.com/symfony/symfony/blob/6.4/UPGRADE-6.0.md>`_
- `Upgrade Symfony from 6.x to 7.0 <https://github.com/symfony/symfony/blob/7.4/UPGRADE-7.0.md>`_

Additional guides are available in the `Symfony GitHub repository <https://github.com/symfony/symfony/tree/6.4>`_.
Additional guides are available in the `Symfony GitHub repository <https://github.com/symfony/symfony/tree/7.4>`_.

Twig
----
Expand Down Expand Up @@ -57,6 +58,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:
Expand Down
Loading