vendor/pimcore/pimcore/models/Asset/Image/Thumbnail.php line 128

Open in your IDE?
  1. <?php
  3. /**
  4.  * Pimcore
  5.  *
  6.  * This source file is available under two different licenses:
  7.  * - GNU General Public License version 3 (GPLv3)
  8.  * - Pimcore Commercial License (PCL)
  9.  * Full copyright and license information is available in
  10.  * LICENSE.md which is distributed with this source code.
  11.  *
  12.  *  @copyright  Copyright (c) Pimcore GmbH (http://www.pimcore.org)
  13.  *  @license    http://www.pimcore.org/license     GPLv3 and PCL
  14.  */
  16. namespace Pimcore\Model\Asset\Image;
  18. use Pimcore\Event\AssetEvents;
  19. use Pimcore\Event\FrontendEvents;
  20. use Pimcore\Logger;
  21. use Pimcore\Model\Asset;
  22. use Pimcore\Model\Asset\Image;
  23. use Pimcore\Model\Asset\Thumbnail\ImageThumbnailTrait;
  24. use Pimcore\Model\Exception\NotFoundException;
  25. use Pimcore\Tool;
  26. use Symfony\Component\EventDispatcher\GenericEvent;
  28. final class Thumbnail
  29. {
  30.     use ImageThumbnailTrait;
  32.     /**
  33.      * @internal
  34.      *
  35.      * @var bool[]
  36.      */
  37.     protected static $hasListenersCache = [];
  39.     /**
  40.      * @param Image $asset
  41.      * @param string|array|Thumbnail\Config|null $config
  42.      * @param bool $deferred
  43.      */
  44.     public function __construct($asset, $config = null, $deferred = true)
  45.     {
  46.         $this->asset = $asset;
  47.         $this->deferred = $deferred;
  48.         $this->config = $this->createConfig($config);
  49.     }
  51.     /**
  52.      * @param bool $deferredAllowed
  53.      * @param bool $cacheBuster
  54.      *
  55.      * @return string
  56.      */
  57.     public function getPath($deferredAllowed = true, $cacheBuster = false)
  58.     {
  59.         $pathReference = null;
  60.         if ($this->getConfig()) {
  61.             if ($this->useOriginalFile($this->asset->getFilename()) && $this->getConfig()->isSvgTargetFormatPossible()) {
  62.                 // we still generate the raster image, to get the final size of the thumbnail
  63.                 // we use getRealFullPath() here, to avoid double encoding (getFullPath() returns already encoded path)
  64.                 $pathReference = [
  65.                     'src' => $this->asset->getRealFullPath(),
  66.                     'type' => 'asset',
  67.                 ];
  68.             }
  69.         }
  71.         if (!$pathReference) {
  72.             $pathReference = $this->getPathReference($deferredAllowed);
  73.         }
  75.         $path = $this->convertToWebPath($pathReference);
  77.         if ($cacheBuster) {
  78.             $path = $this->addCacheBuster($path, ['cacheBuster' => true], $this->getAsset());
  79.         }
  81.         if ($this->hasListeners(FrontendEvents::ASSET_IMAGE_THUMBNAIL)) {
  82.             $event = new GenericEvent($this, [
  83.                 'pathReference' => $pathReference,
  84.                 'frontendPath' => $path,
  85.             ]);
  86.             \Pimcore::getEventDispatcher()->dispatch($event, FrontendEvents::ASSET_IMAGE_THUMBNAIL);
  87.             $path = $event->getArgument('frontendPath');
  88.         }
  90.         return $path;
  91.     }
  93.     /**
  94.      * @param string $eventName
  95.      *
  96.      * @return bool
  97.      */
  98.     protected function hasListeners(string $eventName): bool
  99.     {
  100.         if (!isset(self::$hasListenersCache[$eventName])) {
  101.             self::$hasListenersCache[$eventName] = \Pimcore::getEventDispatcher()->hasListeners($eventName);
  102.         }
  104.         return self::$hasListenersCache[$eventName];
  105.     }
  107.     /**
  108.      * @param string $filename
  109.      *
  110.      * @return bool
  111.      */
  112.     protected function useOriginalFile($filename)
  113.     {
  114.         if ($this->getConfig()) {
  115.             if (!$this->getConfig()->isRasterizeSVG() && preg_match("@\.svgz?$@", $filename)) {
  116.                 return true;
  117.             }
  118.         }
  120.         return false;
  121.     }
  123.     /**
  124.      * @internal
  125.      *
  126.      * @param bool $deferredAllowed
  127.      */
  128.     public function generate($deferredAllowed = true)
  129.     {
  130.         $deferred = false;
  131.         $generated = false;
  133.         if ($this->asset && empty($this->pathReference)) {
  134.             // if no correct thumbnail config is given use the original image as thumbnail
  135.             if (!$this->config) {
  136.                 $this->pathReference = [
  137.                     'type' => 'asset',
  138.                     'src' => $this->asset->getRealFullPath(),
  139.                 ];
  140.             } else {
  141.                 try {
  142.                     $deferred = $deferredAllowed && $this->deferred;
  143.                     $this->pathReference = Thumbnail\Processor::process($this->asset, $this->config, null, $deferred, $generated);
  144.                 } catch (\Exception $e) {
  145.                     Logger::error("Couldn't create thumbnail of image " . $this->asset->getRealFullPath());
  146.                     Logger::error($e->getMessage());
  147.                 }
  148.             }
  149.         }
  151.         if (empty($this->pathReference)) {
  152.             $this->pathReference = [
  153.                 'type' => 'error',
  154.                 'src' => '/bundles/pimcoreadmin/img/filetype-not-supported.svg',
  155.             ];
  156.         }
  158.         if ($this->hasListeners(AssetEvents::IMAGE_THUMBNAIL)) {
  159.             $event = new GenericEvent($this, [
  160.                 'deferred' => $deferred,
  161.                 'generated' => $generated,
  162.             ]);
  163.             \Pimcore::getEventDispatcher()->dispatch($event, AssetEvents::IMAGE_THUMBNAIL);
  164.         }
  165.     }
  167.     /**
  168.      * @return string Public path to thumbnail image.
  169.      */
  170.     public function __toString()
  171.     {
  172.         return $this->getPath(true);
  173.     }
  175.     /**
  176.      * @param string $path
  177.      * @param array $options
  178.      * @param Asset $asset
  179.      *
  180.      * @return string
  181.      */
  182.     private function addCacheBuster(string $path, array $options, Asset $asset): string
  183.     {
  184.         if (isset($options['cacheBuster']) && $options['cacheBuster']) {
  185.             if (!str_starts_with($path, 'http')) {
  186.                 $path = '/cache-buster-' . $asset->getVersionCount() . $path;
  187.             }
  188.         }
  190.         return $path;
  191.     }
  193.     private function getSourceTagHtml(Image\Thumbnail\Config $thumbConfig, string $mediaQuery, Image $image, array $options): string
  194.     {
  195.         $sourceTagAttributes = [];
  196.         $sourceTagAttributes['srcset'] = $this->getSrcset($thumbConfig, $image, $options, $mediaQuery);
  197.         $thumb = $image->getThumbnail($thumbConfig, true);
  199.         if ($mediaQuery) {
  200.             $sourceTagAttributes['media'] = $mediaQuery;
  201.             $thumb->reset();
  202.         }
  204.         if (isset($options['previewDataUri'])) {
  205.             $sourceTagAttributes['data-srcset'] = $sourceTagAttributes['srcset'];
  206.             unset($sourceTagAttributes['srcset']);
  207.         }
  209.         if (!isset($options['disableWidthHeightAttributes'])) {
  210.             if ($thumb->getWidth()) {
  211.                 $sourceTagAttributes['width'] = $thumb->getWidth();
  212.             }
  214.             if ($thumb->getHeight()) {
  215.                 $sourceTagAttributes['height'] = $thumb->getHeight();
  216.             }
  217.         }
  219.         $sourceTagAttributes['type'] = $thumb->getMimeType();
  221.         $sourceCallback = $options['sourceCallback'] ?? null;
  222.         if ($sourceCallback) {
  223.             $sourceTagAttributes = $sourceCallback($sourceTagAttributes);
  224.         }
  226.         return '<source ' . array_to_html_attribute_string($sourceTagAttributes) . ' />';
  227.     }
  229.     /**
  230.      * Get generated HTML for displaying the thumbnail image in a HTML document.
  231.      *
  232.      * @param array $options Custom configuration
  233.      *
  234.      * @return string
  235.      */
  236.     public function getHtml($options = [])
  237.     {
  238.         /** @var Image $image */
  239.         $image = $this->getAsset();
  240.         $thumbConfig = $this->getConfig();
  242.         $pictureTagAttributes = $options['pictureAttributes'] ?? []; // this is used for the html5 <picture> element
  244.         if ((isset($options['lowQualityPlaceholder']) && $options['lowQualityPlaceholder']) && !Tool::isFrontendRequestByAdmin()) {
  245.             $previewDataUri = $image->getLowQualityPreviewDataUri();
  246.             if (!$previewDataUri) {
  247.                 // use a 1x1 transparent GIF as a fallback if no LQIP exists
  248.                 $previewDataUri = 'data:image/gif;base64,R0lGODlhAQABAIAAAAAAAP///yH5BAEAAAAALAAAAAABAAEAAAIBRAA7';
  249.             }
  251.             // this gets used in getImagTag() later
  252.             $options['previewDataUri'] = $previewDataUri;
  253.         }
  255.         $isAutoFormat = $thumbConfig instanceof Image\Thumbnail\Config ? strtolower($thumbConfig->getFormat()) === 'source' : false;
  257.         if ($isAutoFormat) {
  258.             // ensure the default image is not WebP
  259.             $this->pathReference = [];
  260.         }
  262.         $pictureCallback = $options['pictureCallback'] ?? null;
  263.         if ($pictureCallback) {
  264.             $pictureTagAttributes = $pictureCallback($pictureTagAttributes);
  265.         }
  267.         $html = '<picture ' . array_to_html_attribute_string($pictureTagAttributes) . '>' . "\n";
  269.         if ($thumbConfig instanceof Image\Thumbnail\Config) {
  270.             $mediaConfigs = $thumbConfig->getMedias();
  272.             // currently only max-width is supported, the key of the media is WIDTHw (eg. 400w) according to the srcset specification
  273.             ksort($mediaConfigs, SORT_NUMERIC);
  274.             array_push($mediaConfigs, $thumbConfig->getItems()); //add the default config at the end - picturePolyfill v4
  276.             foreach ($mediaConfigs as $mediaQuery => $config) {
  277.                 $sourceHtml = $this->getSourceTagHtml($thumbConfig, $mediaQuery, $image, $options);
  278.                 if (!empty($sourceHtml)) {
  279.                     if ($isAutoFormat) {
  280.                         foreach ($thumbConfig->getAutoFormatThumbnailConfigs() as $autoFormatConfig) {
  281.                             $autoFormatThumbnailHtml = $this->getSourceTagHtml($autoFormatConfig, $mediaQuery, $image, $options);
  282.                             if (!empty($autoFormatThumbnailHtml)) {
  283.                                 $html .= "\t" . $autoFormatThumbnailHtml . "\n";
  284.                             }
  285.                         }
  286.                     }
  288.                     $html .= "\t" . $sourceHtml . "\n";
  289.                 }
  290.             }
  291.         }
  293.         if (!($options['disableImgTag'] ?? null)) {
  294.             $html .= "\t" . $this->getImageTag($options) . "\n";
  295.         }
  297.         $html .= '</picture>' . "\n";
  299.         if (isset($options['useDataSrc']) && $options['useDataSrc']) {
  300.             $html = preg_replace('/ src(set)?=/i', ' data-src$1=', $html);
  301.         }
  303.         return $html;
  304.     }
  306.     /**
  307.      * @param array $options
  308.      * @param array $removeAttributes
  309.      *
  310.      * @return string
  311.      */
  312.     public function getImageTag(array $options = [], array $removeAttributes = []): string
  313.     {
  314.         /** @var Image $image */
  315.         $image = $this->getAsset();
  316.         $attributes = $options['imgAttributes'] ?? [];
  317.         $callback = $options['imgCallback'] ?? null;
  319.         if (isset($options['previewDataUri'])) {
  320.             $attributes['src'] = $options['previewDataUri'];
  321.         } else {
  322.             $path = $this->getPath(true);
  323.             $attributes['src'] = $this->addCacheBuster($path, $options, $image);
  324.         }
  326.         if (!isset($options['disableWidthHeightAttributes'])) {
  327.             if ($this->getWidth()) {
  328.                 $attributes['width'] = $this->getWidth();
  329.             }
  331.             if ($this->getHeight()) {
  332.                 $attributes['height'] = $this->getHeight();
  333.             }
  334.         }
  336.         $altText = !empty($options['alt']) ? $options['alt'] : (!empty($attributes['alt']) ? $attributes['alt'] : '');
  337.         $titleText = !empty($options['title']) ? $options['title'] : (!empty($attributes['title']) ? $attributes['title'] : '');
  339.         if (empty($titleText) && (!isset($options['disableAutoTitle']) || !$options['disableAutoTitle'])) {
  340.             if ($image->getMetadata('title')) {
  341.                 $titleText = $image->getMetadata('title');
  342.             }
  343.         }
  345.         if (empty($altText) && (!isset($options['disableAutoAlt']) || !$options['disableAutoAlt'])) {
  346.             if ($image->getMetadata('alt')) {
  347.                 $altText = $image->getMetadata('alt');
  348.             } elseif (isset($options['defaultalt'])) {
  349.                 $altText = $options['defaultalt'];
  350.             } else {
  351.                 $altText = $titleText;
  352.             }
  353.         }
  355.         // get copyright from asset
  356.         if ($image->getMetadata('copyright') && (!isset($options['disableAutoCopyright']) || !$options['disableAutoCopyright'])) {
  357.             if (!empty($altText)) {
  358.                 $altText .= ' | ';
  359.             }
  360.             if (!empty($titleText)) {
  361.                 $titleText .= ' | ';
  362.             }
  363.             $altText .= ('© ' . $image->getMetadata('copyright'));
  364.             $titleText .= ('© ' . $image->getMetadata('copyright'));
  365.         }
  367.         $attributes['alt'] = $altText;
  368.         if (!empty($titleText)) {
  369.             $attributes['title'] = $titleText;
  370.         }
  372.         if (!isset($attributes['loading'])) {
  373.             $attributes['loading'] = 'lazy';
  374.         }
  376.         foreach ($removeAttributes as $attribute) {
  377.             unset($attributes[$attribute]);
  378.         }
  380.         if ($callback) {
  381.             $attributes = $callback($attributes);
  382.         }
  384.         $thumbConfig = $this->getConfig();
  385.         if ($thumbConfig) {
  386.             $srcsetAttribute = isset($options['previewDataUri']) ? 'data-srcset' : 'srcset';
  388.             $attributes[$srcsetAttribute] = $this->getSrcset($thumbConfig, $image, $options);
  389.         }
  391.         $htmlImgTag = '';
  392.         if (!empty($attributes)) {
  393.             $htmlImgTag = '<img ' . array_to_html_attribute_string($attributes) . ' />';
  394.         }
  396.         return $htmlImgTag;
  397.     }
  399.     /**
  400.      * @param string $name
  401.      * @param int $highRes
  402.      *
  403.      * @return Thumbnail
  404.      *
  405.      * @throws \Exception
  406.      */
  407.     public function getMedia($name, $highRes = 1)
  408.     {
  409.         $thumbConfig = $this->getConfig();
  410.         $mediaConfigs = $thumbConfig->getMedias();
  412.         if (isset($mediaConfigs[$name])) {
  413.             $thumbConfigRes = clone $thumbConfig;
  414.             $thumbConfigRes->selectMedia($name);
  415.             $thumbConfigRes->setHighResolution($highRes);
  416.             $thumbConfigRes->setMedias([]);
  417.             /** @var Image $asset */
  418.             $asset = $this->getAsset();
  419.             $thumb = $asset->getThumbnail($thumbConfigRes);
  421.             return $thumb;
  422.         } else {
  423.             throw new \Exception("Media query '" . $name . "' doesn't exist in thumbnail configuration: " . $thumbConfig->getName());
  424.         }
  425.     }
  427.     /**
  428.      * Get a thumbnail image configuration.
  429.      *
  430.      * @param string|array|Thumbnail\Config $selector Name, array or object describing a thumbnail configuration.
  431.      *
  432.      * @return Thumbnail\Config
  433.      *
  434.      * @throws NotFoundException
  435.      */
  436.     private function createConfig($selector)
  437.     {
  438.         $thumbnailConfig = Thumbnail\Config::getByAutoDetect($selector);
  440.         if (!empty($selector) && $thumbnailConfig === null) {
  441.             throw new NotFoundException('Thumbnail definition "' . (is_string($selector) ? $selector : '') . '" does not exist');
  442.         }
  444.         return $thumbnailConfig;
  445.     }
  447.     /**
  448.      * Get value that can be directly used ina srcset HTML attribute for images.
  449.      *
  450.      * @param Image\Thumbnail\Config $thumbConfig
  451.      * @param Image $image
  452.      * @param array $options
  453.      * @param string|null $mediaQuery Can be empty string if no media queries are defined.
  454.      *
  455.      * @return string Relative paths to different thunbnail images with 1x and 2x resolution
  456.      */
  457.     private function getSrcset(Image\Thumbnail\Config $thumbConfig, Image $image, array $options, ?string $mediaQuery = null): string
  458.     {
  459.         $srcSetValues = [];
  460.         foreach ([1, 2] as $highRes) {
  461.             $thumbConfigRes = clone $thumbConfig;
  462.             if ($mediaQuery) {
  463.                 $thumbConfigRes->selectMedia($mediaQuery);
  464.             }
  465.             $thumbConfigRes->setHighResolution($highRes);
  466.             $thumb = $image->getThumbnail($thumbConfigRes, true);
  468.             $descriptor = $highRes . 'x';
  469.             // encode comma in thumbnail path as srcset is a comma separated list
  470.             $srcSetValues[] = str_replace(',', '%2C', $this->addCacheBuster($thumb . ' ' . $descriptor, $options, $image));
  472.             if ($this->useOriginalFile($this->asset->getFilename()) && $this->getConfig()->isSvgTargetFormatPossible()) {
  473.                 break;
  474.             }
  475.         }
  477.         return implode(', ', $srcSetValues);
  478.     }
  479. }