OptimizedImage::swapLazyLoadAttrs() - Code Metrics - Inspection of "Refactored imgTag()" - nystudio107/craft-imageoptimize - Measure and Improve Code Quality continuously with Scrutinizer

Passed

Push — develop ( fff86a...02dcc0 )

by Andrew

created 2021-01-09 23:31 UTC

OptimizedImage::swapLazyLoadAttrs() A

↳ Parent: OptimizedImage

Complexity

Conditions	5
Paths	16

Size

Total Lines	20
Code Lines	13

Duplication

Lines	0
Ratio	0 %

Importance

Changes	1
Bugs	0	Features	0

Metric	Value
eloc	13
c	1
b	0
f	0
dl	0
loc	20
rs	9.5222
cc	5
nc	16
nop	2

<?php
/**
 * Image Optimize plugin for Craft CMS 3.x
 *
 * Automatically optimize images after they've been transformed
 *
 * @link      https://nystudio107.com

 * @copyright Copyright (c) 2017 nystudio107

 */


namespace nystudio107\imageoptimize\models;

use craft\helpers\Html;
use nystudio107\imageoptimize\ImageOptimize;
use nystudio107\imageoptimize\helpers\UrlHelper;
use nystudio107\imageoptimize\helpers\Color as ColorHelper;

use craft\helpers\Template;
use craft\base\Model;
use craft\validators\ArrayValidator;

/**

 * @author    nystudio107

 * @package   ImageOptimize

 * @since     1.2.0

 */

class OptimizedImage extends Model
{
    // Public Properties
    // =========================================================================

    /**

     * @var string[] An array of optimized image variant URLs
     */
    public $optimizedImageUrls = [];

    /**

     * @var string[] An array of optimized .webp image variant URLs
     */
    public $optimizedWebPImageUrls = [];

    /**

     * @var int[] An array of the widths of the optimized image variants
     */
    public $variantSourceWidths = [];

    /**

     * @var int[] An array of the heights of the optimized image variants
     */
    public $variantHeights = [];

    /**

     * @var float[] An array of the x,y image focal point coords, ranging from 0.0 to 1.0
     */
    public $focalPoint;

    /**

     * @var int The width of the original source image
     */
    public $originalImageWidth;

    /**

     * @var int The height of the original source image
     */
    public $originalImageHeight;

    /**

     * @var string The base64 encoded placeholder LQIP image
     */
    public $placeholder = '';

    /**

     * @var string The base64 encoded placeholder LQIP SVG image
     */
    public $placeholderSvg = '';

    /**

     * @var string[] An array the 5 most dominant colors in the image
     */
    public $colorPalette = [];

    /**

     * @var int The overall lightness of the image, from 0..100
     */
    public $lightness;

    /**

     * @var int The width of the placeholder image
     */
    public $placeholderWidth;

    /**

     * @var int The height of the placeholder image
     */
    public $placeholderHeight;

    /**

     * @var string[] An array of errors logged when generating the image transforms
     */
    public $stickyErrors = [];

    // Public Methods
    // =========================================================================

    /**

     * @inheritdoc
     */

    public function rules(): array
    {
        return [
            ['optimizedImageUrls', ArrayValidator::class],
            ['optimizedWebPImageUrls', ArrayValidator::class],
            ['variantSourceWidths', ArrayValidator::class],
            ['variantHeights', ArrayValidator::class],
            ['focalPoint', 'safe'],
            ['originalImageWidth', 'integer'],
            ['originalImageHeight', 'integer'],
            ['placeholder', 'string'],
            ['placeholderSvg', 'string'],
            ['colorPalette', ArrayValidator::class],
            ['placeholderWidth', 'integer'],
            ['placeholderHeight', 'integer'],
            ['stickyErrors', ArrayValidator::class],
        ];
    }

    /**
     * Return the first image variant URL or the specific one passed in via
     * $width
     *
     * @param int $width

     *
     * @return \Twig\Markup|null
     */
    public function src(int $width = 0): string
    {
        if (empty($width)) {
            return Template::raw(reset($this->optimizedImageUrls));
        }

        return Template::raw($this->optimizedImageUrls[$width] ?? '');
    }

    /**
     * Getter for CraftQL
     *
     * @param int $width

     *
     * @return null|string|\Twig\Markup
     */
    public function getSrc(int $width = 0): string
    {
        return $this->src($width);
    }

    /**
     * Return a string of image URLs and their sizes
     *
     * @param bool $dpr Whether to generate 1x, 2x srcsets vs the normal XXXw
     *                  srcsets
     *
     * @return \Twig\Markup|null
     */
    public function srcset(bool $dpr = false): string
    {
        return Template::raw($this->getSrcsetFromArray($this->optimizedImageUrls, $dpr));
    }

    /**
     * Getter for CraftQL
     *
     * @param bool $dpr

     *
     * @return string
     */
    public function getSrcset(bool $dpr = false): string
    {
        return $this->srcset($dpr);
    }
    /**
     * Return a string of image URLs and their sizes that match $width
     *
     * @param int  $width

     * @param bool $dpr Whether to generate 1x, 2x srcsets vs the normal XXXw

     *                  srcsets
     *
     * @return \Twig\Markup|null
     */
    public function srcsetWidth(int $width, bool $dpr = false): string
    {
        $subset = $this->getSrcsetSubsetArray($this->optimizedImageUrls, $width, 'width');

        return Template::raw($this->getSrcsetFromArray($subset, $dpr));
    }

    /**
     * Return a string of image URLs and their sizes that are at least $width
     * or larger
     *
     * @param int  $width

     * @param bool $dpr Whether to generate 1x, 2x srcsets vs the normal XXXw

     *                  srcsets
     *
     * @return \Twig\Markup|null
     */
    public function srcsetMinWidth(int $width, bool $dpr = false): string
    {
        $subset = $this->getSrcsetSubsetArray($this->optimizedImageUrls, $width, 'minwidth');

        return Template::raw($this->getSrcsetFromArray($subset, $dpr));
    }

    /**
     * Return a string of image URLs and their sizes that are $width or smaller
     *
     * @param int  $width

     * @param bool $dpr Whether to generate 1x, 2x srcsets vs the normal XXXw

     *                  srcsets
     *
     * @return \Twig\Markup|null
     */
    public function srcsetMaxWidth(int $width, bool $dpr = false): string
    {
        $subset = $this->getSrcsetSubsetArray($this->optimizedImageUrls, $width, 'maxwidth');

        return Template::raw($this->getSrcsetFromArray($subset, $dpr));
    }

    /**
     * Return the first webp image variant URL or the specific one passed in
     * via $width
     *
     * @param int $width

     *
     * @return \Twig\Markup|null
     */
    public function srcWebp(int $width = 0): string
    {
        if (empty($width)) {
            return Template::raw(reset($this->optimizedWebPImageUrls));
        }

        return Template::raw($this->optimizedWebPImageUrls[$width] ?? '');
    }

    /**
     * Getter for CraftQL
     *
     * @param int $width

     *
     * @return string
     */
    public function getSrcWebp(int $width = 0): string
    {
        return $this->srcWebp($width);
    }

    /**
     * Return a string of webp image URLs and their sizes
     *
     * @param bool $dpr Whether to generate 1x, 2x srcsets vs the normal XXXw
     *                  srcsets
     *
     * @return \Twig\Markup|null
     */
    public function srcsetWebp(bool $dpr = false): string
    {
        return Template::raw($this->getSrcsetFromArray($this->optimizedWebPImageUrls, $dpr));
    }

    /**
     * Getter for CraftQL
     *
     * @param bool $dpr

     *
     * @return string
     */
    public function getSrcsetWebp(bool $dpr = false): string
    {
        return $this->srcsetWebp($dpr);
    }

    /**
     * Return a string of webp image URLs and their sizes that match $width
     *
     * @param int  $width

     * @param bool $dpr Whether to generate 1x, 2x srcsets vs the normal XXXw

     *                  srcsets
     *
     * @return \Twig\Markup|null
     */
    public function srcsetWidthWebp(int $width, bool $dpr = false): string
    {
        $subset = $this->getSrcsetSubsetArray($this->optimizedWebPImageUrls, $width, 'width');

        return Template::raw($this->getSrcsetFromArray($subset, $dpr));
    }

    /**
     * Return a string of webp image URLs and their sizes that are at least
     * $width or larger
     *
     * @param int  $width

     * @param bool $dpr Whether to generate 1x, 2x srcsets vs the normal XXXw

     *                  srcsets
     *
     * @return \Twig\Markup|null
     */
    public function srcsetMinWidthWebp(int $width, bool $dpr = false): string
    {
        $subset = $this->getSrcsetSubsetArray($this->optimizedWebPImageUrls, $width, 'minwidth');

        return Template::raw($this->getSrcsetFromArray($subset, $dpr));
    }

    /**
     * Return a string of webp image URLs and their sizes that are $width or
     * smaller
     *
     * @param int  $width

     * @param bool $dpr Whether to generate 1x, 2x srcsets vs the normal XXXw

     *                  srcsets
     *
     * @return \Twig\Markup|null
     */
    public function srcsetMaxWidthWebp(int $width, bool $dpr = false): string
    {
        $subset = $this->getSrcsetSubsetArray($this->optimizedWebPImageUrls, $width, 'maxwidth');

        return Template::raw($this->getSrcsetFromArray($subset, $dpr));
    }

    /**
     * Work around issues with `<img srcset>` returning sizes larger than are
     * available as per:
     * https://medium.com/@MRWwebDesign/responsive-images-the-sizes-attribute-and-unexpected-image-sizes-882a2eadb6db
     *
     * @return int
     */
    public function maxSrcsetWidth(): int
    {
        $result = 0;
        if (!empty($this->optimizedImageUrls)) {
            $tempArray = $this->optimizedImageUrls;
            ksort($tempArray, SORT_NUMERIC);

            $keys = array_keys($tempArray);
            $result = end($keys);
        }

        return $result;
    }

    /**
     * Getter for CraftQL
     *
     * @return int
     */
    public function getMaxSrcsetWidth(): int
    {
        return $this->maxSrcsetWidth();
    }

    /**
     * Return the colors as an array of RGB colors
     */

    public function colorPaletteRgb(): array
    {
        $colors = [];

        foreach ($this->colorPalette as $color) {
            if (!empty($color)) {
                $colors[] = ColorHelper::HTMLToRGB($color);
            }
        }

        return $colors;
    }

    /**
     * Generate a complete <img> tag for this OptimizedImages model
     *
     * @param false|string $lazyLoad

     * @param array $imgAttrs

     * @return \Twig\Markup

     */
    public function imgTag($lazyLoad = false, $imgAttrs = [])
    {
        // Merge the passed in options with the tag attributes
        $attrs = array_merge([

                'class' => '',
                'src' => reset($this->optimizedImageUrls),
                'srcset' => $this->getSrcsetFromArray($this->optimizedImageUrls),
                'sizes' => '100vw',
                'loading' => $lazyLoad,
            ],
            $imgAttrs
        );
        // Handle lazy loading
        if ($lazyLoad) {
            $attrs = $this->swapLazyLoadAttrs($lazyLoad, $attrs);
        }
        // Remove any empty attributes
        $attrs = array_filter($attrs);
        // Render the tag
        $tag = Html::tag('img', '', $attrs);

        return Template::raw($tag);
    }

    /**
     * Return a base64-encoded placeholder image
     *
     * @return \Twig\Markup|null
     */
    public function placeholderImage()
    {
        $header = 'data:image/jpeg;base64,';
        if (!empty($this->placeholder)) {
            $content = $this->placeholder;
        } else {
            // At least return something
            return $this->defaultPlaceholderImage();
        }

        return Template::raw($header.rawurlencode($content));
    }

    /**
     * Getter for CraftQL
     *
     * @return string
     */
    public function getPlaceholderImage(): string
    {
        return (string)$this->placeholderImage();
    }

    /**

     * @return string
     */
    public function placeholderImageSize(): string
    {
        $placeholder = $this->placeholderImage();
        $contentLength = !empty(\strlen($placeholder)) ? \strlen($placeholder) : 0;

        return ImageOptimize::$plugin->optimize->humanFileSize($contentLength, 1);
    }

    /**
     * Return an SVG box as a placeholder image
     *
     * @param string|null $color

     *
     * @return \Twig\Markup|null
     */
    public function placeholderBox(string $color = null)
    {
        $width = $this->placeholderWidth ?? 1;
        $height = $this->placeholderHeight ?? 1;
        $color = $color ?? $this->colorPalette[0] ?? '#CCC';

        return Template::raw(ImageOptimize::$plugin->placeholder->generatePlaceholderBox($width, $height, $color));
    }

    /**

     * @param string|null $color

     *
     * @return string
     */
    public function getPlaceholderBox(string $color = null): string
    {
        return (string)$this->placeholderBox($color);
    }

    /**
     * Getter for CraftQL
     *
     * @return string
     */
    public function placeholderBoxSize(): string
    {
        $placeholder = $this->placeholderBox();
        $contentLength = !empty(\strlen($placeholder)) ? \strlen($placeholder) : 0;

        return ImageOptimize::$plugin->optimize->humanFileSize($contentLength, 1);
    }

    /**
     * Return a silhouette of the image as an SVG placeholder
     *
     * @return \Twig\Markup|null
     */
    public function placeholderSilhouette()
    {
        $header = 'data:image/svg+xml,';
        if (!empty($this->placeholderSvg)) {
            $content = $this->placeholderSvg;
        } else {
            // At least return something
            return $this->defaultPlaceholderImage();
        }

        return Template::raw($header.$content);
    }

    /**
     * Getter for CraftQL
     *
     * @return string
     */
    public function getPlaceholderSilhouette(): string
    {
        return (string)$this->placeholderSilhouette();
    }

    /**

     * @return string
     */
    public function placeholderSilhouetteSize(): string
    {
        $placeholder = $this->placeholderSilhouette();
        $contentLength = !empty(\strlen($placeholder)) ? \strlen($placeholder) : 0;

        return ImageOptimize::$plugin->optimize->humanFileSize($contentLength, 1);
    }

    /**
     *  Get the file size of any remote resource (using curl),
     *  either in bytes or - default - as human-readable formatted string.
     *
     * @author  Stephan Schmitz <[email protected]>
     * @license MIT <http://eyecatchup.mit-license.org/>
     * @url     <https://gist.github.com/eyecatchup/f26300ffd7e50a92bc4d>
     *
     * @param   string  $url        Takes the remote object's URL.

     * @param   boolean $formatSize Whether to return size in bytes or

     *                              formatted.
     * @param   boolean $useHead    Whether to use HEAD requests. If false,

     *                              uses GET.
     *
     * @return  int|mixed|string    Returns human-readable formatted size

     *                              or size in bytes (default: formatted).
     */
    public function getRemoteFileSize($url, $formatSize = true, $useHead = true)
    {
        // Get an absolute URL with protocol that curl will be happy with
        $url = UrlHelper::absoluteUrlWithProtocol($url);
        $ch = curl_init($url);
        curl_setopt_array($ch, [

            CURLOPT_RETURNTRANSFER => 1,
            CURLOPT_FOLLOWLOCATION => 1,
            CURLOPT_SSL_VERIFYPEER => 0,
        ]);
someFunctionCall(
    $firstArgument,
    $secondArgument,
    $thirdArgument
); // Closing parenthesis on a new line.
        if ($useHead) {
            curl_setopt($ch, CURLOPT_NOBODY, 1);
        }
        curl_exec($ch);
        // content-length of download (in bytes), read from Content-Length: field
        $contentLength = curl_getinfo($ch, CURLINFO_CONTENT_LENGTH_DOWNLOAD);
        curl_close($ch);
        // cannot retrieve file size, return "-1"
        if (!$contentLength) {
            return -1;
        }
        // return size in bytes
        if (!$formatSize) {
            return $contentLength;
        }

        return ImageOptimize::$plugin->optimize->humanFileSize($contentLength, 1);
    }

    // Protected Methods
    // =========================================================================

    protected function getSrcsetSubsetArray(array $set, int $width, string $comparison): array

    {
        $subset = [];
        $index = 0;
        if (empty($this->variantSourceWidths)) {
            return $subset;
        }
        foreach ($this->variantSourceWidths as $variantSourceWidth) {
            $match = false;
            switch ($comparison) {
                case 'width':

                    if ($variantSourceWidth == $width) {

                        $match = true;
                    }

                    break;

                case 'minwidth':

                    if ($variantSourceWidth >= $width) {

                        $match = true;
                    }

                    break;

                case 'maxwidth':

                    if ($variantSourceWidth <= $width) {

                        $match = true;
                    }

                    break;
            }
            if ($match) {
                $subset += array_slice($set, $index, 1, true);
            }
            $index++;
        }

        return $subset;
    }

    /**

     * @param array $array

     * @param bool  $dpr

     *
     * @return string
     */
    protected function getSrcsetFromArray(array $array, bool $dpr = false): string
    {
        $srcset = '';
        foreach ($array as $key => $value) {
            if ($dpr) {
                $descriptor = '1x';
                if (!empty($array[(int)$key / 2])) {
                    $descriptor = '2x';
                }
                if (!empty($array[(int)$key / 3])) {
                    $descriptor = '3x';
                }
            } else {
                $descriptor = $key.'w';
            }
            $srcset .= $value.' '.$descriptor.', ';
        }
        $srcset = rtrim($srcset, ', ');

        return $srcset;
    }

    /**
     * Return a default placeholder image
     *
     * @return \Twig\Markup
     */
    protected function defaultPlaceholderImage(): \Twig\Markup
    {
        $width = 1;
        $height = 1;
        $color = '#CCC';

        return Template::raw(ImageOptimize::$plugin->placeholder->generatePlaceholderBox($width, $height, $color));
    }

    /**
     * Swap the tag attributes to work with lazy loading
     *
     * @param array $attrs

     * @param string $lazyLoad

     * @return array

     */
    protected function swapLazyLoadAttrs(string $lazyLoad, array $attrs): array
    {
        if (!empty($attrs['class'])) {
            $attrs['class'] .= ' lazyload';
        }
        if (!empty($attrs['loading'])) {
            $attrs['loading'] = 'lazy';
        }
        if (!empty($attrs['srcset'])) {
            $attrs['data-srcset'] = $attrs['srcset'];
            $attrs['srcset'] = '';
        }
        if (!empty($attrs['src'])) {
            $attrs['data-src'] = $attrs['src'];
        }
        $attrs['src'] = $this->getLazyLoadSrc($lazyLoad);
        $attrs['height'] = $this->placeholderHeight;
        $attrs['width'] = $this->placeholderWidth;

        return $attrs;
    }

    /**
     * Return a lazy loading placeholder image based on the passed in $lazyload setting
     *
     * @param string $lazyLoad

     * @param array $attrs

     *
     * @return array
     */
    protected function getLazyLoadSrc(string $lazyLoad): string
    {
        $result = '';
        if (is_string($lazyLoad)) {

            $lazyLoad = strtolower($lazyLoad);
        }
        switch ($lazyLoad) {
            case 'image':

                $result = $this->getPlaceholderImage();
                break;
            case 'silhouette':

                $result = $this->getPlaceholderSilhouette();
                break;
            case 'color':

                $result = $this->getPlaceholderBox($this->colorPalette[0] ?? null);
                break;
            default:

                $result = $this->getPlaceholderBox();
                break;
        }

        return $result;

    }
}


1			<?php
2			/**
3			* Image Optimize plugin for Craft CMS 3.x
4			*
5			* Automatically optimize images after they've been transformed
6			*
7			* @link https://nystudio107.com
			0 ignored issues – show Coding Style introduced 2018-09-25 21:32 UTC by Report Bug Copy Issue Report The tag in position 1 should be the @copyright tag Loading history...
8			* @copyright Copyright (c) 2017 nystudio107
			0 ignored issues – show Coding Style introduced 2018-09-25 21:32 UTC by Report Bug Copy Issue Report @copyright tag must contain a year and the name of the copyright holder Loading history...
9			*/
			0 ignored issues – show Coding Style introduced 2018-09-25 21:32 UTC by Report Bug Copy Issue Report PHP version not specified Loading history... Coding Style introduced 2018-09-25 21:32 UTC by Report Bug Copy Issue Report Missing @category tag in file comment Loading history... Coding Style introduced 2018-09-25 21:32 UTC by Report Bug Copy Issue Report Missing @package tag in file comment Loading history... Coding Style introduced 2018-09-25 21:32 UTC by Report Bug Copy Issue Report Missing @author tag in file comment Loading history... Coding Style introduced 2018-09-25 21:32 UTC by Report Bug Copy Issue Report Missing @license tag in file comment Loading history...
10
11			namespace nystudio107\imageoptimize\models;
12
13			use craft\helpers\Html;
14			use nystudio107\imageoptimize\ImageOptimize;
15			use nystudio107\imageoptimize\helpers\UrlHelper;
16			use nystudio107\imageoptimize\helpers\Color as ColorHelper;
17
18			use craft\helpers\Template;
19			use craft\base\Model;
20			use craft\validators\ArrayValidator;
21
22			/**
			0 ignored issues – show Coding Style introduced 2018-09-25 21:32 UTC by Report Bug Copy Issue Report Missing short description in doc comment Loading history...
23			* @author nystudio107
			0 ignored issues – show Coding Style introduced 2018-09-25 21:32 UTC by Report Bug Copy Issue Report The tag in position 1 should be the @package tag Loading history... Coding Style introduced 2018-09-25 21:32 UTC by Report Bug Copy Issue Report Content of the @author tag must be in the form "Display Name <[email protected]>" Loading history... Coding Style introduced 2019-04-08 16:04 UTC by Report Bug Copy Issue Report Tag value for @author tag indented incorrectly; expected 2 spaces but found 4 Loading history...
24			* @package ImageOptimize
			0 ignored issues – show Coding Style introduced 2019-04-08 16:04 UTC by Report Bug Copy Issue Report Tag value for @package tag indented incorrectly; expected 1 spaces but found 3 Loading history...
25			* @since 1.2.0
			0 ignored issues – show Coding Style introduced 2018-09-25 21:32 UTC by Report Bug Copy Issue Report The tag in position 3 should be the @author tag Loading history... Coding Style introduced 2019-04-08 16:04 UTC by Report Bug Copy Issue Report Tag value for @since tag indented incorrectly; expected 3 spaces but found 5 Loading history...
26			*/
			0 ignored issues – show Coding Style introduced 2018-09-25 21:32 UTC by Report Bug Copy Issue Report Missing @category tag in class comment Loading history... Coding Style introduced 2018-09-25 21:32 UTC by Report Bug Copy Issue Report Missing @license tag in class comment Loading history... Coding Style introduced 2018-09-25 21:32 UTC by Report Bug Copy Issue Report Missing @link tag in class comment Loading history...
27			class OptimizedImage extends Model
28			{
29			// Public Properties
30			// =========================================================================
31
32			/**

nystudio107 / craft-imageoptimize

Push — develop ( fff86a...02dcc0 )

OptimizedImage::swapLazyLoadAttrs() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like