last reviewed: 30.09.2021
Basilicom Thumbnail bundle for Pimcore
Enables asynchronous, worker based thumbnail creation.
Adding a lot of high resolution images to a Pimcore system can cause high load situations. This is mitigated by deferring thumbnail creation via jobs.
If a new asset is added to the system, the normal instant thumbnail generation is prevented and a default placeholder thumbnail is added instead. Simultaneously, a thumbnail creation job is added for the Symfony messenger component. Once the message is processed, the placeholder image is being replaced with the correct thumbnail.
GPLv3 - see: gpl-3.0.txt
- Pimcore >= 6.0.0
- RabbitMQ if using the rabbitmq transport (for ampq on PHP 7.3 see: https://github.com/pdezwart/php-amqp/issues/337)
- php-redis >= 4.3 if using the redis transport
- redis server >= 4.3 if using the redis transport (needs XREADGROUP support)
1) Install the bundle using composer
composer require basilicom/thumbnail-bundle.
3) Configure the bundle (see below)
bin/console pimcore:bundle:enable BasilicomThumbnailBundle.
0) As long as there is no patch preventing Pimcore from
generating system thumbnails, change
update the line
$path = $this->getThumbnail(Image\Thumbnail\Config::getPreviewConfig())->getFileSystemPath(); to
$path = $this->getThumbnail(Image\Thumbnail\Config::getPreviewConfig())->getFileSystemPath(true);
1) Disable low quality preview generation:
# app/config/config.yml pimcore: assets: image: low_quality_image_preview: enabled: false
2) Configure the Symfony Messenger (see https://symfony.com/doc/current/messenger.html).
# app/config/local/messenger.yaml framework: messenger: transports: #sample format: #async: "%env(MESSENGER_TRANSPORT_DSN)%" # sample redis transport, tested: async: "redis://redis:6379/messages" #doctrine does not work on pimcore, as only dbal is loaded, not doctrine! #async: "doctrine://default" # sample rabbitmq, tested: #async: "amqp://rabbitmq:rabbitmq@rabbitmq:5672/%2f/messages" routing: # async is whatever name you gave your transport above 'Basilicom\ThumbnailBundle\Message\ThumbnailJob': async # The bus that is going to be injected when injecting MessageBusInterface default_bus: command.bus buses: command.bus: middleware: - validation
3) Process async messenges (jobs) via console
(or supervisord, see: https://symfony.com/doc/current/messenger.html)
-vv to see individually processed messages
Configure additional thumbnail formats
If there is a text property
thumbnailConfig on the asset
(possibly inherited from a parent folder) containing a
comma separated list of asset format names, thumbnails
for these formats are going to be generated, too.
Configure thumbnail placeholders
@todo not implemented, yet