Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
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
14 changes: 14 additions & 0 deletions docs/infrastructure_and_maintenance/cache/persistence_cache.md
Original file line number Diff line number Diff line change
Expand Up @@ -278,6 +278,20 @@

### 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.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.


Check warning on line 284 in docs/infrastructure_and_maintenance/cache/persistence_cache.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/infrastructure_and_maintenance/cache/persistence_cache.md#L284

[Ibexa.EOLWhitespace] Remove whitespace characters from the end of the line.
Raw output
{"message": "[Ibexa.EOLWhitespace] Remove whitespace characters from the end of the line.", "location": {"path": "docs/infrastructure_and_maintenance/cache/persistence_cache.md", "range": {"start": {"line": 284, "column": 1}}}, "severity": "WARNING"}
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`.

Check warning on line 291 in docs/infrastructure_and_maintenance/cache/persistence_cache.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/infrastructure_and_maintenance/cache/persistence_cache.md#L291

[Ibexa.EOLWhitespace] Remove whitespace characters from the end of the line.
Raw output
{"message": "[Ibexa.EOLWhitespace] Remove whitespace characters from the end of the line.", "location": {"path": "docs/infrastructure_and_maintenance/cache/persistence_cache.md", "range": {"start": {"line": 291, "column": 65}}}, "severity": "WARNING"}
The default cache pool when running Redis or Valkey is named `cache.redis`.

Check warning on line 292 in docs/infrastructure_and_maintenance/cache/persistence_cache.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/infrastructure_and_maintenance/cache/persistence_cache.md#L292

[Ibexa.EOLWhitespace] Remove whitespace characters from the end of the line.
Raw output
{"message": "[Ibexa.EOLWhitespace] Remove whitespace characters from the end of the line.", "location": {"path": "docs/infrastructure_and_maintenance/cache/persistence_cache.md", "range": {"start": {"line": 292, "column": 80}}}, "severity": "WARNING"}
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
Expand Down
6 changes: 3 additions & 3 deletions docs/snippets/page_block_cache_clear.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@

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.
The default cache-pool is named `cache.tagaware.filesystem`.
The default cache-pool when running Redis or Valkey is named `cache.redis`.
To clear the persistence cache run `php bin/console cache:pool:clear [cache-pool]` command.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
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.

In prod mode, you also need to clear the symfony cache by running `./bin/console c:c`.
Expand Down
25 changes: 21 additions & 4 deletions docs/update_and_migration/from_5.0/update_from_5.0.md
Original file line number Diff line number Diff line change
Expand Up @@ -363,16 +363,33 @@
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`.

Check warning on line 382 in docs/update_and_migration/from_5.0/update_from_5.0.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/update_and_migration/from_5.0/update_from_5.0.md#L382

[Ibexa.EOLWhitespace] Remove whitespace characters from the end of the line.
Raw output
{"message": "[Ibexa.EOLWhitespace] Remove whitespace characters from the end of the line.", "location": {"path": "docs/update_and_migration/from_5.0/update_from_5.0.md", "range": {"start": {"line": 382, "column": 73}}}, "severity": "WARNING"}
The default cache pool when running Redis or Valkey is named `cache.redis`.

Check warning on line 383 in docs/update_and_migration/from_5.0/update_from_5.0.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/update_and_migration/from_5.0/update_from_5.0.md#L383

[Ibexa.EOLWhitespace] Remove whitespace characters from the end of the line.
Raw output
{"message": "[Ibexa.EOLWhitespace] Remove whitespace characters from the end of the line.", "location": {"path": "docs/update_and_migration/from_5.0/update_from_5.0.md", "range": {"start": {"line": 383, "column": 88}}}, "severity": "WARNING"}
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.

Check warning on line 390 in docs/update_and_migration/from_5.0/update_from_5.0.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/update_and_migration/from_5.0/update_from_5.0.md#L390

[Ibexa.FutureTense] Use present tense instead of future.
Raw output
{"message": "[Ibexa.FutureTense] Use present tense instead of future.", "location": {"path": "docs/update_and_migration/from_5.0/update_from_5.0.md", "range": {"start": {"line": 390, "column": 164}}}, "severity": "WARNING"}

Check notice on line 390 in docs/update_and_migration/from_5.0/update_from_5.0.md

View workflow job for this annotation

GitHub Actions / vale

[vale] docs/update_and_migration/from_5.0/update_from_5.0.md#L390

[Ibexa.Passive] Try to avoid passive tense, when possible.
Raw output
{"message": "[Ibexa.Passive] Try to avoid passive tense, when possible.", "location": {"path": "docs/update_and_migration/from_5.0/update_from_5.0.md", "range": {"start": {"line": 390, "column": 169}}}, "severity": "INFO"}
You should commit this file to the repository.

4. Update Ibexa packages by running:

=== "[[= product_name_headless =]]"
Expand Down
Loading