Upgrade Information
The following steps are necessary during updating to newer versions.
Upgrade to 2026.1.0
PHP & Symfony Version Support
- Added support for
PHP8.5. - Removed support for
PHP8.3and Symfonyv6.
Removed Admin Classic / ExtJS UI
- Removed
pimcore/admin-ui-classic-bundledependency. The bundle no longer implementsPimcoreBundleAdminClassicInterfaceor usesBundleAdminClassicTrait. - Removed all ExtJS-based JavaScript and CSS paths (
getCssPaths(),getJsPaths()methods removed fromPimcoreDataQualityManagementBundle). PimcoreAdminBundleis no longer registered as a dependent bundle.TreeBadgeServiceandTreeBadgeServiceInterfacehave been removed (they were@internal).
Interface & Return Type Changes
RuleDefinitionInterface::getSuggestion(): The parameterarray $objectDatahas been replaced byConcrete $object. Any custom rule definitions implementing this interface must be updated to accept aPimcore\Model\DataObject\Concreteinstance instead of an array.AbstractRuleDefinition::getSuggestion(): Same change as above. Custom classes extendingAbstractRuleDefinitionmust update theirgetSuggestion()signature fromarray $objectDatatoConcrete $object.ScoreServiceInterface::calculateScores(): Added new required parameterarray $fieldDefinitionsbetween$dataObjectand$skipSaving. Custom implementations ofScoreServiceInterfacemust be updated.- Old:
calculateScores(Concrete $dataObject, bool $skipSaving = false): void - New:
calculateScores(Concrete $dataObject, array $fieldDefinitions, bool $skipSaving = false): void
- Old:
DetailWidgetHydratorInterface::hydrate(): The parameterarray $objectDatahas been replaced byConcrete $object. Note: this interface is@internal.RuleDataHydratorInterface::hydrate(): The parameterarray $objectDatahas been replaced byConcrete $object. Note: this interface is@internal.
Messenger Transport Configuration
- The messenger transport DSN is now configurable via the
%pimcore.messenger.transport_dsn_prefix%container parameter instead of being hardcoded todoctrine://default. This allows the installer to wire the transport DSN from environment variables (e.g.PIMCORE_MESSENGER_TRANSPORT_DSN_PREFIX).
Studio UI Enhancements
- Added Studio class editor field type support for the Data Quality field definition, including rule definition configuration via the Studio UI.
Doctrine
- Removed Doctrine enum mapping from the bundle test configuration.
Upgrade to 1.6.0
- Added
Pimcore Studio Backend Bundlesupport. - [Custom Rules] Please note that data structure of parameter
$objectDataofgetSuggestion()method differs for Studio Backend. You might need to adjust your custom rule definitions suggestions. See Studio documentation for more information.