From d582b7cbde3ef322e594693558f8ac00a5a7bf5b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Tue, 5 May 2026 13:04:08 +0200 Subject: [PATCH 1/4] Added more mentions about clearing persistence cache --- .../cache/persistence_cache.md | 14 +++++++++++ docs/snippets/page_block_cache_clear.md | 2 +- .../from_5.0/update_from_5.0.md | 25 ++++++++++++++++--- 3 files changed, 36 insertions(+), 5 deletions(-) diff --git a/docs/infrastructure_and_maintenance/cache/persistence_cache.md b/docs/infrastructure_and_maintenance/cache/persistence_cache.md index ece1462733..87375fb3cc 100644 --- a/docs/infrastructure_and_maintenance/cache/persistence_cache.md +++ b/docs/infrastructure_and_maintenance/cache/persistence_cache.md @@ -278,6 +278,20 @@ For more info on usage, see [Symfony Cache's documentation]([[= symfony_doc =]]/ ### Clearing persistence cache +!!! caution "Always clear the persistence with `cache:pool:clear` command" + + Running `php bin/console cache:clear` doesn't clear the persistence cache, even when using a filesystem-based cache pool. + + You must always clear the persistence cache by running: + + ```bash + php bin/console cache:pool:clear [cache-pool] + ``` + + The default cache-pool is named `cache.tagaware.filesystem`. + The default cache-pool when running Redis or Valkey is named `cache.redis`. + If you have customized the persistence cache configuration, the name of your cache pool might be different. + Persistence cache prefixes it's cache using "ibx-". Clearing persistence cache can thus be done in the following ways: ``` php diff --git a/docs/snippets/page_block_cache_clear.md b/docs/snippets/page_block_cache_clear.md index 9c833cd213..f4fb8adc43 100644 --- a/docs/snippets/page_block_cache_clear.md +++ b/docs/snippets/page_block_cache_clear.md @@ -2,7 +2,7 @@ Persistence cache must be cleared after any modifications have been made to the block config in Page Builder, such as adding, removing or altering the page blocks, block attributes, validators or views configuration. - To clear the persistence cache run `./bin/console cache:pool:clear [cache-pool]` command. + To clear the persistence cache run `php bin/console cache:pool:clear [cache-pool]` command. The default cache-pool is named `cache.tagaware.filesystem`. The default cache-pool when running Redis or Valkey is named `cache.redis`. If you have customized the [persistence cache configuration](https://doc.ibexa.co/en/latest/infrastructure_and_maintenance/cache/persistence_cache/#what-is-cached), the name of your cache pool might be different. 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 e44c1b2c55..bc30ec0e71 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 @@ -363,16 +363,33 @@ Update Symfony constraints in `composer.json` before updating the packages. 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. + !!! caution "Always clear the persistence cache with `cache:pool:clear` command" + + Starting with Symfony 7.4, running `php bin/console cache:clear` doesn't clear the [[= product_name =]] persistence cache, even when using a filesystem-based cache pool. + + To clear the persistence cache, for example after adding a [custom Page Builder block](create_custom_page_block.md), you must always run: + + ```bash + php bin/console cache:pool:clear [cache-pool] + ``` + + The default cache-pool is named `cache.tagaware.filesystem`. + The default cache-pool when running Redis or Valkey is named `cache.redis`. + If you have customized the persistence cache configuration, the name of your cache pool might be different. + + For more information about persistence cache, see [Persistence cache](persistence_cache.md). + + - 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. + 4. Update Ibexa packages by running: === "[[= product_name_headless =]]" From 962c55e7b23b494d5912f99841bc3d5d5d229273 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Tue, 5 May 2026 13:16:10 +0200 Subject: [PATCH 2/4] Self review --- .../infrastructure_and_maintenance/cache/persistence_cache.md | 4 ++-- docs/snippets/page_block_cache_clear.md | 4 ++-- docs/update_and_migration/from_5.0/update_from_5.0.md | 4 ++-- 3 files changed, 6 insertions(+), 6 deletions(-) diff --git a/docs/infrastructure_and_maintenance/cache/persistence_cache.md b/docs/infrastructure_and_maintenance/cache/persistence_cache.md index 87375fb3cc..dedd4b3726 100644 --- a/docs/infrastructure_and_maintenance/cache/persistence_cache.md +++ b/docs/infrastructure_and_maintenance/cache/persistence_cache.md @@ -288,8 +288,8 @@ For more info on usage, see [Symfony Cache's documentation]([[= symfony_doc =]]/ php bin/console cache:pool:clear [cache-pool] ``` - The default cache-pool is named `cache.tagaware.filesystem`. - The default cache-pool when running Redis or Valkey is named `cache.redis`. + The default cache pool is named `cache.tagaware.filesystem`. + The default cache pool when running Redis or Valkey is named `cache.redis`. If you have customized the persistence cache configuration, the name of your cache pool might be different. Persistence cache prefixes it's cache using "ibx-". Clearing persistence cache can thus be done in the following ways: diff --git a/docs/snippets/page_block_cache_clear.md b/docs/snippets/page_block_cache_clear.md index f4fb8adc43..30ee73bb94 100644 --- a/docs/snippets/page_block_cache_clear.md +++ b/docs/snippets/page_block_cache_clear.md @@ -3,8 +3,8 @@ Persistence cache must be cleared after any modifications have been made to the block config in Page Builder, such as adding, removing or altering the page blocks, block attributes, validators or views configuration. To clear the persistence cache run `php bin/console cache:pool:clear [cache-pool]` command. - The default cache-pool is named `cache.tagaware.filesystem`. - The default cache-pool when running Redis or Valkey is named `cache.redis`. + The default cache pool is named `cache.tagaware.filesystem`. + The default cache pool when running Redis or Valkey is named `cache.redis`. If you have customized the [persistence cache configuration](https://doc.ibexa.co/en/latest/infrastructure_and_maintenance/cache/persistence_cache/#what-is-cached), the name of your cache pool might be different. In prod mode, you also need to clear the symfony cache by running `./bin/console c:c`. 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 bc30ec0e71..97139d20d3 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 @@ -379,8 +379,8 @@ Update Symfony constraints in `composer.json` before updating the packages. php bin/console cache:pool:clear [cache-pool] ``` - The default cache-pool is named `cache.tagaware.filesystem`. - The default cache-pool when running Redis or Valkey is named `cache.redis`. + The default cache pool is named `cache.tagaware.filesystem`. + The default cache pool when running Redis or Valkey is named `cache.redis`. If you have customized the persistence cache configuration, the name of your cache pool might be different. For more information about persistence cache, see [Persistence cache](persistence_cache.md). From a8ce9b945a4a76eecd667380306df40aae6c9648 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Wed, 13 May 2026 15:25:00 +0200 Subject: [PATCH 3/4] 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/infrastructure_and_maintenance/cache/persistence_cache.md | 2 +- docs/snippets/page_block_cache_clear.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/infrastructure_and_maintenance/cache/persistence_cache.md b/docs/infrastructure_and_maintenance/cache/persistence_cache.md index dedd4b3726..826bc4ce57 100644 --- a/docs/infrastructure_and_maintenance/cache/persistence_cache.md +++ b/docs/infrastructure_and_maintenance/cache/persistence_cache.md @@ -280,7 +280,7 @@ For more info on usage, see [Symfony Cache's documentation]([[= symfony_doc =]]/ !!! caution "Always clear the persistence with `cache:pool:clear` command" - Running `php bin/console cache:clear` doesn't clear the persistence cache, even when using a filesystem-based cache pool. + Running `php bin/console cache:clear` doesn't clear the persistence cache, even when you use a filesystem-based cache pool. You must always clear the persistence cache by running: diff --git a/docs/snippets/page_block_cache_clear.md b/docs/snippets/page_block_cache_clear.md index 30ee73bb94..61805e12af 100644 --- a/docs/snippets/page_block_cache_clear.md +++ b/docs/snippets/page_block_cache_clear.md @@ -2,7 +2,7 @@ Persistence cache must be cleared after any modifications have been made to the block config in Page Builder, such as adding, removing or altering the page blocks, block attributes, validators or views configuration. - To clear the persistence cache run `php bin/console cache:pool:clear [cache-pool]` command. + To clear the persistence cache, run `php bin/console cache:pool:clear [cache-pool]` command. The default cache pool is named `cache.tagaware.filesystem`. The default cache pool when running Redis or Valkey is named `cache.redis`. If you have customized the [persistence cache configuration](https://doc.ibexa.co/en/latest/infrastructure_and_maintenance/cache/persistence_cache/#what-is-cached), the name of your cache pool might be different. From f39f81aa368d9c280044be1eee85ff8760d8d6b9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marek=20Noco=C5=84?= Date: Wed, 13 May 2026 15:56:37 +0200 Subject: [PATCH 4/4] Vale remarks --- .../cache/persistence_cache.md | 8 ++++---- docs/snippets/page_block_cache_clear.md | 2 +- docs/update_and_migration/from_5.0/update_from_5.0.md | 8 ++++---- 3 files changed, 9 insertions(+), 9 deletions(-) diff --git a/docs/infrastructure_and_maintenance/cache/persistence_cache.md b/docs/infrastructure_and_maintenance/cache/persistence_cache.md index 826bc4ce57..30f7b6fad1 100644 --- a/docs/infrastructure_and_maintenance/cache/persistence_cache.md +++ b/docs/infrastructure_and_maintenance/cache/persistence_cache.md @@ -281,15 +281,15 @@ For more info on usage, see [Symfony Cache's documentation]([[= symfony_doc =]]/ !!! caution "Always clear the persistence with `cache:pool:clear` command" Running `php bin/console cache:clear` doesn't clear the persistence cache, even when you use a filesystem-based cache pool. - + You must always clear the persistence cache by running: ```bash - php bin/console cache:pool:clear [cache-pool] + php bin/console cache:pool:clear ``` - The default cache pool is named `cache.tagaware.filesystem`. - The default cache pool when running Redis or Valkey is named `cache.redis`. + The default cache pool is named `cache.tagaware.filesystem`. + The default cache pool when running Redis or Valkey is named `cache.redis`. If you have customized the persistence cache configuration, the name of your cache pool might be different. Persistence cache prefixes it's cache using "ibx-". Clearing persistence cache can thus be done in the following ways: diff --git a/docs/snippets/page_block_cache_clear.md b/docs/snippets/page_block_cache_clear.md index 61805e12af..daf94c7446 100644 --- a/docs/snippets/page_block_cache_clear.md +++ b/docs/snippets/page_block_cache_clear.md @@ -2,7 +2,7 @@ Persistence cache must be cleared after any modifications have been made to the block config in Page Builder, such as adding, removing or altering the page blocks, block attributes, validators or views configuration. - To clear the persistence cache, run `php bin/console cache:pool:clear [cache-pool]` command. + To clear the persistence cache, run `php bin/console cache:pool:clear ` command. The default cache pool is named `cache.tagaware.filesystem`. The default cache pool when running Redis or Valkey is named `cache.redis`. If you have customized the [persistence cache configuration](https://doc.ibexa.co/en/latest/infrastructure_and_maintenance/cache/persistence_cache/#what-is-cached), the name of your cache pool might be different. 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 97139d20d3..52df93501d 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 @@ -376,18 +376,18 @@ Update Symfony constraints in `composer.json` before updating the packages. To clear the persistence cache, for example after adding a [custom Page Builder block](create_custom_page_block.md), you must always run: ```bash - php bin/console cache:pool:clear [cache-pool] + php bin/console cache:pool:clear ``` - The default cache pool is named `cache.tagaware.filesystem`. - The default cache pool when running Redis or Valkey is named `cache.redis`. + The default cache pool is named `cache.tagaware.filesystem`. + The default cache pool when running Redis or Valkey is named `cache.redis`. If you have customized the persistence cache configuration, the name of your cache pool might be different. For more information about persistence cache, see [Persistence cache](persistence_cache.md). - 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. + As part of the new [array-based PHP configuration format](https://symfony.com/blog/new-in-symfony-7-4-better-php-configuration), Symfony creates the `config/reference.php` file. You should commit this file to the repository. 4. Update Ibexa packages by running: