IBX-11485: Update doc for Symfony 7.4

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 <database_user> --add-drop-table <database_name> > db_backup.sql
+=== "MySQL"
 
-# PostgreSQL
-pg_dump -c --if-exists <database_name> > db_backup.sql
-```
+    ``` bash
+    mysqldump -u <database_user> --add-drop-table <database_name> > db_backup.sql
+    ```
+
+=== "PostgreSQL"
+
+    ``` bash
+    pg_dump -c --if-exists <database_name> > db_backup.sql
+    ```
 
 4\. In parent directory create a tar archive of the files (including the database dump) using the "tar" command:
 

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.
 

docs/update_and_migration/from_5.0/update_from_5.0.md

@@ -334,6 +334,79 @@
 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 a higher Symfony version:
+
+    ```json
+    "extra": {
+        "symfony": {
+            "require": "7.4.*"
+        }
+    }
+    ```
+
+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.*",
+    +        "symfony/console": "7.4.*",
+    ```
+
+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).
+    Key changes include:
+
+    - 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 =]]"
+
+        ``` 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. 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],
+        JMS\TranslationBundle\JMSTranslationBundle::class => ['all' => true],
+        Liip\ImagineBundle\LiipImagineBundle::class => ['all' => true],
+    ```
+
+You're now running [Symfony 7.4, the current long-term support version](https://symfony.com/releases/7.4).
+
 ## LTS Updates and additional packages
 
 [LTS Updates](editions.md#lts-updates) are standalone packages with their own update procedures.

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'