Skip to main content
Version: Next

Upgrade Information

Following steps are necessary during updating to newer versions.

Upgrade to 2026.2.2​

Frontend Build Ships as a Packaged Archive​

The compiled Studio frontend is no longer committed as an expanded src/Resources/public/studio/build/ directory. It now ships as a single archive (build-dist/build-<id>.zip) that is extracted into src/Resources/public/studio/build/ automatically during cache warmup.

pimcore/studio-ui-bundle ^2026.2.1 is now required, as it provides the archive extraction.

Note: Read-only filesystem deployments must run bin/console cache:warmup (or cache:clear) during the build/deploy phase while the bundle directory (usually under vendor/) is still writable. Standard Pimcore deployments already do this. When assets:install runs in copy mode, run cache:warmup before it, otherwise no frontend assets are copied. If the filesystem becomes read-only before the first warmup, the bundle fails with BuildArchiveNotWritableException because there is no build to serve.

Upgrade to 2026.1.0​

PHP / Symfony Requirements​

  • Added support for PHP 8.5
  • Dropped PHP 8.3 and Symfony 6 support; upgrade to PHP 8.4+ and Symfony 7 before updating to this version
  • Dropped symfony/scheduler ^6.4 support; ^7.2 is now required

Removed Admin Classic UI (ExtJS) Support​

The bundle no longer supports the Pimcore Admin Classic UI (ExtJS). All ExtJS-related code and assets have been removed:

  • PimcoreStatisticsExplorerBundle no longer implements PimcoreBundleAdminClassicInterface and no longer uses BundleAdminClassicTrait
  • Removed method: PimcoreStatisticsExplorerBundle::getJsPaths()
  • Deleted ExtJS JavaScript assets:
    • src/Resources/public/js/pimcore/customreports/statisticsExplorerList.js
    • src/Resources/public/js/pimcore/customreports/statisticsExplorerStatistic.js
    • src/Resources/public/js/pimcore/customreports/statisticsFilter.js

The bundle now exclusively supports Pimcore Studio. pimcore/studio-ui-bundle is now a required dependency.

Removed / Replaced Classes​

  • Pimcore\Bundle\StatisticsExplorerBundle\Controller\CustomReportsAdapterController has been removed; it is replaced by the new Pimcore\Bundle\StatisticsExplorerBundle\Controller\StatisticsController
  • Pimcore\Bundle\StatisticsExplorerBundle\Routing\StudioRouteLoader has been removed; routing is now handled via standard Symfony attribute routing

Routing Changes​

  • The custom route loader type pimcore_statistics_explorer_studio is no longer available
  • Studio backend routes are now loaded unconditionally (no longer conditional on PimcoreStudioBackendBundle presence)
  • A new route group pimcore_statistics_explorer is registered under the prefix /pimcore-statistics-explorer for all controllers in the Controller namespace

Bundle Extension Changes​

  • PimcoreStatisticsExplorerExtension now unconditionally loads studio_backend.yaml and studio_ui.yaml; previously these were only loaded when the respective bundles were detected in the container

Upgrade to 2.0.0​

  • Removed support for Elasticsearch 6 and 7, added Elasticsearch 8 support
  • Changed Elasticsearch client configuration, details see Configuration.

Upgrade to 1.3.0​

  • Execute all migrations of the bundle.

Upgrade to Pimcore X​

  • Update to latest (allowed) bundle version in Pimcore 6.9 and execute all migrations.
  • Then update to Pimcore X.