Skip to content

Update with new Commerce packages

This update procedure applies if you have a v4.3 installation, and you do not use Commerce packages.

Temporary need of Composer conflict

To go through this update, map the conflicting packages in your composer.json file as following:

1
2
3
4
"conflict": {
    "jms/serializer": ">=3.30.0",
    "gedmo/doctrine-extensions": ">=3.12.0"
},
These entries can be removed after fully upgrading to v4.6 LTS.

Update from v4.3.x to v4.3.latest

Before you update to v4.4, you need to go through the following steps to update to the latest maintenance release of v4.3 (v4.3.5).

Update the application to v4.3.latest

Run:

1
composer require ibexa/content:4.3.5 --with-all-dependencies --no-scripts
1
composer require ibexa/experience:4.3.5 --with-all-dependencies --no-scripts
1
composer require ibexa/commerce:4.3.5 --with-all-dependencies --no-scripts

Remove deprecated Field Types

By default, every v4.3 installation has a set of built-in Content Types. Some of them use Field Types deprecated in v4.4, which need to be removed manually. Make sure to remove all occurrences of sesspecificationstype, uivarvarianttype, sesselection, sesprofiledata Field Types from your Content Types.

This step should be performed on the working installation, omitting it will result in an error during update:

1
2
  [Ibexa\Core\Persistence\Legacy\Content\FieldValue\Converter\Exception\NotFound (404)]
  Could not find 'Persistence Field Value Converter' with identifier 'sesspecificationstype'

In that case, you can use Null Field Type to define a replacement for deprecated Field Types in config/services.yaml:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
services:
    ibexa.field_type.sesspecificationstype:
        class: Ibexa\Core\FieldType\Null\Type
        arguments: [sesspecificationstype]
        tags: [{name: ibexa.field_type, alias: sesspecificationstype}]
    ibexa.field_type.sesspecificationstype.converter:
        class: Ibexa\Core\Persistence\Legacy\Content\FieldValue\Converter\NullConverter
        tags: [{name: ibexa.field_type.storage.legacy.converter, alias: sesspecificationstype}]
    ibexa.field_type.sesspecificationstype.indexable:
        class: Ibexa\Core\FieldType\Unindexed
        tags: [{name: ibexa.field_type.indexable, alias: sesspecificationstype}]

    ibexa.field_type.uivarvarianttype:
        class: Ibexa\Core\FieldType\Null\Type
        arguments: [uivarvarianttype]
        tags: [{name: ibexa.field_type, alias: uivarvarianttype}]
    ibexa.field_type.uivarvarianttype.converter:
        class: Ibexa\Core\Persistence\Legacy\Content\FieldValue\Converter\NullConverter
        tags: [{name: ibexa.field_type.storage.legacy.converter, alias: uivarvarianttype}]
    ibexa.field_type.uivarvarianttype.indexable:
        class: Ibexa\Core\FieldType\Unindexed
        tags: [{name: ibexa.field_type.indexable, alias: uivarvarianttype}]

    ibexa.field_type.sesselection:
        class: Ibexa\Core\FieldType\Null\Type
        arguments: [sesselection]
        tags: [{name: ibexa.field_type, alias: sesselection}]
    ibexa.field_type.sesselection.converter:
        class: Ibexa\Core\Persistence\Legacy\Content\FieldValue\Converter\NullConverter
        tags: [{name: ibexa.field_type.storage.legacy.converter, alias: sesselection}]
    ibexa.field_type.sesselection.indexable:
        class: Ibexa\Core\FieldType\Unindexed
        tags: [{name: ibexa.field_type.indexable, alias: sesselection}]

    ibexa.field_type.sesprofiledata:
        class: Ibexa\Core\FieldType\Null\Type
        arguments: [sesprofiledata]
        tags: [{name: ibexa.field_type, alias: sesprofiledata}]
    ibexa.field_type.sesprofiledata.converter:
        class: Ibexa\Core\Persistence\Legacy\Content\FieldValue\Converter\NullConverter
        tags: [{name: ibexa.field_type.storage.legacy.converter, alias: sesprofiledata}]
    ibexa.field_type.sesprofiledata.indexable:
        class: Ibexa\Core\FieldType\Unindexed
        tags: [{name: ibexa.field_type.indexable, alias: sesprofiledata}]

Update from v4.3.latest to v4.4

When you have the latest version of v4.3, you can update to v4.4.

Update the application to v4.4

First, run:

1
2
composer require ibexa/content:4.4.4 --with-all-dependencies --no-scripts
composer recipes:install ibexa/content --force -v
1
2
composer require ibexa/experience:4.4.4 --with-all-dependencies --no-scripts
composer recipes:install ibexa/experience --force -v
1
2
composer require ibexa/commerce:4.4.4 --with-all-dependencies --no-scripts
composer recipes:install ibexa/commerce --force -v

The recipes:install command installs new YAML configuration files. Review the old YAML files and move your custom configuration to the relevant new files

Flysystem v2

Local adapters' directory key changed to location. It is defined in config/packages/oneup_flysystem.yaml:

1
2
3
4
5
oneup_flysystem:
    adapters:
        default_adapter:
            local:
                location: '%kernel.cache_dir%/flysystem'
If you haven't applied custom changes to that file, you can reset the third-party oneup/flysystem-bundle recipe by executing:

1
composer recipe:install --force --reset -- oneup/flysystem-bundle

Remove ibexa/commerce-* packages with dependencies

Remove the following bundles from config/bundles.php. You do not have to remove third-party bundles (FOS\ to JMS\) if they are used by your installation.

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
FOS\CommentBundle\FOSCommentBundle
Tedivm\StashBundle\TedivmStashBundle
WhiteOctober\BreadcrumbsBundle\WhiteOctoberBreadcrumbsBundle
Nelmio\SolariumBundle\NelmioSolariumBundle
JMS\Payment\CoreBundle\JMSPaymentCoreBundle
Joli\ApacheTikaBundle\ApacheTikaBundle
JMS\JobQueueBundle\JMSJobQueueBundle
FOS\RestBundle\FOSRestBundle
JMS\SerializerBundle\JMSSerializerBundle
Ibexa\Bundle\Commerce\Eshop\IbexaCommerceEshopBundle
Ibexa\Bundle\Commerce\ShopTools\IbexaCommerceShopToolsBundle
Ibexa\Bundle\Commerce\Translation\IbexaCommerceTranslationBundle
Ibexa\Bundle\Commerce\Payment\IbexaCommercePaymentBundle
Ibexa\Bundle\Commerce\Price\IbexaCommercePriceBundle
Ibexa\Bundle\Commerce\Tools\IbexaCommerceToolsBundle
Ibexa\Bundle\Commerce\Search\IbexaCommerceSearchBundle
Ibexa\Bundle\Commerce\PriceEngine\IbexaCommercePriceEngineBundle
Ibexa\Bundle\Commerce\SpecificationsType\IbexaCommerceSpecificationsTypeBundle
Ibexa\Bundle\Commerce\BaseDesign\IbexaCommerceBaseDesignBundle
Ibexa\Bundle\Commerce\FieldTypes\IbexaCommerceFieldTypesBundle
Ibexa\Bundle\Commerce\Checkout\IbexaCommerceCheckoutBundle
Ibexa\Bundle\Commerce\ShopUi\IbexaCommerceShopUiBundle
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
FOS\CommentBundle\FOSCommentBundle
Tedivm\StashBundle\TedivmStashBundle
WhiteOctober\BreadcrumbsBundle\WhiteOctoberBreadcrumbsBundle
Nelmio\SolariumBundle\NelmioSolariumBundle
JMS\Payment\CoreBundle\JMSPaymentCoreBundle
Joli\ApacheTikaBundle\ApacheTikaBundle
JMS\JobQueueBundle\JMSJobQueueBundle
FOS\RestBundle\FOSRestBundle
JMS\SerializerBundle\JMSSerializerBundle
Ibexa\Bundle\Commerce\Eshop\IbexaCommerceEshopBundle
Ibexa\Bundle\Commerce\ShopTools\IbexaCommerceShopToolsBundle
Ibexa\Bundle\Commerce\Translation\IbexaCommerceTranslationBundle
Ibexa\Bundle\Commerce\Payment\IbexaCommercePaymentBundle
Ibexa\Bundle\Commerce\Price\IbexaCommercePriceBundle
Ibexa\Bundle\Commerce\Tools\IbexaCommerceToolsBundle
Ibexa\Bundle\Commerce\Search\IbexaCommerceSearchBundle
Ibexa\Bundle\Commerce\PriceEngine\IbexaCommercePriceEngineBundle
Ibexa\Bundle\Commerce\SpecificationsType\IbexaCommerceSpecificationsTypeBundle
Ibexa\Bundle\Commerce\BaseDesign\IbexaCommerceBaseDesignBundle
Ibexa\Bundle\Commerce\FieldTypes\IbexaCommerceFieldTypesBundle
Ibexa\Bundle\Commerce\Checkout\IbexaCommerceCheckoutBundle
Ibexa\Bundle\Commerce\ShopUi\IbexaCommerceShopUiBundle
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
FOS\CommentBundle\FOSCommentBundle
Tedivm\StashBundle\TedivmStashBundle
WhiteOctober\BreadcrumbsBundle\WhiteOctoberBreadcrumbsBundle
Nelmio\SolariumBundle\NelmioSolariumBundle
JMS\Payment\CoreBundle\JMSPaymentCoreBundle
Joli\ApacheTikaBundle\ApacheTikaBundle
JMS\JobQueueBundle\JMSJobQueueBundle
FOS\RestBundle\FOSRestBundle
JMS\SerializerBundle\JMSSerializerBundle
Ibexa\Bundle\Commerce\Eshop\IbexaCommerceEshopBundle
Ibexa\Bundle\Commerce\ShopTools\IbexaCommerceShopToolsBundle
Ibexa\Bundle\Commerce\Translation\IbexaCommerceTranslationBundle
Ibexa\Bundle\Commerce\Payment\IbexaCommercePaymentBundle
Ibexa\Bundle\Commerce\Price\IbexaCommercePriceBundle
Ibexa\Bundle\Commerce\Tools\IbexaCommerceToolsBundle
Ibexa\Bundle\Commerce\Search\IbexaCommerceSearchBundle
Ibexa\Bundle\Commerce\PriceEngine\IbexaCommercePriceEngineBundle
Ibexa\Bundle\Commerce\SpecificationsType\IbexaCommerceSpecificationsTypeBundle
Ibexa\Bundle\Commerce\BaseDesign\IbexaCommerceBaseDesignBundle
Ibexa\Bundle\Commerce\FieldTypes\IbexaCommerceFieldTypesBundle
Ibexa\Bundle\Commerce\Checkout\IbexaCommerceCheckoutBundle
Ibexa\Bundle\Commerce\ShopUi\IbexaCommerceShopUiBundle
# ...
Ibexa\Bundle\Commerce\OneSky\IbexaCommerceOneSkyBundle
Ibexa\Bundle\Commerce\EzStudio\IbexaCommerceEzStudioBundle
Ibexa\Bundle\Commerce\Comparison\IbexaCommerceComparisonBundle
Ibexa\Bundle\Commerce\QuickOrder\IbexaCommerceQuickOrderBundle
Ibexa\Bundle\Commerce\TestTools\IbexaCommerceTestToolsBundle
Ibexa\Bundle\Commerce\Voucher\IbexaCommerceVoucherBundle
Ibexa\Bundle\Commerce\LocalOrderManagement\IbexaCommerceLocalOrderManagementBundle
Ibexa\Bundle\Commerce\Newsletter\IbexaCommerceNewsletterBundle
Ibexa\Bundle\Commerce\OrderHistory\IbexaCommerceOrderHistoryBundle
Ibexa\Bundle\Commerce\ErpAdmin\IbexaCommerceErpAdminBundle
Ibexa\Bundle\Commerce\ShopFrontend\IbexaCommerceShopFrontendBundle
Ibexa\Bundle\Commerce\Basket\IbexaCommerceBasketBundle::class
Ibexa\Bundle\Commerce\Rest\IbexaCommerceRestBundle::class
Ibexa\Bundle\Commerce\AdminUi\IbexaCommerceAdminUiBundle::class
Ibexa\Bundle\Commerce\PageBuilder\IbexaCommercePageBuilderBundle::class
EWZ\Bundle\RecaptchaBundle\EWZRecaptchaBundle::class

Next, remove related extensions' configuration. You do not have to remove third-party bundles (for example config/packages/fos_rest.yaml) if they are used by your installation.

1
2
3
4
5
6
7
8
config/packages/commerce.yaml
config/packages/commerce/autogenerated/.gitkeep
config/packages/commerce/commerce.yaml
config/packages/commerce/commerce_advanced.yaml
config/packages/commerce/commerce_common.yaml
config/packages/commerce/commerce_demo.yaml
config/packages/commerce/commerce_parameters.yaml
config/packages/nelmio_solarium.yaml
1
2
3
4
5
6
7
8
config/packages/commerce.yaml
config/packages/commerce/autogenerated/.gitkeep
config/packages/commerce/commerce.yaml
config/packages/commerce/commerce_advanced.yaml
config/packages/commerce/commerce_common.yaml
config/packages/commerce/commerce_demo.yaml
config/packages/commerce/commerce_parameters.yaml
config/packages/nelmio_solarium.yaml
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
config/packages/commerce.yaml
config/packages/commerce/autogenerated/.gitkeep
config/packages/commerce/commerce.yaml
config/packages/commerce/commerce_advanced.yaml
config/packages/commerce/commerce_common.yaml
config/packages/commerce/commerce_demo.yaml
config/packages/commerce/commerce_parameters.yaml
config/packages/dev/ewz_recaptcha.yaml
config/packages/dev/jms_serializer.yaml
config/packages/ewz_recaptcha.yaml
config/packages/ezcommerce/autogenerated/commerce_repository_parameters.yaml
config/packages/fos_rest.yaml
config/packages/google_recaptcha.yaml
config/packages/jms_serializer.yaml
config/packages/nelmio_solarium.yaml
config/packages/prod/jms_serializer.yaml

Finally, remove related routes by deleting config/routes/ibexa_commerce.yaml file.

Update the database

Next, update the database if you are using Ibexa Commerce. Ibexa Content and Ibexa Experience do not require the database update.

Caution

Always back up your data before running any database update scripts.

After updating the database, clear the cache.

Do not use --force argument for mysql / psql commands when performing update queries. If there is any problem during the update, it is 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.

Apply the following database update scripts:

1
mysql -u <username> -p <password> <database_name> < vendor/ibexa/installer/upgrade/db/mysql/commerce/ibexa-4.3.latest-to-4.4.0.sql
1
psql <database_name> < vendor/ibexa/installer/upgrade/db/postgresql/commerce/ibexa-4.3.latest-to-4.4.0.sql

Ibexa Open Source

If you have no access to Ibexa DXP's ibexa/installer package, database upgrade is not necessary.

Ensure password safety

Following Security advisory: IBEXA-SA-2022-009, unless you can verify based on your log files that the vulnerability has not been exploited, you should revoke passwords for all affected users.

Finish code update

Finish the code update by running:

1
composer run post-install-cmd

Run data migration

Customer Portal self-registration

If you are using Ibexa Experience or Ibexa Commerce, you can now run data migration required by the Customer Portal applications feature to finish the update process:

1
2
php bin/console ibexa:migrations:import vendor/ibexa/corporate-account/src/bundle/Resources/migrations/application_internal_fields.yaml --name=2022_11_07_22_46_application_internal_fields.yaml
php bin/console ibexa:migrations:migrate --file=2022_11_07_22_46_application_internal_fields.yaml