Skip to main content
Version: 2026.2

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.