# Update from v4.6 to v5.0

> For the complete documentation index, see [llms.txt](https://doc.ibexa.co/en/5.0/llms.txt).

Update your installation to v5.0 from the latest v4.6 version.

## Update from v4.6.x to v4.6.latest

Before you update to v5.0, you must [update to the latest maintenance release of v4.6 (v4.6.33)](https://doc.ibexa.co/en/5.0/update_and_migration/from_4.6/update_from_4.6/index.md).

> **Caution: Database migration sequence**
>
> For certain migrations, protection mechanisms differ between v4.6.x and v.5.0.x. Therefore, before you update the database, make sure that you run `ibexa:doctrine:migrations:migrate` when your project is on the latest v4.6.x patch version. See [Database update](https://doc.ibexa.co/en/5.0/update_and_migration/from_4.6/update_from_4.6/#database-update_6).
>
> Otherwise `ibexa:doctrine:migrations:migrate` will fail on v5.0, for example, with the `Table 'ibexa_setting' already exists` error.

### Move from old to new Commerce

If you've chosen to use the [deprecated Commerce packages](https://doc.ibexa.co/en/5.0/update_and_migration/from_4.3/update_from_4.3_old_commerce/index.md) during the update to 4.4, you have to move to [new Commerce ones](https://doc.ibexa.co/en/5.0/update_and_migration/from_4.3/update_from_4.3_new_commerce/index.md).

## Update from v4.6.latest to v5.0.latest

When you have the latest version of 4.6, you can update to the latest version of 5.0 (v5.0.11).

### Requirements

First, match v5.0's [requirements](https://doc.ibexa.co/en/5.0/getting_started/requirements/index.md). It supports only PHP 8.3 and above.

### Update custom code for PHP 8.3+ and DXP 4.6

It's important to stop using deprecated PHP classes as they're removed in 5.0.

The [`ibexa/compatibility-layer`](https://doc.ibexa.co/en/5.0/update_and_migration/from_3.3/to_4.0/#add-compatibility-layer-package) isn't supported in 5.0. If you use it, remove it (`composer remove ibexa/compatibility-layer`) and make the necessary changes. See [Ibexa DXP v4.0 deprecations and backwards compatibility breaks](https://doc.ibexa.co/en/5.0/release_notes/ibexa_dxp_v4.0_deprecations/index.md) for the list of changes.

[Rector](https://getrector.com/) and the Ibexa rule sets help to upgrade your code.

Install [`ibexa/rector`](https://github.com/ibexa/rector) which contains rules to ensure custom code is up to date with DXP 4.6:

```bash
composer require --dev ibexa/rector
```

Customize the `rector.php` config file by:

- making it match your directory structure (for example, you may not have the `tests` directory)
- adding project-specific rules:
  - specify [PHP rules by using `withPhpSets`](https://getrector.com/documentation/set-lists#content-php-sets)
  - specify [Symfony, Twig, or Doctrine rules by using `withComposerBased`](https://getrector.com/documentation/composer-based-sets).

It's recommended to activate one rule set at a time and preview the output by running Rector with the `--dry-run` option to decide which rulesets should be used and in which order.

Your configuration could look like the following example:

```php
use Ibexa\Contracts\Rector\Sets\IbexaSetList;
use Rector\Config\RectorConfig;

return RectorConfig::configure()
    ->withPaths(
        [
           __DIR__ . '/src',
        ]
    )
    ->withSets(
        [
           IbexaSetList::IBEXA_46->value,
        ]
    )
    ->withPhpSets(php83: true)
    ->withComposerBased(symfony: true)
;
```

Run the following command to preview the changes done by Rector:

```bash
php vendor/bin/rector --dry-run
```

### Move from annotation to attribute

Delete [`config/routes/annotations.yaml`](https://github.com/symfony/recipes/blob/main/doctrine/annotations/1.0/config/routes/annotations.yaml) if you haven't customized it.

If you have customized it, change all occurrences of `type: annotation` to `type: attribute`.

The `config/routes.yaml` file should start with the following declaration from the [Symfony recipe](https://github.com/symfony/recipes/blob/main/symfony/routing/7.0/config/routes.yaml):

```yaml
controllers:
    resource:
        path: ../src/Controller/
        namespace: App\Controller
    type: attribute
```

You can add the new declaration to the top of the file manually, or recreate the file by running `composer sync-recipes symfony/routing --force --reset`.

### Remove GraphQL schema

The GraphQL schema used in 4.6 isn't compatible with version 5.0 and must be deleted. You can do it, for example, with the following command:

```bash
rm -r config/graphql
```

### Update Ibexa DXP application

#### Update package requirements

Ibexa DXP 5.0 is based on Symfony 7.4 (since v5.0.7) and both must be updated. Your development packages must be updated as well. The example below assumes that [`symfony/debug-pack`](https://symfony.com/packages/debug-pack) and `ibexa/rector` are installed. Adjust the list based on your project requirements. Notice the use of the `--no-update` option to only edit the `composer.json` entries and avoid triggering the package update and Composer scripts.

**Ibexa Headless**

```bash
# Update required PHP version
composer require --no-update 'php:>=8.3';
# Update required Symfony version
composer config extra.symfony.require '7.4.*'
# Upgrade Ibexa and Symfony packages: application
composer require --no-update \
    ibexa/headless:5.0.11 \
    symfony/console:^7.4 \
    symfony/dotenv:^7.4 \
    symfony/framework-bundle:^7.4 \
    symfony/runtime:^7.4 \
    symfony/yaml:^7.4 \
;
# Upgrade Ibexa and Symfony packages: development tools
composer require --dev --no-update \
    ibexa/rector:5.0.11 \
    symfony/debug-bundle:^7.4 \
    symfony/stopwatch:^7.4 \
    symfony/web-profiler-bundle:^7.4 \
;
```

**Ibexa Experience**

```bash
# Update required PHP version
composer require --no-update 'php:>=8.3';
# Update required Symfony version
composer config extra.symfony.require '7.4.*'
# Upgrade Ibexa and Symfony packages: application
composer require --no-update \
    ibexa/experience:5.0.11 \
    symfony/console:^7.4 \
    symfony/dotenv:^7.4 \
    symfony/framework-bundle:^7.4 \
    symfony/runtime:^7.4 \
    symfony/yaml:^7.4 \
;
# Upgrade Ibexa and Symfony packages: development tools
composer require --dev --no-update \
    ibexa/rector:5.0.11 \
    symfony/debug-bundle:^7.4 \
    symfony/stopwatch:^7.4 \
    symfony/web-profiler-bundle:^7.4 \
;
```

**Ibexa Commerce**

```bash
# Update required PHP version
composer require --no-update 'php:>=8.3';
# Update required Symfony version
composer config extra.symfony.require '7.4.*'
# Upgrade Ibexa and Symfony packages: application
composer require --no-update \
    ibexa/commerce:5.0.11 \
    symfony/console:^7.4 \
    symfony/dotenv:^7.4 \
    symfony/framework-bundle:^7.4 \
    symfony/runtime:^7.4 \
    symfony/yaml:^7.4 \
;
# Upgrade Ibexa and Symfony packages: development tools
composer require --dev --no-update \
    ibexa/rector:5.0.11 \
    symfony/debug-bundle:^7.4 \
    symfony/stopwatch:^7.4 \
    symfony/web-profiler-bundle:^7.4 \
;
```

#### Remove 4.6 LTS Updates constraints

4.6 LTS Update packages are included by default in 5.0. Remove them from your composer.json to avoid updating their version manually with each update.

For example, the following command removes several released LTS Updates for 4.6 from `composer.json`:

```bash
composer remove --no-update \
    ibexa/connector-ai \
    ibexa/connector-openai \
    ibexa/product-catalog-date-time-attribute \
    ibexa/product-catalog-symbol-attribute \
    ibexa/discounts \
    ibexa/discounts-codes \
    ibexa/collaboration \
    ibexa/share \
;
```

#### Remove separate Elasticsearch 8 package

If you were using the separate `ibexa/elasticsearch8` package in v4.6, you should switch back to the built-in `ibexa/elasticsearch` package, as it now supports both Elasticsearch 7 and Elasticsearch 8.

```bash
composer remove --no-update ibexa/elasticsearch8
```

The `ibexa/elasticsearch` package is automatically installed as part of your Ibexa DXP 5.0 update. Your existing Elasticsearch 8 server and configuration continue to work with the `ibexa/elasticsearch` package.

#### Remove PHP 8.2 error handler

If you were using the [`Php82HideDeprecationsErrorHandler`](https://doc.ibexa.co/en/5.0/update_and_migration/from_4.6/update_from_4.6/#v468) to avoid deprecation messages, you must remove it:

```bash
composer config --unset extra.runtime.error_handler
```

#### Update required packages

It's time to apply the new composer.json and update the dependencies:

```bash
composer update --with-all-dependencies --no-scripts
```

#### Remove Stimulus bootstrap

To help moving from Symfony's Webpack Encore bundle 1.x to 2.x, delete the Stimulus bootstrap file and reset Webpack Encore recipe:

```bash
rm assets/bootstrap.js
composer recipes:install symfony/webpack-encore-bundle --reset --force --yes
```

Compare with your previous version, merge them together, take care of [`webpack.config.js` usage change](#webpackconfigjs-usage-update), and test your customizations.

#### Apply Ibexa DXP recipe

**Ibexa Headless**

```bash
composer recipes:install ibexa/headless --reset --force --yes
```

**Ibexa Experience**

```bash
composer recipes:install ibexa/experience --reset --force --yes
```

**Ibexa Commerce**

```bash
composer recipes:install ibexa/commerce --reset --force --yes
```

#### Sort commands

Executing the recipes appends a new command at the end`composer.json`'s `auto-scripts` section, resulting in incorrect script order. You have to manually sort the commands so the `tsconfig.json` file is created by `yarn ibexa-generate-tsconfig` before being used by `ibexa:encore:compile`. Your `auto-scripts` entry should look like this:

```json
        "auto-scripts": {
            "cache:clear": "symfony-cmd",
            "assets:install %PUBLIC_DIR%": "symfony-cmd",
            "yarn install": "script",
            "yarn ibexa-generate-tsconfig --use-relative-paths": "script",
            "ibexa:encore:compile --config-name app": "symfony-cmd",
            "bazinga:js-translation:dump %PUBLIC_DIR%/assets --merge-domains": "symfony-cmd",
            "ibexa:encore:compile": "symfony-cmd",
            "ibexa:encore:compile --frontend-configs-name ibexa,internals,libs,richtext": "symfony-cmd"
        },
```

#### Remove Ibexa Icons

Remove from your `config/bundles.php` the line about `IbexaIconsBundle`.

#### Post update script

```bash
rm -rf var/cache
composer run-script post-update-cmd
```

### Update database

> **Caution: Caution**
>
> Always back up your data before running any database update scripts.
>
> After updating the database, clear the cache.
>
> Don't use `--force` argument for `mysql` / `psql` commands when performing update queries. If there is any problem during the update, it's best if the query fails immediately, so you can fix the underlying problem before you execute the update again. If you leave this for later you risk ending up with an incompatible database, though the problems might not surface immediately.

Ibexa Doctrine migrations manage the database schema updates.

To preview the migrations before you apply them, run:

```bash
php bin/console ibexa:doctrine:migrations:migrate --dry-run --write-sql=var/migration-preview.sql
```

> **Caution: Preview only**
>
> This generates an SQL file that is only intended for review. More recent migrations can be unaware of changes made by earlier migrations in the same run, so the file may be incomplete. Do not run the SQL file against your database.
>
> Always apply changes by running the command without the `--dry-run` flag.

The following command migrates your database from the v4.6 schema to the v5.0 schema:

```bash
php bin/console ibexa:doctrine:migrations:migrate
```

If your project uses [multiple repositories](https://doc.ibexa.co/en/5.0/administration/configuration/repository_configuration/#defining-custom-connection) with separate databases, run the command once for each repository, using the `--siteaccess` option with any SiteAccess that belongs to that repository:

```bash
php bin/console ibexa:doctrine:migrations:migrate --siteaccess=<siteaccess_of_that_repository>
```

Running the command more than once is safe. It has no effect if you apply it to a SiteAccess whose repository has already been migrated.

Doctrine migrations only manage Ibexa DXP's own database tables. Your custom tables are not affected, even if you also manage them with standard Doctrine migrations.

> **Caution: Command scope**
>
> This command isn't a full schema conformity checker. It checks for the presence of key elements (such as a column or table) to determine whether a change has already been applied. If a past upgrade was partially applied to your database, Doctrine migrations can be misled into marking the migration as complete when it isn't.

> **Note: Resolving conflicts with customizations**
>
> If a migration fails because you already modified the affected table yourself, for example, as part of a customization, check the error, compare with the SQL file generated during the dry run, and resolve the issue. Then, try running `ibexa:doctrine:migrations:migrate` again. Most migrations check the current state of the schema and record themselves as executed when it matches, without making any changes.
>
> If the migration still fails, check what it does, and make sure your schema reflects the same end result. Then, mark that migration as executed without actually running it.
>
> ```bash
> php bin/console ibexa:doctrine:migrations:version --add 'Ibexa\Bundle\Taxonomy\Migration\AddTaxonomyEntriesRootIndexesMigration'
> ```

Many tables and columns are renamed between v4.6 and v5.0. If you have custom code that directly queries those, you need to update them. You can track the renaming below.

Tables and columns renaming map

| Old name                                              | New name                                                                |
| ----------------------------------------------------- | ----------------------------------------------------------------------- |
| ezbinaryfile                                          | ibexa_binary_file                                                       |
| ezcobj_state                                          | ibexa_object_state                                                      |
| ezcobj_state_group                                    | ibexa_object_state_group                                                |
| ezcobj_state_group_language                           | ibexa_object_state_group_language                                       |
| ezcobj_state_language                                 | ibexa_object_state_language                                             |
| ezcobj_state_link                                     | ibexa_object_state_link                                                 |
| ezcontent_language                                    | ibexa_content_language                                                  |
| ezcontentbrowsebookmark                               | ibexa_content_bookmark                                                  |
| ezcontentclass                                        | ibexa_content_type                                                      |
| ezcontentclass_attribute                              | ibexa_content_type_field_definition                                     |
| ezcontentclass_attribute.contentclass_id              | ibexa_content_type_field_definition.content_type_id                     |
| ezcontentclass_attribute_ml                           | ibexa_content_type_field_definition_ml                                  |
| ezcontentclass_attribute_ml.contentclass_attribute_id | ibexa_content_type_field_definition_ml.content_type_field_definition_id |
| ezcontentclass_classgroup                             | ibexa_content_type_group_assignment                                     |
| ezcontentclass_classgroup.contentclass_id             | ibexa_content_type_group_assignment.content_type_id                     |
| ezcontentclass_name                                   | ibexa_content_type_name                                                 |
| ezcontentclass_name.contentclass_id                   | ibexa_content_type_name.content_type_id                                 |
| ezcontentclassgroup                                   | ibexa_content_type_group                                                |
| ezcontentobject                                       | ibexa_content                                                           |
| ezcontentobject.contentclass_id                       | ibexa_content.content_type_id                                           |
| ezcontentobject_attribute                             | ibexa_content_field                                                     |
| ezcontentobject_attribute.contentclassattribute_id    | ibexa_content_field.content_type_field_definition_id                    |
| ezcontentobject_link                                  | ibexa_content_relation                                                  |
| ezcontentobject_link.contentclassattribute_id         | ibexa_content_relation.content_type_field_definition_id                 |
| ezcontentobject_name                                  | ibexa_content_name                                                      |
| ezcontentobject_trash                                 | ibexa_content_trash                                                     |
| ezcontentobject_tree                                  | ibexa_content_tree                                                      |
| ezcontentobject_version                               | ibexa_content_version                                                   |
| ezdatebasedpublisher_scheduled_entries                | ibexa_scheduler_scheduled_entries                                       |
| ezdfsfile                                             | ibexa_dfs_file                                                          |
| ezeditorialworkflow_markings                          | ibexa_workflow_markings                                                 |
| ezeditorialworkflow_transitions                       | ibexa_workflow_transitions                                              |
| ezeditorialworkflow_workflows                         | ibexa_workflow_workflows                                                |
| ezform_field_attributes                               | ibexa_form_field_attributes                                             |
| ezform_field_validators                               | ibexa_form_field_validators                                             |
| ezform_fields                                         | ibexa_form_fields                                                       |
| ezform_form_submission_data                           | ibexa_form_form_submission_data                                         |
| ezform_form_submissions                               | ibexa_form_form_submissions                                             |
| ezform_forms                                          | ibexa_form_forms                                                        |
| ezgmaplocation                                        | ibexa_map_location                                                      |
| ezimagefile                                           | ibexa_image_file                                                        |
| ezkeyword                                             | ibexa_keyword                                                           |
| ezkeyword_attribute_link                              | ibexa_keyword_field_link                                                |
| ezmedia                                               | ibexa_media                                                             |
| eznode_assignment                                     | ibexa_node_assignment                                                   |
| eznotification                                        | ibexa_notification                                                      |
| ezpackage                                             | ibexa_package                                                           |
| ezpage_attributes                                     | ibexa_page_attributes                                                   |
| ezpage_blocks                                         | ibexa_page_blocks                                                       |
| ezpage_blocks_design                                  | ibexa_page_blocks_design                                                |
| ezpage_blocks_visibility                              | ibexa_page_blocks_visibility                                            |
| ezpage_map_attributes_blocks                          | ibexa_page_map_attributes_blocks                                        |
| ezpage_map_blocks_zones                               | ibexa_page_map_blocks_zones                                             |
| ezpage_map_zones_pages                                | ibexa_page_map_zones_pages                                              |
| ezpage_pages                                          | ibexa_page_pages                                                        |
| ezpage_zones                                          | ibexa_page_zones                                                        |
| ezpolicy                                              | ibexa_policy                                                            |
| ezpolicy_limitation                                   | ibexa_policy_limitation                                                 |
| ezpolicy_limitation_value                             | ibexa_policy_limitation_value                                           |
| ezpreferences                                         | ibexa_preferences                                                       |
| ezrole                                                | ibexa_role                                                              |
| ezsearch_object_word_link                             | ibexa_search_object_word_link                                           |
| ezsearch_object_word_link.contentclass_id             | ibexa_search_object_word_link.content_type_id                           |
| ezsearch_object_word_link.contentclass_attribute_id   | ibexa_search_object_word_link.content_type_field_definition_id          |
| ezsearch_word                                         | ibexa_search_word                                                       |
| ezsection                                             | ibexa_section                                                           |
| ezsite                                                | ibexa_site                                                              |
| ezsite_data                                           | ibexa_site_data                                                         |
| ezsite_public_access                                  | ibexa_site_public_access                                                |
| ezurl                                                 | ibexa_url                                                               |
| ezurl_object_link                                     | ibexa_url_content_link                                                  |
| ezurlalias                                            | ibexa_url_alias                                                         |
| ezurlalias_ml                                         | ibexa_url_alias_ml                                                      |
| ezurlalias_ml_incr                                    | ibexa_url_alias_ml_incr                                                 |
| ezurlwildcard                                         | ibexa_url_wildcard                                                      |
| ezuser                                                | ibexa_user                                                              |
| ezuser_accountkey                                     | ibexa_user_accountkey                                                   |
| ezuser_role                                           | ibexa_user_role                                                         |
| ezuser_setting                                        | ibexa_user_setting                                                      |

DFS (Distributed File System)

If [DFS IO handler](https://doc.ibexa.co/en/5.0/infrastructure_and_maintenance/clustering/clustering/#dfs-io-handler) is used and, as recommended, its table is on its own database, you'll have to rename table and columns there. Here are the DFS renaming queries:

```sql
ALTER TABLE ezdfsfile RENAME TO ibexa_dfs_file;
ALTER TABLE ibexa_dfs_file RENAME INDEX ezdfsfile_name_trunk TO ibexa_dfs_file_name_trunk;
ALTER TABLE ibexa_dfs_file RENAME INDEX ezdfsfile_expired_name TO ibexa_dfs_file_expired_name;
ALTER TABLE ibexa_dfs_file RENAME INDEX ezdfsfile_name TO ibexa_dfs_file_name;
ALTER TABLE ibexa_dfs_file RENAME INDEX ezdfsfile_mtime TO ibexa_dfs_file_mtime;
```

### Update custom code for Ibexa DXP 5.0

See [Ibexa DXP v5.0 deprecations and backwards compatibility breaks](https://doc.ibexa.co/en/5.0/release_notes/ibexa_dxp_v5.0_deprecations/index.md) for the list of changes. The following sections presents some of those changes and how to apply them.

#### Update PHP framework standards

Among other things, previously deprecated classes have been removed, and the type hinting strictness has been increased.

Update the `rector.php` file to use [`IbexaSetList::IBEXA_50`](https://doc.ibexa.co/en/5.0/api/php_api/php_api_reference/classes/Ibexa-Contracts-Rector-Sets-IbexaSetList.html#enumcase_IBEXA_50) rule set. If you didn't edit it the first time, you can run its recipe:

```bash
composer recipe:install ibexa/rector --force --reset --yes
```

You can adjust the other rule sets (for example, the Symfony ones) to match higher versions.

Again, it's recommended to activate one rule set at a time and preview the output by running Rector with the `--dry-run` option to decide which rulesets should be used and in which order.

As this update spans across a broad range of versions, multiple rules can be considered as in the example below.

```php
//…
use Ibexa\Contracts\Rector\Sets\IbexaSetList;
use Rector\Config\RectorConfig;
use Rector\Symfony\Set\SymfonySetList;

return RectorConfig::configure()
    // ...
   ->withSets(
       [
           IbexaSetList::IBEXA_50->value,
           SymfonySetList::SYMFONY_54, // https://getrector.com/find-rule?activeRectorSetGroup=symfony&rectorSet=symfony-symfonysymfony-54
           SymfonySetList::SYMFONY_60, // https://getrector.com/find-rule?activeRectorSetGroup=symfony&rectorSet=symfony-symfonysymfony-60
           SymfonySetList::SYMFONY_61, // https://getrector.com/find-rule?activeRectorSetGroup=symfony&rectorSet=symfony-symfonysymfony-61
           SymfonySetList::SYMFONY_62, // https://getrector.com/find-rule?activeRectorSetGroup=symfony&rectorSet=symfony-symfonysymfony-62
           SymfonySetList::SYMFONY_63, // https://getrector.com/find-rule?activeRectorSetGroup=symfony&rectorSet=symfony-symfonysymfony-63
           SymfonySetList::SYMFONY_64, // https://getrector.com/find-rule?activeRectorSetGroup=symfony&rectorSet=symfony-symfonysymfony-64
           SymfonySetList::SYMFONY_70, // https://getrector.com/find-rule?activeRectorSetGroup=symfony&rectorSet=symfony-symfonysymfony-70
           SymfonySetList::SYMFONY_71, // https://getrector.com/find-rule?activeRectorSetGroup=symfony&rectorSet=symfony-symfonysymfony-71
           SymfonySetList::SYMFONY_72, // https://getrector.com/find-rule?activeRectorSetGroup=symfony&rectorSet=symfony-symfonysymfony-72
           SymfonySetList::SYMFONY_73, // https://getrector.com/find-rule?activeRectorSetGroup=symfony&rectorSet=symfony-symfonysymfony-73
           SymfonySetList::SYMFONY_74, // https://getrector.com/find-rule?activeRectorSetGroup=symfony&rectorSet=symfony-symfonysymfony-74
           SymfonySetList::ANNOTATIONS_TO_ATTRIBUTES,
       ]
   )
   ->withPhpSets()
   ->withComposerBased(twig: true, symfony: true)
   ->withAttributesSets(symfony: true, sensiolabs: true)
   ->withPreparedSets(
       deadCode: true, // https://getrector.com/find-rule?activeRectorSetGroup=core&rectorSet=core-dead-code
       codeQuality: true, // https://getrector.com/find-rule?activeRectorSetGroup=core&rectorSet=core-code-quality
       codingStyle: true, // https://getrector.com/find-rule?activeRectorSetGroup=core&rectorSet=core-coding-style
       typeDeclarations: true, // https://getrector.com/find-rule?activeRectorSetGroup=core&rectorSet=core-type-declarations
       privatization: true, // https://getrector.com/find-rule?activeRectorSetGroup=core&rectorSet=core-privatization
       naming: true, // https://getrector.com/find-rule?activeRectorSetGroup=core&rectorSet=core-naming
       instanceOf: true, // https://getrector.com/find-rule?activeRectorSetGroup=core&rectorSet=core-instanceof
       earlyReturn: true, // https://getrector.com/find-rule?activeRectorSetGroup=core&rectorSet=core-early-return
       rectorPreset: true,
       symfonyCodeQuality: true, // https://getrector.com/find-rule?activeRectorSetGroup=symfony&rectorSet=symfony-code-quality
       symfonyConfigs: true, // https://getrector.com/find-rule?activeRectorSetGroup=symfony&rectorSet=symfony-configs
   );
```

In the following example, you can see optimization thanks to the following features:

- [Constructor parameter promoted as properties](https://www.php.net/manual/en/language.oop5.decon.php#language.oop5.decon.constructor.promotion) (available since PHP 8.0)
- [`AsCommand` attribute to register a command](https://symfony.com/doc/7.4/console.html#creating-a-command) (available since Symfony 6.2)

```diff
+#[AsCommand(name: 'app:test', description: 'Command to test something.')]
 class TestCommand extends Command
 {
-    private Repository $repository;
-
-    public function __construct(Repository $repository)
+    public function __construct(private readonly Repository $repository)
     {
-        $this->repository = $repository;
-        parent::__construct('app:test');
     }
-
-     protected function configure()
-     {
-        $this->setDescription('Command to test something.');
-     }

      protected function execute(InputInterface $input, OutputInterface $output): int
```

#### Update JavaScript

If you haven't renamed your Webpack file since 3.3, do it now as 5.0 no longer supports the old names.

| Old name                    | New name                       |
| --------------------------- | ------------------------------ |
| ez.config.js                | ibexa.config.js                |
| ez.config.manager.js        | ibexa.config.manager.js        |
| ez.webpack.custom.config.js | ibexa.webpack.custom.config.js |

`ibexa/rector` 5.0 also comes with the [JavaScript Transform module](https://github.com/ibexa/rector/blob/v5.0.0/js/README.md) to help you maintain your JavaScript code.

Customize the `rector.config.js` config file by:

- making it match your directory structure
- modifying the list of enabled plugins and their configuration

The example below is made to fix in place the JS files from `asset/js/` directory, and is ready to enable plugin rule sets one at a time (plugin path is relative to `vendor/ibexa/rector/` directory).

```js
module.exports = {
    config: {
        paths: [
            {
                input: 'assets/js',
                output: 'assets/js',
            },
        ],
    },
    plugins: (plugins) => {
        return [
            './js/ibexa-rename-ez-global.js',
            //'./js/ibexa-rename-variables.js',
            //'./js/ibexa-rename-string-values.js',
            //'./js/ibexa-rename-trans-id.js',
            //'./js/ibexa-rename-in-translations.js',
            //'./js/ibexa-rename-icons.js',
        ];
    },
    pluginsConfig: (config) => {
        return config;
    },
};
```

Install the tool dependencies once with the following command:

```bash
yarn --cwd ./vendor/ibexa/rector/js install
```

Run it using the following command:

```bash
yarn --cwd ./vendor/ibexa/rector/js transform
```

##### `webpack.config.js` usage update

To add your customizations back into to the new webpack.config.js, adjust your code to the following changes:

- Contrary to 4.6, in 5.0, `ibexaConfig` isn't available by default in `webpack.config.js`. You have to require then export it.
- The `./ibexa.webpack.config.manager.js` file at project root doesn't exist anymore. To get `ibexaConfigManager`, require it through its alias path `@ibexa/frontend-config/webpack-config/manager`.

```js
const ibexaConfigManager = require('@ibexa/frontend-config/webpack-config/manager');
const getIbexaConfig = require('@ibexa/frontend-config/webpack-config/ibexa');
const ibexaConfig = getIbexaConfig();

ibexaConfigManager.add({
    ibexaConfig,
    //…
});

module.exports = [ibexaConfig, ...customConfigs, projectConfig];
```

#### Update field type identifiers

Several field type identifiers have changed. The old identifiers are still supported, but it's recommended to migrate as soon as possible.

You can list existing field type services with the command `php bin/console debug:container --tag=ibexa.field_type`. The output as an `alias` column with new identifiers and a `legacy_alias` column with the old identifiers.

Field type identifiers renaming map

| Old identifier (`legacy_alias`) | New identifier (`alias`)        |
| ------------------------------- | ------------------------------- |
| ibexa_address                   | ibexa_address                   |
| ezauthor                        | ibexa_author                    |
| ezbinaryfile                    | ibexa_binaryfile                |
| ezboolean                       | ibexa_boolean                   |
| ezcontentquery                  | ibexa_content_query             |
| ezcountry                       | ibexa_country                   |
| ibexa_customer_group            | ibexa_customer_group            |
| ezdate                          | ibexa_date                      |
| ezdatetime                      | ibexa_datetime                  |
| ezemail                         | ibexa_email                     |
| ezfloat                         | ibexa_float                     |
| ezform                          | ibexa_form                      |
| ezgmaplocation                  | ibexa_gmap_location             |
| ezimage                         | ibexa_image                     |
| ezimageasset                    | ibexa_image_asset               |
| ezinteger                       | ibexa_integer                   |
| ezisbn                          | ibexa_isbn                      |
| ezkeyword                       | ibexa_keyword                   |
| ezlandingpage                   | ibexa_landing_page              |
| ezmatrix                        | ibexa_matrix                    |
| ibexa_measurement               | ibexa_measurement               |
| ezmedia                         | ibexa_media                     |
| ezobjectrelation                | ibexa_object_relation           |
| ezobjectrelationlist            | ibexa_object_relation_list      |
| ibexa_product_specification     | ibexa_product_specification     |
| ezrichtext                      | ibexa_richtext                  |
| ezselection                     | ibexa_selection                 |
| ibexa_seo                       | ibexa_seo                       |
| ezstring                        | ibexa_string                    |
| ibexa_taxonomy_entry            | ibexa_taxonomy_entry            |
| ibexa_taxonomy_entry_assignment | ibexa_taxonomy_entry_assignment |
| eztext                          | ibexa_text                      |
| eztime                          | ibexa_time                      |
| ezurl                           | ibexa_url                       |
| ezuser                          | ibexa_user                      |

You may have to update them in several places, for example:

- Update the field identifiers in templates to display or edit fields or their definition. For example, in a `@IbexaCore/content_fields.html.twig` extension, `{% block ezstring_field %)` must be changed for `{% block ibexa_string_field %}`
- Update the field identifiers in migration files

#### Update icons

The provided built-it icon set has been changed.

The `ibexa/rector` JavaScript Transform module's plugin `ibexa-rename-icons.js` refactors the icon usage in JavaScript files. You may have to update them in other contexts, for example, in configuration files associating icons to content types or Page Builder blocks.

The icon library file's path changed from `/bundles/ibexaicons/img/all-icons.svg` to `/bundles/ibexaadminuiassets/vendors/ids-assets/dist/img/all-icons.svg`.

Some icons have been renamed. You can find an [`ibexa-rename-icons` map in `vendor/ibexa/rector/js/rules.config.json` (`"old-name": "new-name"`)](https://github.com/ibexa/rector/blob/v5.0.0/js/rules.config.json#L63).

Icons renaming map

| Old name                | New name                     |
| ----------------------- | ---------------------------- |
| about-info              | help                         |
| about                   | info-square                  |
| airtime                 | signal-radio                 |
| align-center            | align-text-center            |
| align-justify           | align-text-justified         |
| align-left              | align-text-left              |
| align-right             | align-text-right             |
| approved                | check-circle                 |
| article                 | file-text                    |
| assign-section          | assign                       |
| author                  | user-editor                  |
| autosave-error          | cloud-error                  |
| autosave-off            | cloud-discard                |
| autosave-on             | cloud                        |
| autosave-saved          | cloud-check                  |
| autosave-saving         | cloud-synch                  |
| b2b                     | handshake                    |
| back                    | arrow-left                   |
| back-current-date       | calendar-back                |
| bestseller              | badge-star                   |
| block-invisible         | block-hidden                 |
| block-visible-recurring | block-lock                   |
| blog                    | app-blog                     |
| blog_post               | note-blog                    |
| bold                    | text-bold                    |
| bookmark                | favourite-outline            |
| bookmark-active         | favourite-filled             |
| bookmark-manager        | book                         |
| box-collapse            | arrow-move-right             |
| browse                  | folder-browse                |
| bubbles                 | message-bubble               |
| business-deal-cash      | user-money                   |
| button                  | cursor-clicked               |
| campaign                | speaker                      |
| captcha                 | form-captcha                 |
| caret-back              | arrow-chevron-left           |
| caret-double-back       | arrow-double-left            |
| caret-double-next       | arrow-double-right           |
| caret-down              | arrow-chevron-down           |
| caret-expanded          | arrow-double-left            |
| caret-next              | arrow-chevron-right          |
| caret-up                | arrow-chevron-up             |
| cart                    | shopping-cart                |
| cart-full               | shopping-cart                |
| cart-upload             | shopping-cart-arrow-up       |
| cart-wishlist           | shopping-cart-heart          |
| category                | tag                          |
| checkbox                | form-checkbox                |
| checkbox-multiple       | form-check-list              |
| checkmark               | form-check                   |
| circle-caret-down       | chevron-down-circle          |
| circle-caret-left       | chevron-left-circle          |
| circle-caret-right      | chevron-right-circle         |
| circle-caret-up         | chevron-up-circle            |
| circle-close            | discard-circle               |
| circle-create           | add-circle                   |
| circle-minus            | minus-circle                 |
| circle-pause            | minus-circle                 |
| clicked-recommendations | cursor-clicked-hand          |
| clipboard               | clipboard-check              |
| collapse                | arrow-collapse-right         |
| content-write           | file-text-write              |
| column-settings         | table-settings-column        |
| comment                 | message                      |
| components              | box-component                |
| connect                 | connection                   |
| content-draft           | draft                        |
| contentlist             | list-content                 |
| content-list            | list-content                 |
| content-type            | tools                        |
| content-type-content    | file-type                    |
| content-type-group      | tool-group                   |
| copy-subtree            | content-tree-copy            |
| create                  | add                          |
| create-content          | file-add                     |
| create-location         | content-tree-create-location |
| customer                | user-customer                |
| customer-portal         | device-monitor-user          |
| customer-portal-page    | app-user                     |
| customer-type           | device-monitor-type          |
| custom_tags             | prompt                       |
| date                    | calendar                     |
| date-updated            | calendar-reload              |
| discount-coupon         | discount-ticket              |
| drafts                  | edit-draft                   |
| dropdown                | form-dropdown                |
| earth-access            | world-cursor                 |
| embed                   | text-embedded                |
| embed-inline            | text-embedded-inline         |
| erp                     | connection-erp               |
| error                   | exclamation-mark             |
| error-icon              | file-warning                 |
| expand-left             | arrow-expand-left            |
| expand-right            | arrow-expand-right           |
| explore                 | ai                           |
| fields                  | form-input                   |
| file-video              | video                        |
| flash                   | lightning                    |
| focus                   | arrows-outside               |
| focus-image             | focus-target                 |
| folder-empty            | folder-open                  |
| form                    | form-check-square            |
| full-view               | arrows-full-view             |
| future-publication      | calendar-clock               |
| gallery                 | image-gallery                |
| go-right                | arrow-to-right               |
| go-to-root              | content-tree-arrow-up        |
| go-up                   | arrow-to-up                  |
| h1                      | header-1                     |
| h2                      | header-2                     |
| h3                      | header-3                     |
| h4                      | header-4                     |
| h5                      | header-5                     |
| h6                      | header-6                     |
| hide                    | visibility-hidden            |
| hierarchy               | hierarchy-site-map           |
| history-file            | file-history                 |
| 'home-page'             | home                         |
| image-center            | align-block-center           |
| image-editor            | image-edit                   |
| image-left              | align-block-left             |
| image-right             | align-block-right            |
| image-variations        | image-focus                  |
| imported-items          | database-synch               |
| information             | info-square                  |
| input-hidden            | form-input-hidden            |
| input-line              | form-input-single-line       |
| input-line-multiple     | form-input-multi-line        |
| input-number            | form-input-number            |
| interface-block         | forbidden                    |
| italic                  | text-italic                  |
| keyword                 | hash                         |
| landing_page            | layout-navbar                |
| landingpage-add         | layout-navbar-add            |
| landingpage-preview     | layout-navbar-visible        |
| languages               | world                        |
| languages-add           | world-add                    |
| last-purchased          | cursor-clicked-hand          |
| last-viewed             | app-recent                   |
| layout-manager          | layout                       |
| link-content            | file-link                    |
| link-remove             | unlink                       |
| list                    | list-bullet                  |
| list-numbered           | list-number                  |
| localize                | target-location              |
| location-add-new        | content-tree-create-location |
| lock-unlock             | unlock                       |
| logout                  | log-out                      |
| maform                  | chart-histogram              |
| mail                    | message-email                |
| mail-open               | message-email-read           |
| markup                  | file-code                    |
| menu                    | menu-hamburger               |
| move                    | folder-open-move             |
| newsletter              | news                         |
| notice                  | alert-error                  |
| open-newtab             | open-new-window              |
| open-sametab            | open-same-window             |
| options                 | more                         |
| order-history           | file-history                 |
| order-management        | receipt-settings             |
| order-status            | product-search               |
| panels                  | view-panels                  |
| paragraph               | text-paragraph               |
| paragraph-add           | text-paragraph-add           |
| pdf-file                | file-pdf                     |
| personalize             | user-target                  |
| personalize-block       | file-settings                |
| personalize-content     | tag-settings                 |
| pin-unpin               | unpin                        |
| place                   | pin-location                 |
| places                  | pins-locations               |
| portfolio               | suitcase                     |
| previewed               | overdue                      |
| product-category        | product-tag                  |
| product-list            | clipboard-list               |
| product_list            | clipboard-list               |
| product-low             | product-arrow-down           |
| product type            | product-collection           |
| product-type            | product-collection           |
| profile                 | user-profile                 |
| publish                 | rocket                       |
| publish-later           | calendar-number              |
| publish-later-cancel    | calendar-discard             |
| publish-later-create    | calendar-add                 |
| qa-content              | qa-file                      |
| qa-form                 | qa-form-check                |
| radio-button            | form-radio                   |
| radio-button-multiple   | form-radio-list              |
| rate                    | stars                        |
| rate-review             | star-circle                  |
| recent-activity         | activity-clock               |
| recently-added          | history                      |
| recommendation-calls    | arrows-circle                |
| redo                    | action-redo                  |
| refresh                 | arrows-reload                |
| rejected                | arrow-to-down-circle         |
| relations               | hierarchy-square             |
| restore                 | arrow-restore                |
| restore-parent          | content-tree-restore-parent  |
| review                  | message-edit                 |
| roles                   | user-id                      |
| rss                     | signal-rss                   |
| schedule                | calendar-schedule            |
| sections                | database                     |
| send-email              | send                         |
| settings-block          | settings                     |
| settings-config         | settings-configure           |
| sites-all               | sites                        |
| spinner                 | arrow-rotate                 |
| stats                   | chart-dots                   |
| strikethrough           | text-strikethrough           |
| subscriber              | user-mail                    |
| subscript               | text-subscript               |
| superscript             | text-superscript             |
| swap                    | arrows-synchronize           |
| system-information      | info-circle                  |
| trash-empty             | trash-discard                |
| trash-notrashed         | trash-open                   |
| underscore              | text-underline               |
| undo                    | action-undo                  |
| un-focus                | arrows-inside                |
| un-full-view            | arrows-full-view-out         |
| upload-image            | image-upload                 |
| user-blocked            | user-block                   |
| user_group              | user-group                   |
| users-personalization   | user-focus                   |
| user-recycle            | arrows-reload-user           |
| users-select            | users-add                    |
| user-tick               | user-check                   |
| version-compare         | action-compare-versions      |
| version-compare-action  | action-compare               |
| versions                | archived-version             |
| vertical-left-right     | arrow-collapse-expand        |
| view                    | visibility                   |
| view-desktop            | device-monitor               |
| view-hide               | visibility-hidden            |
| view-mobile             | device-mobile                |
| view-tablet             | device-tablet                |
| warning                 | alert-warning                |
| warning-triangle        | alert-warning                |

The following example illustrates the update of a custom page block's icon:

```diff
  ibexa_fieldtype_page:
      blocks:
          event:
              name: About Block
              category: Custom
-             thumbnail: /bundles/ibexaicons/img/all-icons.svg#about
+             thumbnail: /bundles/ibexaadminuiassets/vendors/ids-assets/dist/img/all-icons.svg#info-square
```

### Install new features' schemas

Features which were optional 4.6 LTS Updates are now part of 5.0.0.

- If you have already installed the feature, its schema has been updated by the previous step.
- If you haven't installed the feature, you need to add its schema to your database. Store the SQL of the schema into a file, **review it carefully**, then run it.
- If you mistakenly reinstall a schema, you might encounter "Table already exists" errors which can be ignored.

#### Install AI actions schema

**MySQL**

```bash
php bin/console ibexa:doctrine:schema:dump-sql vendor/ibexa/connector-ai/src/bundle/Resources/config/schema.yaml > schema_connector-ai.sql
# Pause to review schema_connector-ai.sql
mysql -u <username> -p <password> <database_name> < schema_connector-ai.sql
```

**PostgreSQL**

```bash
php bin/console ibexa:doctrine:schema:dump-sql vendor/ibexa/connector-ai/src/bundle/Resources/config/schema.yaml > schema_connector-ai.sql
# Pause to review schema_connector-ai.sql
psql <database_name> < schema_connector-ai.sql
```

#### Install date and time attribute type

**MySQL**

```bash
php bin/console ibexa:doctrine:schema:dump-sql vendor/ibexa/product-catalog-date-time-attribute/src/bundle/Resources/config/schema.yaml > schema_date-time-attribute.sql
# Pause to review schema_date-time-attribute.sql
mysql -u <username> -p <password> <database_name> < schema_date-time-attribute.sql
```

**PostgreSQL**

```bash
php bin/console ibexa:doctrine:schema:dump-sql vendor/ibexa/product-catalog-date-time-attribute/src/bundle/Resources/config/schema.yaml > schema_date-time-attribute.sql
# Pause to review schema_date-time-attribute.sql
psql <database_name> < schema_date-time-attribute.sql
```

#### Install symbol attribute type

**MySQL**

```bash
php bin/console ibexa:doctrine:schema:dump-sql vendor/ibexa/product-catalog-symbol-attribute/src/bundle/Resources/config/schema.yaml > schema_symbol-attribute.sql
# Pause to review schema_symbol-attribute.sql
mysql -u <username> -p <password> <database_name> < schema_symbol-attribute.sql
```

**PostgreSQL**

```bash
php bin/console ibexa:doctrine:schema:dump-sql vendor/ibexa/product-catalog-symbol-attribute/src/bundle/Resources/config/schema.yaml > schema_symbol-attribute.sql
# Pause to review schema_symbol-attribute.sql
psql <database_name> < schema_symbol-attribute.sql
```

#### Install collaboration

**MySQL**

```bash
php bin/console ibexa:doctrine:schema:dump-sql vendor/ibexa/collaboration/src/bundle/Resources/config/schema.yaml > schema_collaboration.sql
php bin/console ibexa:doctrine:schema:dump-sql vendor/ibexa/share/src/bundle/Resources/config/schema.yaml > schema_share.sql
# Pause to review schema_collaboration.sql and schema_share.sql
mysql -u <username> -p <password> <database_name> < schema_collaboration.sql
mysql -u <username> -p <password> <database_name> < schema_share.sql
```

**PostgreSQL**

```bash
php bin/console ibexa:doctrine:schema:dump-sql vendor/ibexa/collaboration/src/bundle/Resources/config/schema.yaml > schema_collaboration.sql
php bin/console ibexa:doctrine:schema:dump-sql vendor/ibexa/share/src/bundle/Resources/config/schema.yaml > schema_share.sql
# Pause to review schema_collaboration.sql and schema_share.sql
psql <database_name> < schema_collaboration.sql
psql <database_name> < schema_share.sql
```

#### Install discounts (Commerce)

**MySQL**

```bash
php bin/console ibexa:doctrine:schema:dump-sql vendor/ibexa/discounts/src/bundle/Resources/config/schema.yaml > schema_discounts.sql
php bin/console ibexa:doctrine:schema:dump-sql vendor/ibexa/discounts-codes/src/bundle/Resources/config/schema.yaml > schema_discounts-codes.sql
# Pause to review schema_discounts.sql and schema_discounts-codes.sql
mysql -u <username> -p <password> <database_name> < schema_discounts.sql
mysql -u <username> -p <password> <database_name> < schema_discounts-codes.sql
```

**PostgreSQL**

```bash
php bin/console ibexa:doctrine:schema:dump-sql vendor/ibexa/discounts/src/bundle/Resources/config/schema.yaml > schema_discounts.sql
php bin/console ibexa:doctrine:schema:dump-sql vendor/ibexa/discounts-codes/src/bundle/Resources/config/schema.yaml > schema_discounts-codes.sql
# Pause to review schema_discounts.sql and schema_discounts-codes.sql
psql <database_name> < schema_discounts.sql
psql <database_name> < schema_discounts-codes.sql
```

### Clear cache pool

The persistence cache pool needs to be cleared to be able to use the repository again.

```bash
php bin/console cache:pool:clear --all
```

### Migrations

#### Taxonomy

```bash
php bin/console ibexa:migrations:import vendor/ibexa/taxonomy/src/bundle/Resources/install/migrations/2025_08_09_14_47_mark_tag_as_container.yaml
php bin/console ibexa:migrations:migrate --file=2025_08_09_14_47_mark_tag_as_container.yaml --siteaccess=admin
```

#### Product catalog

```bash
php bin/console ibexa:migrations:import vendor/ibexa/product-catalog/src/bundle/Resources/migrations/2025_07_09_13_52_mark_product_category_container.yaml
php bin/console ibexa:migrations:migrate --file=2025_07_09_13_52_mark_product_category_container.yaml --siteaccess=admin
```

#### Corporate accounts (Experience, Commerce)

```bash
php bin/console ibexa:migrations:import vendor/ibexa/corporate-account/src/bundle/Resources/migrations/2025_07_08_09_27_set_container_to_company.yaml
php bin/console ibexa:migrations:migrate --file=2025_07_08_09_27_set_container_to_company.yaml --siteaccess=admin
```

### Generate GraphQL schema

GraphQL usage is no longer required for the Ibexa DXP back office. If you are using GraphQL in your project, you can generate its schema by running:

```bash
php bin/console ibexa:graphql:generate-schema
```

### Upgrade GraphQL usage

- In 4.6, pagination for [RelationList field type](https://doc.ibexa.co/en/5.0/content_management/field_types/field_type_reference/relationlistfield/index.md) is disabled by default, and can be enabled using the `ibexa.graphql.schema.ibexa_object_relation_list.enable_pagination` parameter
- In 5.0, pagination for RelationList field type is always activated and can't be disabled. The previous parameter doesn't exist anymore and is ignored if set

If you have code based on `relations` request returning the entire list, you have to update it. For more information, see [Pagination in GraphQL](https://doc.ibexa.co/en/5.0/api/graphql/graphql_queries/#pagination).

### Update search indexes

Ensure your search index is up to date with the following command:

```bash
php bin/console ibexa:reindex
```

### Finalizing

#### Clear cache and rebuild

Finish the update process:

```bash
composer run-script post-update-cmd
```

#### HTTP Cache

Use the newer VCL files. Depending on your reverse proxy, you'll find them in the following directories:

- Varnish: `vendor/ibexa/http-cache/docs/varnish/vcl/`
- Fastly: `vendor/ibexa/fastly/fastly/`

#### Ibexa Cloud

Generate the Ibexa Cloud Platform.sh configuration files, review the changes with your own version, and merge your customizations.

```bash
composer ibexa:setup --platformsh
```

#### Conclusion

Your project is now running Ibexa DXP v5.0, with packages and database schema both up to date.

To learn about configuration updates, PHP API changes, or other changes introduced between v5.0.0 and v5.0.11 that aren't related to the database, see [Update from v5.0.x to v5.0.latest](https://doc.ibexa.co/en/5.0/update_and_migration/from_5.0/update_from_5.0/index.md).