Skip to main content
Version: 2026.1

Upgrade Information

Following steps are necessary during updating to newer versions.

Upgrade to 2026.1.0​

PHP & Symfony Version Requirements​

  • Added support for PHP 8.5.
  • Removed support for PHP 8.3 and Symfony v6. Upgrade to PHP 8.4+ and Symfony 7 before updating to this version.

Removed Admin Classic (ExtJS) Support​

  • PimcoreWebToPrintBundle no longer implements PimcoreBundleAdminClassicInterface and no longer uses BundleAdminClassicTrait. All ExtJS-based Admin Classic UI assets have been removed.
  • The following ExtJS JavaScript files have been removed and are no longer served:
    • public/js/startup.js
    • public/js/settings.js
    • public/js/document/printabstract.js
    • public/js/document/printcontainer.js
    • public/js/document/printpage.js
    • public/js/document/printpages/pdf_preview.js
  • The CSS files public/css/icons.css and public/css/print/print-printermarks.css have been removed.
  • The getCssPaths() and getJsPaths() methods have been removed from PimcoreWebToPrintBundle.

Removed Admin Classic Controllers​

  • The following Admin Classic controllers have been removed entirely (they were @internal):
    • Pimcore\Bundle\WebToPrintBundle\Controller\Document\PrintcontainerController
    • Pimcore\Bundle\WebToPrintBundle\Controller\Document\PrintpageController
    • Pimcore\Bundle\WebToPrintBundle\Controller\Document\PrintpageControllerBase
    • Pimcore\Bundle\WebToPrintBundle\Controller\SettingsController
  • Pimcore\Bundle\WebToPrintBundle\Routing\StudioRouteLoader has been removed.

Removed EventListener​

  • Pimcore\Bundle\WebToPrintBundle\EventListener\IndexSettingsListener has been removed.

Interface Changes​

  • Pimcore\Bundle\WebToPrintBundle\Service\DownloadServiceInterface: The @throws declarations on pdfDownload() and pdfStream() have been updated — NotFoundException and UserNotFoundException are no longer declared as thrown exceptions. Both methods now only declare @throws ForbiddenException. If you have custom implementations of this interface, remove the corresponding NotFoundException and UserNotFoundException imports and @throws annotations.

Gotenberg Processor Improvements​

  • Pimcore\Bundle\WebToPrintBundle\Processor\Gotenberg: Removed the BC compatibility layer for gotenberg-php v1. The processor now requires gotenberg-php v2+ and always calls ->pdf() on the Chromium builder.
  • The base URL for Gotenberg is now resolved from pimcore.gotenberg.base_url system config with a fallback to $processParams['hostUrl'].
  • The BC compatibility methods userAgent(), pdfFormat() from gotenberg-php v1 are no longer conditionally called.

Studio Backend / Studio UI Services​

  • PimcoreStudioBackendBundle and PimcoreStudioUiBundle are now required dependencies. The conditional loading of their service configurations has been removed — the studio backend and studio UI configurations are now always loaded unconditionally.

Studio Frontend — Gotenberg Settings​

  • Added Gotenberg configuration panel in the Pimcore Studio UI settings. The settings form now conditionally renders either the PDFreactor or Gotenberg panel based on the selected tool.

Upgrade to 2.0.0​

  • [Processor] Removed support for standalone chromium. Use Processor Gotenberg instead.