From 2ebad44df97619657220aa0e757aa1ab1755456e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Thu, 19 Mar 2026 10:17:07 +0100 Subject: [PATCH 1/6] Update doc for Symfny 7.4 --- .../from_5.0/update_from_5.0.md | 50 +++++++++++++++++++ mkdocs.yml | 2 +- 2 files changed, 51 insertions(+), 1 deletion(-) diff --git a/docs/update_and_migration/from_5.0/update_from_5.0.md b/docs/update_and_migration/from_5.0/update_from_5.0.md index 18f7129c1d..baf6bb8fb0 100644 --- a/docs/update_and_migration/from_5.0/update_from_5.0.md +++ b/docs/update_and_migration/from_5.0/update_from_5.0.md @@ -334,6 +334,56 @@ Additionally, you must remove the following line from your `.platform.app.yaml` curl -fs https://get.symfony.com/cloud/configurator | bash ``` +## v5.0.7 + +### Update Symfony from 7.3 to 7.4 + +This version of [[= product_name =]] requires [Symfony 7.4](https://symfony.com/releases/7.4). +Update Symfony constraints in `composer.json` before updating the packages. + +1. In `composer.json`, update `extra.symfony.require` to allow installing higher Symfony version: + + ```json + "extra": { + "symfony": { + "require": "7.4.*" + } + } + ``` + +2. Review your code, configuration, and third-party bundles for Symfony 7.4 compatibility. + +3. Update packages by running: + +=== "[[= product_name_headless =]]" + + ``` bash + yarn upgrade @ibexa/frontend-config @ibexa/ts-config + composer require ibexa/headless:v5.0.7 --with-all-dependencies --no-scripts + composer recipes:install ibexa/headless --force -v + ``` +=== "[[= product_name_exp =]]" + + ``` bash + yarn upgrade @ibexa/frontend-config @ibexa/ts-config + composer require ibexa/experience:v5.0.7 --with-all-dependencies --no-scripts + composer recipes:install ibexa/experience --force -v + ``` +=== "[[= product_name_com =]]" + + ``` bash + yarn upgrade @ibexa/frontend-config @ibexa/ts-config + composer require ibexa/commerce:v5.0.7 --with-all-dependencies --no-scripts + composer recipes:install ibexa/commerce --force -v + ``` + +!!! tip + + As part of the [array-based PHP configuration format](https://symfony.com/blog/new-in-symfony-7-4-better-php-configuration), a `config/reference.php` file will be created. + You should commit this file to the repository. + +For more details about the new version, see the official Symfony [upgrade instructions](https://github.com/symfony/symfony/blob/7.4/UPGRADE-7.4.md) and [blog posts introducing this release](https://symfony.com/blog/category/living-on-the-edge/8.0-7.4). + ## LTS Updates and additional packages [LTS Updates](editions.md#lts-updates) are standalone packages with their own update procedures. diff --git a/mkdocs.yml b/mkdocs.yml index 158817bf9a..ef0e01c2d0 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -1001,7 +1001,7 @@ extra: latest_tag_4_6: '4.6.28' latest_tag_5_0: '5.0.6' - symfony_doc: 'https://symfony.com/doc/7.3' + symfony_doc: 'https://symfony.com/doc/7.4' user_doc: 'https://doc.ibexa.co/projects/userguide/en/5.0' connect_doc: 'https://doc.ibexa.co/projects/connect/en/latest' From eb85427802dd2e98db95800be0424c58ca08e283 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Fri, 20 Mar 2026 12:17:04 +0100 Subject: [PATCH 2/6] Added bundle entry --- .../from_5.0/update_from_5.0.md | 55 ++++++++++++------- 1 file changed, 36 insertions(+), 19 deletions(-) diff --git a/docs/update_and_migration/from_5.0/update_from_5.0.md b/docs/update_and_migration/from_5.0/update_from_5.0.md index baf6bb8fb0..0d2f2b3a8a 100644 --- a/docs/update_and_migration/from_5.0/update_from_5.0.md +++ b/docs/update_and_migration/from_5.0/update_from_5.0.md @@ -351,32 +351,49 @@ Update Symfony constraints in `composer.json` before updating the packages. } ``` -2. Review your code, configuration, and third-party bundles for Symfony 7.4 compatibility. +2. To allow installing Symfony 7.4, update the requirements for `symfony` packages in `composer.json` as in the example below:: -3. Update packages by running: + ``` diff + - "symfony/console": "7.3.*", + + "symfony/console": "7.4.*", + ``` -=== "[[= product_name_headless =]]" +3. Review your code, configuration, and third-party bundles for Symfony 7.4 compatibility. - ``` bash - yarn upgrade @ibexa/frontend-config @ibexa/ts-config - composer require ibexa/headless:v5.0.7 --with-all-dependencies --no-scripts - composer recipes:install ibexa/headless --force -v - ``` -=== "[[= product_name_exp =]]" +4. Update packages by running: - ``` bash - yarn upgrade @ibexa/frontend-config @ibexa/ts-config - composer require ibexa/experience:v5.0.7 --with-all-dependencies --no-scripts - composer recipes:install ibexa/experience --force -v - ``` -=== "[[= product_name_com =]]" + === "[[= product_name_headless =]]" - ``` bash - yarn upgrade @ibexa/frontend-config @ibexa/ts-config - composer require ibexa/commerce:v5.0.7 --with-all-dependencies --no-scripts - composer recipes:install ibexa/commerce --force -v + ``` bash + yarn upgrade @ibexa/frontend-config @ibexa/ts-config + composer require ibexa/headless:v5.0.7 --with-all-dependencies --no-scripts + composer recipes:install ibexa/headless --force -v + ``` + === "[[= product_name_exp =]]" + + ``` bash + yarn upgrade @ibexa/frontend-config @ibexa/ts-config + composer require ibexa/experience:v5.0.7 --with-all-dependencies --no-scripts + composer recipes:install ibexa/experience --force -v + ``` + === "[[= product_name_com =]]" + + ``` bash + yarn upgrade @ibexa/frontend-config @ibexa/ts-config + composer require ibexa/commerce:v5.0.7 --with-all-dependencies --no-scripts + composer recipes:install ibexa/commerce --force -v + ``` + +5. Restore manually the entry for `JMSTranslationBundle` in `config/bundles.php` to [its previous position](https://github.com/ibexa/commerce-skeleton/blob/v5.0.6/config/bundles.php#L14): + + ``` hl_lines="2" + FOS\HttpCacheBundle\FOSHttpCacheBundle::class => ['all' => true], + JMS\TranslationBundle\JMSTranslationBundle::class => ['all' => true], + Liip\ImagineBundle\LiipImagineBundle::class => ['all' => true], ``` + + !!! tip As part of the [array-based PHP configuration format](https://symfony.com/blog/new-in-symfony-7-4-better-php-configuration), a `config/reference.php` file will be created. From 9315139b3379697480a4832d27743635e04f4d92 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Fri, 20 Mar 2026 12:25:54 +0100 Subject: [PATCH 3/6] Apply suggestion from @mnocon --- docs/update_and_migration/from_5.0/update_from_5.0.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/update_and_migration/from_5.0/update_from_5.0.md b/docs/update_and_migration/from_5.0/update_from_5.0.md index 0d2f2b3a8a..3cf4c3d318 100644 --- a/docs/update_and_migration/from_5.0/update_from_5.0.md +++ b/docs/update_and_migration/from_5.0/update_from_5.0.md @@ -351,7 +351,7 @@ Update Symfony constraints in `composer.json` before updating the packages. } ``` -2. To allow installing Symfony 7.4, update the requirements for `symfony` packages in `composer.json` as in the example below:: +2. To allow installing Symfony 7.4, update the requirements for `symfony` packages in `composer.json` as in the example below: ``` diff - "symfony/console": "7.3.*", From fa5d64dfc38181f3adf339d2dbf4cd9a4fa79a0c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Mon, 30 Mar 2026 13:31:12 +0200 Subject: [PATCH 4/6] Added var/share mention --- docs/infrastructure_and_maintenance/backup.md | 23 +++++++++++-------- .../support_and_maintenance_faq.md | 4 ++-- .../from_5.0/update_from_5.0.md | 10 +++++--- 3 files changed, 23 insertions(+), 14 deletions(-) diff --git a/docs/infrastructure_and_maintenance/backup.md b/docs/infrastructure_and_maintenance/backup.md index d28854d9b9..edcb52c524 100644 --- a/docs/infrastructure_and_maintenance/backup.md +++ b/docs/infrastructure_and_maintenance/backup.md @@ -20,20 +20,25 @@ cd /path/to/ibexa 2\. Clear all caches: -``` -var/cache/* -var/logs/* +``` bash +rm -rf var/cache/* +rm -rf var/share/* +rm -rf var/logs/* ``` 3\. Create a dump of the database: -``` -# MySQL -mysqldump -u --add-drop-table > db_backup.sql +=== "MySQL" -# PostgreSQL -pg_dump -c --if-exists > db_backup.sql -``` + ``` bash + mysqldump -u --add-drop-table > db_backup.sql + ``` + +=== "PostgreSQL" + + ``` bash + pg_dump -c --if-exists > db_backup.sql + ``` 4\. In parent directory create a tar archive of the files (including the database dump) using the "tar" command: diff --git a/docs/infrastructure_and_maintenance/support_and_maintenance_faq.md b/docs/infrastructure_and_maintenance/support_and_maintenance_faq.md index feb032c3e7..72c192194d 100644 --- a/docs/infrastructure_and_maintenance/support_and_maintenance_faq.md +++ b/docs/infrastructure_and_maintenance/support_and_maintenance_faq.md @@ -76,12 +76,12 @@ php bin/console cache:pool:clear cache.redis ```bash rm -rf var/cache/* +rm -rf var/share/* ``` !!! caution "Clearing cache manually" - Manual cache clearing should be executed with caution. - `rm -rf var/cache/*` wipes all the files and unlike `cache:clear` doesn't warm up the cache. + Manual cache clearing should be executed with caution, as it doesn't warm up the cache. It results in a significant performance drop on first request, so it shouldn't be called on a production environment. Besides, it could lead to issues with file ownership after running `cache:clear` as a root. diff --git a/docs/update_and_migration/from_5.0/update_from_5.0.md b/docs/update_and_migration/from_5.0/update_from_5.0.md index 3cf4c3d318..1cf8a6a63e 100644 --- a/docs/update_and_migration/from_5.0/update_from_5.0.md +++ b/docs/update_and_migration/from_5.0/update_from_5.0.md @@ -392,14 +392,18 @@ Update Symfony constraints in `composer.json` before updating the packages. Liip\ImagineBundle\LiipImagineBundle::class => ['all' => true], ``` +For more details about the new version, see the official Symfony [upgrade instructions](https://github.com/symfony/symfony/blob/7.4/UPGRADE-7.4.md) and [blog posts introducing this release](https://symfony.com/blog/category/living-on-the-edge/8.0-7.4). +Among the changes are: - -!!! tip +- Array-based PHP configuration format As part of the [array-based PHP configuration format](https://symfony.com/blog/new-in-symfony-7-4-better-php-configuration), a `config/reference.php` file will be created. You should commit this file to the repository. -For more details about the new version, see the official Symfony [upgrade instructions](https://github.com/symfony/symfony/blob/7.4/UPGRADE-7.4.md) and [blog posts introducing this release](https://symfony.com/blog/category/living-on-the-edge/8.0-7.4). +- Independent application cache directory + + Symfony 7.4 introduces a new [share directory](https://symfony.com/blog/new-in-symfony-7-4-share-directory), dedicated for storing application cache on the file system. + If you decide to configure it (for example, by setting the `APP_SHARE_DIR` environment variable), review your existing scripts for explicit `var/cache` usage (for example, `rm -rf var/cache`) and decide whether to include `var/share` in the script. ## LTS Updates and additional packages From bc7d2f7a953026d11e7530fbe31f6f7ccab77fa8 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Tue, 31 Mar 2026 11:23:34 +0200 Subject: [PATCH 5/6] Review feedback --- .../from_5.0/update_from_5.0.md | 28 ++++++++++--------- 1 file changed, 15 insertions(+), 13 deletions(-) diff --git a/docs/update_and_migration/from_5.0/update_from_5.0.md b/docs/update_and_migration/from_5.0/update_from_5.0.md index 1cf8a6a63e..17b1c012bc 100644 --- a/docs/update_and_migration/from_5.0/update_from_5.0.md +++ b/docs/update_and_migration/from_5.0/update_from_5.0.md @@ -360,7 +360,20 @@ Update Symfony constraints in `composer.json` before updating the packages. 3. Review your code, configuration, and third-party bundles for Symfony 7.4 compatibility. -4. Update packages by running: + For more details about the new version, see the official Symfony [upgrade instructions](https://github.com/symfony/symfony/blob/7.4/UPGRADE-7.4.md) and [blog posts introducing this release](https://symfony.com/blog/category/living-on-the-edge/8.0-7.4). + Among the changes are: + + - Array-based PHP configuration format + + As part of the [array-based PHP configuration format](https://symfony.com/blog/new-in-symfony-7-4-better-php-configuration), a `config/reference.php` file will be created. + You should commit this file to the repository. + + - Independent application cache directory + + Symfony 7.4 introduces a new [share directory](https://symfony.com/blog/new-in-symfony-7-4-share-directory), dedicated for storing application cache on the file system. + If you decide to configure it (for example, by setting the `APP_SHARE_DIR` environment variable), review your existing scripts for explicit `var/cache` usage (for example, `rm -rf var/cache`) and decide whether to include `var/share` in the script. + +4. Update Ibexa packages by running: === "[[= product_name_headless =]]" @@ -392,18 +405,7 @@ Update Symfony constraints in `composer.json` before updating the packages. Liip\ImagineBundle\LiipImagineBundle::class => ['all' => true], ``` -For more details about the new version, see the official Symfony [upgrade instructions](https://github.com/symfony/symfony/blob/7.4/UPGRADE-7.4.md) and [blog posts introducing this release](https://symfony.com/blog/category/living-on-the-edge/8.0-7.4). -Among the changes are: - -- Array-based PHP configuration format - - As part of the [array-based PHP configuration format](https://symfony.com/blog/new-in-symfony-7-4-better-php-configuration), a `config/reference.php` file will be created. - You should commit this file to the repository. - -- Independent application cache directory - - Symfony 7.4 introduces a new [share directory](https://symfony.com/blog/new-in-symfony-7-4-share-directory), dedicated for storing application cache on the file system. - If you decide to configure it (for example, by setting the `APP_SHARE_DIR` environment variable), review your existing scripts for explicit `var/cache` usage (for example, `rm -rf var/cache`) and decide whether to include `var/share` in the script. +You're now running [Symfony 7.4, the current long-term support version](https://symfony.com/releases/7.4). ## LTS Updates and additional packages From 399171b506856677044015f9aae2b600425c0820 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Tue, 14 Apr 2026 13:38:30 +0200 Subject: [PATCH 6/6] Apply suggestions from code review MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Tomasz Dąbrowski <64841871+dabrt@users.noreply.github.com> --- docs/update_and_migration/from_5.0/update_from_5.0.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/update_and_migration/from_5.0/update_from_5.0.md b/docs/update_and_migration/from_5.0/update_from_5.0.md index 17b1c012bc..1472fcd2eb 100644 --- a/docs/update_and_migration/from_5.0/update_from_5.0.md +++ b/docs/update_and_migration/from_5.0/update_from_5.0.md @@ -341,7 +341,7 @@ curl -fs https://get.symfony.com/cloud/configurator | bash This version of [[= product_name =]] requires [Symfony 7.4](https://symfony.com/releases/7.4). Update Symfony constraints in `composer.json` before updating the packages. -1. In `composer.json`, update `extra.symfony.require` to allow installing higher Symfony version: +1. In `composer.json`, update `extra.symfony.require` to allow installing a higher Symfony version: ```json "extra": { @@ -361,7 +361,7 @@ Update Symfony constraints in `composer.json` before updating the packages. 3. Review your code, configuration, and third-party bundles for Symfony 7.4 compatibility. For more details about the new version, see the official Symfony [upgrade instructions](https://github.com/symfony/symfony/blob/7.4/UPGRADE-7.4.md) and [blog posts introducing this release](https://symfony.com/blog/category/living-on-the-edge/8.0-7.4). - Among the changes are: + Key changes include: - Array-based PHP configuration format @@ -397,7 +397,7 @@ Update Symfony constraints in `composer.json` before updating the packages. composer recipes:install ibexa/commerce --force -v ``` -5. Restore manually the entry for `JMSTranslationBundle` in `config/bundles.php` to [its previous position](https://github.com/ibexa/commerce-skeleton/blob/v5.0.6/config/bundles.php#L14): +5. Manually restore the entry for `JMSTranslationBundle` in `config/bundles.php` to [its previous position](https://github.com/ibexa/commerce-skeleton/blob/v5.0.6/config/bundles.php#L14): ``` hl_lines="2" FOS\HttpCacheBundle\FOSHttpCacheBundle::class => ['all' => true],