File manager

File manager - Edit - /home/opticamezl/www/newok/Image.php.tar

Back
home/opticamezl/www/newok/libraries/regularlabs/src/Image.php��0000604��00000070362�15173113172�0020420 0��ustar�00��<?php /** * @package Regular Labs Library * @version 25.7.12430 * * @author Peter van Westen <info@regularlabs.com> * @link https://regularlabs.com * @copyright Copyright © 2025 Regular Labs All Rights Reserved * @license GNU General Public License version 2 or later / namespace RegularLabs\Library; defined('_JEXEC') or die; require_once dirname(__FILE__, 2) . '/vendor/autoload.php'; use Exception; use RegularLabs\Scoped\Intervention\Image\Exception\NotReadableException as NotReadableException; use RegularLabs\Scoped\Intervention\Image\ImageManagerStatic as ImageManager; use Joomla\CMS\Uri\Uri as JUri; use Joomla\Filesystem\File as JFile; class Image { static $data_files = []; private $attributes; private $description; private $file; private $input; private $is_resized; private $output; private $settings; /* * @param object $attributes @deprecated use SET methods instead / public function __construct(?string $file = null, ?object $attributes = null) { $this->settings = (object) ['resize' => (object) ['enabled' => \true, 'quality' => 70, 'method' => 'crop', 'folder' => 'resized', 'max_age' => 0, 'force_overwrite' => \false, 'use_retina' => \true, 'retina_pixel_density' => 1.5], 'title' => (object) ['enabled' => \true, 'format' => 'uppercase_first', 'lowercase_words' => 'a,the,to,at,in,with,and,but,or'], 'lazy_loading' => \false]; if ($file) { $this->setFile($file); } if ($attributes) { $this->setFromOldAttributes($attributes); } $this->resetOutput(); } public static function cleanPath(string $path): string { $path = str_replace('\\', '/', $path); $path_site = str_replace('\\', '/', JPATH_SITE) . '/'; if (str_starts_with($path, $path_site)) { $path = substr($path, strlen($path_site)); } $path = ltrim(str_replace(JUri::root(), '', $path), '/'); $path = strtok($path, '?'); $path = strtok($path, '#'); return $path; } public function createResizeFolder(): self { $path = $this->getResizeFolderPath(); if (is_dir($path)) { return $this; } if (!@mkdir($path, 0755, \true)) { $this->settings->resize->folder = ''; } return $this; } public function exists(?string $file = null): bool { $file = urldecode($file ?: $this->getFilePath()); return $file && file_exists($file) && is_file($file); } public function forceOverwriteResized(): self { return $this->setResizeAttribute('force_overwrite', 1.0E-5); } public function getAlt(): string { if (isset($this->attributes->alt)) { return $this->attributes->alt; } $alt = $this->getDataFileDataByType('alt'); if (!is_null($alt)) { return htmlentities($alt); } return $this->getTitle(\true); } public function getDataFileData(): mixed { $image_data = $this->getFolderFileData(); return $image_data[$this->getFileStem()] ?? null; } public function getDataFileDataByType(string $type = 'title'): mixed { $image_data = $this->getDataFileData(); if (isset($image_data[$type])) { return $image_data[$type]; } $default_data = $this->getDefaultDataFileData(); return $default_data[$type] ?? null; } public function getDefaultDataFileData(): mixed { $image_data = $this->getFolderFileData(); return $image_data[''] ?? null; } public function getDescription(): string { if (!is_null($this->description)) { return $this->description; } return $this->getDataFileDataByType('description') ?? ''; } public function setDescription($description): self { $this->description = $description; return $this; } public function getFile(): string { $this->prepareInput(); return $this->input->file; } public function setFile($file): self { $this->file = $file; $this->resetInput(); return $this; } public function getFileExtension(): string { $this->prepareInput(); return $this->input->file_extension; } public function getFileInfo(string $file, string $file_path): object { $file_path = urldecode($file_path); $path_info = @pathinfo($file_path); if (\RegularLabs\Library\File::isInternal($file_path)) { $size_info = @getimagesize($file_path); } $file_name = $path_info['basename'] ?? basename($file_path); $file_stem = $path_info['filename'] ?? JFile::stripExt($file_name); $file_extension = $path_info['extension'] ?? JFile::getExt($file_name); return (object) ['folder' => \RegularLabs\Library\File::getDirName($file), 'folder_path' => $path_info['dirname'] ?? null, 'file' => $file, 'file_path' => $file_path, 'file_name' => $file_name, 'file_stem' => $file_stem, 'file_extension' => $file_extension, 'mime' => $size_info['mime'] ?? null, 'width' => $size_info[0] ?? null, 'height' => $size_info[1] ?? null]; } public function getFileName(): string { $this->prepareInput(); return $this->input->file_name; } public function getFilePath(): string { $this->prepareInput(); return $this->input->file_path; } public function getFileStem(): string { $this->prepareInput(); return $this->input->file_stem; } public function getFolder(): string { $this->prepareInput(); return $this->input->folder; } public function getFolderPath(): string { $this->prepareInput(); return $this->input->folder_path; } public function getHeight(): int { $this->prepareOutput(); return $this->output->height; } public function getOriginalHeight(): int { $this->prepareInput(); return $this->input->height; } public function getOriginalWidth(): int { $this->prepareInput(); return $this->input->width; } public function getOutputFile(): string { $this->prepareInput(); if ($this->isExternal() \|\| !$this->exists()) { return $this->input->file; } $this->prepareOutput(); return $this->output->file; } public function getOutputFilePath(): string { $this->prepareOutput(); return $this->output->file_path; } /** * @depecated Use getOutputFile() instead / public function getPath(): string { return $this->getOutputFile(); } public function getSrcSet(?string $pixel_density = null): ?string { if ($this->isExternal()) { return null; } if (!$this->settings->resize->use_retina) { return null; } if ($this->getFilePath() == $this->getOutputFilePath()) { return null; } $pixel_density = $pixel_density ?: $this->settings->resize->retina_pixel_density; $single = $this->getOutputFile(); $double = $this->getOutputFile2x(); if ($double == $single) { return null; } return $double . ' ' . (float) $pixel_density . 'x, ' . $single . ' 1x'; } public function getTagAttributes(): object { $ordered_keys = ['src', 'srcset', 'alt', 'title', 'width', 'height', 'class', 'loading']; krsort($ordered_keys); $tag_width = $this->output->width; $tag_height = $this->output->height; $this->attributes = $this->attributes ?: (object) []; $this->attributes->src = $this->getOutputFile(); $this->attributes->srcset = $this->getSrcset(); $this->attributes->alt = $this->getAlt(); $this->attributes->title = $this->getTitle(\true); $this->attributes->width = $this->output->width ?: $this->attributes->width ?? 0; $this->attributes->height = $this->output->height ?: $this->attributes->height ?? 0; if ($this->attributes->width < $tag_width) { $this->attributes->width = $tag_width; $this->attributes->height = round($this->attributes->height ($tag_width / $this->attributes->width)); } if ($this->attributes->height < $tag_height) { $this->attributes->height = $tag_height; $this->attributes->width = round($this->attributes->width * ($tag_height / $this->attributes->height)); } $this->attributes->width = $this->attributes->width ?: null; $this->attributes->height = $this->attributes->height ?: null; $attributes = (array) $this->attributes; foreach ($ordered_keys as $key) { if (!key_exists($key, $attributes)) { continue; } $value = $attributes[$key]; if (is_null($value)) { continue; } unset($attributes[$key]); $attributes = [$key => $value, ...$attributes]; } return (object) $attributes; } public function getTitle(bool $force = \false): string { if (isset($this->attributes->title)) { return $this->attributes->title; } $title = $this->getDataFileDataByType('title'); if (!is_null($title)) { // Remove HTML tags $title = strip_tags($title); return htmlentities($title); } return $this->getTitleFromName($force); } public function getWidth(): int { $this->prepareOutput(); return $this->output->width; } public function isResized(): bool { if (!is_null($this->is_resized)) { return $this->is_resized; } $this->is_resized = \false; $this->prepareInput(); $parent_folder_name = \RegularLabs\Library\File::getBaseName($this->input->folder_path); $resize_folder_name = $this->settings->resize->folder; // Image is not inside the resize folder if ($parent_folder_name != $resize_folder_name) { return \false; } $parent_folder = \RegularLabs\Library\File::getDirName($this->input->folder_path); $file_name = $this->input->file_name; // Check if image with same name exists in parent folder if ($this->exists($parent_folder . '/' . \RegularLabs\Library\StringHelper::utf8_decode($file_name))) { $this->is_resized = \true; return \true; } // Remove any dimensions from the file // image_300x200.jpg => image.jpg $file_name = \RegularLabs\Library\RegEx::replace('_[0-9]+x[0-9](\.[^.]+)$', '\1', $file_name); // Check again if image with same name (but without dimensions) exists in parent folder if ($this->exists($parent_folder . '/' . \RegularLabs\Library\StringHelper::utf8_decode($file_name))) { $this->is_resized = \true; return \true; } return \false; } public function outputExists(): bool { $file = $this->getOutputFilePath(); return $file && file_exists($file) && is_file($file); } public function render(string $outer_class = ''): string { $attributes = (array) $this->getTagAttributes(); $image_tag = '<img ' . \RegularLabs\Library\HtmlTag::flattenAttributes($attributes) . ' />'; if (!$outer_class) { return $image_tag; } return '<div class="' . htmlspecialchars($outer_class) . '">' . $image_tag . '</div>'; } /* * @depecated Use render() instead / public function renderTag(): string { return $this->render($this->attributes->{'outer-class'} ?? ''); } public function setAlt($alt): self { return $this->setTagAttribute('alt', $alt); } public function setAutoTitles(bool $enabled, string $title_format = 'titlecase', string $lowercase_words = 'a,the,to,at,in,with,and,but,or'): self { $this->settings->title->enabled = $enabled; $this->settings->title->format = $title_format; $this->settings->title->lowercase_words = $lowercase_words; return $this; } public function setDimensions(int\|float\|string $width, int\|float\|string $height): self { $this->setResizeMethod(empty($width) \|\| empty($height) ? 'scale' : 'crop'); $this->setOutputSetting('width', (int) $width); $this->setOutputSetting('height', (int) $height); return $this; } public function setEnableResize(bool $enabled): self { $this->settings->resize->enabled = $enabled; return $this; } public function setHeight(int\|float\|string $height): self { return $this->setOutputSetting('height', (int) $height); } public function setItemProp(?string $itemprop): self { $itemprop = $itemprop ? 'image' : null; $this->setTagAttribute('itemprop', $itemprop); return $this; } public function setLazyLoading(?bool $enabled): self { return $this->setTagAttribute('loading', $enabled ? 'lazy' : null); } public function setLowerCaseWords(array $words): self { $this->settings->title->lowercase_words = $words; return $this; } public function setOutputFileData(): self { if (!empty($this->output->file)) { return $this; } $this->prepareInput(); $output = clone $this->input; if (!empty($this->output->width) \|\| !empty($this->output->height)) { $output->width = $this->output->width; $output->height = $this->output->height; } $this->output = $output; return $this; } public function setOutputSetting(string $key, mixed $value): self { if (is_null($this->output)) { $this->output = (object) ['width' => 0, 'height' => 0]; } if ($this->output->{$key} == $value) { return $this; } $this->output->{$key} = $value; $this->resetOutput(); return $this; } public function setResizeAttribute(string $key, mixed $value): self { if ($this->settings->resize->{$key} == $value) { return $this; } $this->settings->resize->{$key} = $value; $this->resetOutput(); return $this; } public function setResizeFolder(string $folder = 'resized'): self { return $this->setResizeAttribute('folder', $folder); } public function setResizeMaxAge(int $age_in_days): self { return $this->setResizeAttribute('max_age', $age_in_days); } public function setResizeMethod(string $method): self { $this->settings->resize->method = $method; return $this; } public function setResizeQuality(string\|int $quality): self { return $this->setResizeAttribute('quality', $this->parseQuality($quality)); } public function setRetinaPixelDensity(string $pixel_density): self { return $this->setResizeAttribute('retina_pixel_density', $pixel_density); } public function setTagAttribute(string $key, mixed $value): self { if (is_null($this->attributes)) { $this->attributes = (object) []; } $this->attributes->{$key} = $value; return $this; } public function setTagAttributes(object $attributes): self { foreach ($attributes as $key => $value) { $this->setTagAttribute($key, $value); } return $this; } public function setTitle(string $title): self { return $this->setTagAttribute('title', $title); } public function setUseRetina(bool $use_retina): self { return $this->setResizeAttribute('use_retina', $use_retina); } public function setWidth(int\|float\|string $width): self { return $this->setOutputSetting('width', (int) $width); } private function getFolderFileData(): array { $folder = $this->getFolderPath(); if (isset(self::$data_files[$folder])) { return self::$data_files[$folder]; } self::$data_files[$folder] = []; if (!$this->exists($folder . '/data.txt')) { return self::$data_files[$folder]; } $data = file_get_contents($folder . '/data.txt'); $data = str_replace("\r", '', $data); $data = explode("\n", $data); foreach ($data as $data_line) { if (empty($data_line) \|\| $data_line[0] == '#' \|\| !str_contains($data_line, '=')) { continue; } [$key, $val] = explode('=', $data_line, 2); if (!\RegularLabs\Library\RegEx::match('^(?<file>.?)\[(?<type>.)\]$', $key, $match)) { continue; } $file = $match['file']; $type = $match['type']; if (!isset(self::$data_files[$folder][$file])) { self::$data_files[$folder][$file] = []; } self::$data_files[$folder][$file][$type] = $val; } return self::$data_files[$folder]; } private function getLowercaseWords(): array { $words = $this->settings->title->lowercase_words; $words = \RegularLabs\Library\ArrayHelper::implode($words, ','); $words = \RegularLabs\Library\StringHelper::strtolower($words); return explode(',', ' ' . str_replace(',', ' , ', $words . ' ')); } private function getOutputFile2x(): string { if ($this->isExternal()) { return $this->getOutputFile(); } $double_width = $this->output->width 2; $double_height = $this->output->height * 2; if ($double_width == $this->input->width && $double_height == $this->input->height) { return $this->getOutputFile(); } $double_size = \RegularLabs\Library\ObjectHelper::clone($this); $double_size->setDimensions($double_width, $double_height); return $double_size->getOutputFile(); } private function getResizeBoundry(): string { if ($this->input->width / $this->output->width > $this->input->height / $this->output->height) { return 'width'; } return 'height'; } private function getResizeDimensions(): array { if (!$this->output->width) { return [null, $this->output->height]; } if (!$this->output->height) { return [$this->output->width, null]; } if ($this->input->width / $this->output->width > $this->input->height / $this->output->height) { return [null, $this->output->height]; } return [$this->output->width, null]; } private function getResizeFolder(): string { if (!$this->settings->resize->folder) { $this->setResizeFolder(); } return $this->getFolder() . '/' . $this->settings->resize->folder; } private function getResizeFolderPath(): string { if (!$this->settings->resize->folder) { $this->setResizeFolder(); } return $this->getFolderPath() . '/' . $this->settings->resize->folder; } private function getResizedFileName(): string { $this->prepareInput(); return $this->input->file_stem . '_' . $this->output->width . 'x' . $this->output->height . '.' . $this->input->file_extension; } private function getTitleFromName(bool $force = \false): string { if (!$force && !$this->settings->title->enabled) { return ''; } $title = \RegularLabs\Library\StringHelper::toSpaceSeparated($this->input->file_stem); switch ($this->settings->title->format) { case 'lowercase': return \RegularLabs\Library\StringHelper::strtolower($title); case 'uppercase': return \RegularLabs\Library\StringHelper::strtoupper($title); case 'uppercase_first': return \RegularLabs\Library\StringHelper::strtoupper(\RegularLabs\Library\StringHelper::substr($title, 0, 1)) . \RegularLabs\Library\StringHelper::strtolower(\RegularLabs\Library\StringHelper::substr($title, 1)); case 'titlecase': return function_exists('mb_convert_case') ? mb_convert_case(\RegularLabs\Library\StringHelper::strtolower($title), \MB_CASE_TITLE) : ucwords(strtolower($title)); case 'titlecase_smart': $title = function_exists('mb_convert_case') ? mb_convert_case(\RegularLabs\Library\StringHelper::strtolower($title), \MB_CASE_TITLE) : ucwords(strtolower($title)); $lowercase_words = $this->getLowercaseWords(); return str_ireplace($lowercase_words, $lowercase_words, $title); default: return $title; } } private function handleDimensions(): self { if (!$this->input->width \|\| !$this->input->height) { return $this; } // Width and height are both not set, so revert to original dimensions if (!$this->output->height && !$this->output->width) { $this->output->width = $this->input->width; $this->output->height = $this->input->height; return $this; } if (!$this->outputExists()) { return $this; } if ($this->settings->resize->method == 'crop') { $this->output->width = $this->output->width ?: $this->output->height; $this->output->height = $this->output->height ?: $this->output->width; return $this->resize(); } // Width and height are both set if ($this->output->width && $this->output->height) { $boundry = $this->getResizeBoundry(); $this->output->width = $boundry == 'width' ? $this->output->width : round($this->output->height / $this->input->height * $this->input->width); $this->output->height = $boundry == 'height' ? $this->output->height : round($this->output->width / $this->input->width * $this->input->height); return $this->resize(); } $this->output->width = $this->output->width ?: round($this->output->height / $this->input->height * $this->input->width); $this->output->height = $this->output->height ?: round($this->output->width / $this->input->width * $this->input->height); return $this->resize(); } private function isExternal(): bool { $this->prepareInput(); return \RegularLabs\Library\File::isExternal($this->input->file); } private function limitDimensions(): self { if ($this->output->width <= $this->input->width && $this->output->height <= $this->input->height) { return $this; } if ($this->output->width > $this->input->width) { $this->output->height = $this->output->height / $this->output->width * $this->input->width; $this->output->width = $this->input->width; } if ($this->output->height > $this->input->height) { $this->output->width = $this->output->width / $this->output->height * $this->input->height; $this->output->height = $this->input->height; } $this->output->width = round($this->output->width); $this->output->height = round($this->output->height); return $this; } private function parseQuality(string\|int $quality = 90): int { if (is_int($quality)) { return $quality; } return match ($quality) { 'low' => 30, 'medium' => 60, default => 90, }; } private function prepareInput(): self { if (!is_null($this->input)) { return $this; } if (!$this->file) { throw new Exception('No file set'); } if (\RegularLabs\Library\File::isExternal($this->file)) { $this->input = $this->getFileInfo($this->file, $this->file); return $this; } $file = self::cleanPath($this->file); $this->input = $this->getFileInfo($file, JPATH_ROOT . '/' . ltrim($file, '/')); return $this; } private function prepareOutput(): self { if (!empty($this->output->file)) { return $this; } $this->prepareInput(); if (empty($this->output->width) && empty($this->output->height)) { $this->output = clone $this->input; return $this; } $this->setOutputFileData(); $this->handleDimensions(); return $this; } private function resetInput(): self { $this->input = null; $this->resetOutput(); return $this; } private function resetOutput(): self { if (is_null($this->output)) { $this->output = (object) ['width' => 0, 'height' => 0]; } unset($this->output->file); return $this; } /** * Method to create a resized version of the current image and save them to disk / private function resize(?string $width = null, ?string $height = null, ?int $quality = null): self { if (!$this->settings->resize->enabled) { return $this; } if ($this->isResized()) { return $this; } if ($this->isExternal()) { return $this; } if (!is_null($width) \|\| !is_null($height)) { $this->setDimensions($width, $height); } if (!is_null($quality)) { $this->setResizeQuality($quality); } if ($this->output->width == $this->input->width && $this->output->height == $this->input->height) { $this->output = clone $this->input; return $this; } $this->limitDimensions(); $file = $this->getResizedFileName(); $this->output->file = $this->getResizeFolder() . '/' . rawurlencode($file); $this->output->file_path = $this->getResizeFolderPath() . '/' . $file; $file_exists = $this->outputExists(); $file_is_outdated = $this->settings->resize->force_overwrite; if (!$file_is_outdated && $file_exists && $this->settings->resize->max_age > 0) { $max_age_in_seconds = ceil($this->settings->resize->max_age 60 * 60 * 24); $min_time = time() - $max_age_in_seconds; $file_is_outdated = filemtime($this->output->file_path) < $min_time; } if ($file_exists && !$file_is_outdated) { //$this->output = $this->getFileInfo($this->output->file, $this->output->file_path); return $this; } [$resize_width, $resize_height] = $this->getResizeDimensions(); try { $resized = ImageManager::make($this->getFilePath())->orientate()->resize($resize_width, $resize_height, function ($constraint) { $constraint->aspectRatio(); }); if ($this->settings->resize->method == 'crop' \|\| $this->output->width && $this->output->height) { $resized->crop($this->output->width, $this->output->height); } $this->createResizeFolder(); $resized->save($this->output->file_path, $this->settings->resize->quality); } catch (NotReadableException $exception) { $resized = null; } if (!$resized) { $this->output = clone $this->input; $this->is_resized = \false; } $this->output = $this->getFileInfo($this->output->file, $this->output->file_path); return $this; } private function setFromOldAttributes(object $attributes): void { if (isset($attributes->alt)) { $this->setAlt($attributes->alt); } if (isset($attributes->title)) { $this->setTitle($attributes->title); } if (isset($attributes->class)) { $this->setTagAttribute('class', $attributes->class); } if (isset($attributes->{'outer-class'})) { $this->setTagAttribute('outer-class', $attributes->{'outer-class'}); } if (isset($attributes->{'resize-folder'})) { $folder = \RegularLabs\Library\File::getBaseName($attributes->{'resize-folder'}); $this->setResizeFolder($folder); } if (isset($attributes->quality)) { $this->setResizeQuality($attributes->quality); } $this->setDimensions($attributes->width ?? 0, $attributes->height ?? 0); } } ��home/opticamezl/www/newok/libraries/src/Image/Image.php��0000644��00000110006�15173233344�0017135 0��ustar�00��<?php /** * Joomla! Content Management System * * @copyright (C) 2017 Open Source Matters, Inc. <https://www.joomla.org> * @license GNU General Public License version 2 or later; see LICENSE.txt / namespace Joomla\CMS\Image; // phpcs:disable PSR1.Files.SideEffects \defined('JPATH_PLATFORM') or die; // phpcs:enable PSR1.Files.SideEffects /* * Class to manipulate an image. * * @since 1.7.3 / class Image { /* * @const integer * @since 2.5.0 / public const SCALE_FILL = 1; /* * @const integer * @since 2.5.0 / public const SCALE_INSIDE = 2; /* * @const integer * @since 2.5.0 / public const SCALE_OUTSIDE = 3; /* * @const integer * @since 2.5.0 / public const CROP = 4; /* * @const integer * @since 2.5.0 / public const CROP_RESIZE = 5; /* * @const integer * @since 2.5.0 / public const SCALE_FIT = 6; /* * @const string * @since 3.4.2 / public const ORIENTATION_LANDSCAPE = 'landscape'; /* * @const string * @since 3.4.2 / public const ORIENTATION_PORTRAIT = 'portrait'; /* * @const string * @since 3.4.2 / public const ORIENTATION_SQUARE = 'square'; /* * @var resource The image resource handle. * @since 2.5.0 / protected $handle; /* * @var string The source image path. * @since 2.5.0 / protected $path = null; /* * @var array Whether or not different image formats are supported. * @since 2.5.0 / protected static $formats = []; /* * @var boolean Flag if an image should use the best quality available. Disable for improved performance. * @since 3.7.0 / protected $generateBestQuality = true; /* * Class constructor. * * @param mixed $source Either a file path for a source image or a GD resource handler for an image. * * @since 1.7.3 * @throws \RuntimeException / public function __construct($source = null) { // Verify that GD support for PHP is available. if (!\extension_loaded('gd')) { // @codeCoverageIgnoreStart throw new \RuntimeException('The GD extension for PHP is not available.'); // @codeCoverageIgnoreEnd } // Determine which image types are supported by GD, but only once. if (empty(static::$formats)) { $info = gd_info(); static::$formats[IMAGETYPE_JPEG] = $info['JPEG Support']; static::$formats[IMAGETYPE_PNG] = $info['PNG Support']; static::$formats[IMAGETYPE_GIF] = $info['GIF Read Support']; static::$formats[IMAGETYPE_WEBP] = $info['WebP Support']; } /* * If the source input is a resource, set it as the image handle. * @todo: Remove check for resource when we only support PHP 8 / if ( $source && (\is_object($source) && get_class($source) == 'GdImage') \|\| (\is_resource($source) && get_resource_type($source) == 'gd') ) { $this->handle = $source; } elseif (!empty($source) && \is_string($source)) { // If the source input is not empty, assume it is a path and populate the image handle. $this->loadFile($source); } } /* * Get the image resource handle * * @return resource * * @since 3.8.0 * @throws \LogicException if an image has not been loaded into the instance / public function getHandle() { // Make sure the resource handle is valid. if (!$this->isLoaded()) { throw new \LogicException('No valid image was loaded.'); } return $this->handle; } /* * Method to return a properties object for an image given a filesystem path. * * The result object has values for image width, height, type, attributes, mime type, bits, and channels. * * @param string $path The filesystem path to the image for which to get properties. * * @return \stdClass * * @since 2.5.0 * @throws \InvalidArgumentException * @throws \RuntimeException / public static function getImageFileProperties($path) { // Make sure the file exists. if (!is_file($path)) { throw new \InvalidArgumentException('The image file does not exist.'); } // Get the image file information. $info = getimagesize($path); if (!$info) { throw new Exception\UnparsableImageException('Unable to get properties for the image.'); } // Build the response object. return (object) [ 'width' => $info[0], 'height' => $info[1], 'type' => $info[2], 'attributes' => $info[3], 'bits' => $info['bits'] ?? null, 'channels' => $info['channels'] ?? null, 'mime' => $info['mime'], 'filesize' => filesize($path), 'orientation' => self::getOrientationString((int) $info[0], (int) $info[1]), ]; } /* * Method to detect whether an image's orientation is landscape, portrait or square. * * The orientation will be returned as a string. * * @return mixed Orientation string or null. * * @since 3.4.2 / public function getOrientation() { if ($this->isLoaded()) { return self::getOrientationString($this->getWidth(), $this->getHeight()); } return null; } /* * Compare width and height integers to determine image orientation. * * @param integer $width The width value to use for calculation * @param integer $height The height value to use for calculation * * @return string Orientation string * * @since 3.4.2 / private static function getOrientationString(int $width, int $height): string { switch (true) { case ($width > $height): return self::ORIENTATION_LANDSCAPE; case ($width < $height): return self::ORIENTATION_PORTRAIT; default: return self::ORIENTATION_SQUARE; } } /* * Method to generate thumbnails from the current image. It allows creation by resizing or cropping the original image. * * @param mixed $thumbSizes String or array of strings. Example: $thumbSizes = array('150x75','250x150'); * @param integer $creationMethod 1-3 resize $scaleMethod \| 4 create cropping \| 5 resize then crop * * @return array * * @since 2.5.0 * @throws \LogicException * @throws \InvalidArgumentException / public function generateThumbs($thumbSizes, $creationMethod = self::SCALE_INSIDE) { // Make sure the resource handle is valid. if (!$this->isLoaded()) { throw new \LogicException('No valid image was loaded.'); } // Accept a single thumbsize string as parameter if (!\is_array($thumbSizes)) { $thumbSizes = [$thumbSizes]; } // Process thumbs $generated = []; if (!empty($thumbSizes)) { foreach ($thumbSizes as $thumbSize) { // Desired thumbnail size $size = explode('x', strtolower($thumbSize)); if (\count($size) != 2) { throw new \InvalidArgumentException('Invalid thumb size received: ' . $thumbSize); } $thumbWidth = $size[0]; $thumbHeight = $size[1]; switch ($creationMethod) { case self::CROP: $thumb = $this->crop($thumbWidth, $thumbHeight, null, null, true); break; case self::CROP_RESIZE: $thumb = $this->cropResize($thumbWidth, $thumbHeight, true); break; default: $thumb = $this->resize($thumbWidth, $thumbHeight, true, $creationMethod); break; } // Store the thumb in the results array $generated[] = $thumb; } } return $generated; } /* * Method to create thumbnails from the current image and save them to disk. It allows creation by resizing or cropping the original image. * * @param mixed $thumbSizes string or array of strings. Example: $thumbSizes = ['150x75','250x150']; * @param integer $creationMethod 1-3 resize $scaleMethod \| 4 create cropping * @param string $thumbsFolder destination thumbs folder. null generates a thumbs folder in the image folder * @param boolean $useOriginalName Shall we use the original image name? Defaults is false, {filename}_{width}x{height}.{ext} * * @return array * * @since 4.3.0 * @throws \LogicException * @throws \InvalidArgumentException / public function createThumbnails($thumbSizes, $creationMethod = self::SCALE_INSIDE, $thumbsFolder = null, $useOriginalName = false) { // Make sure the resource handle is valid. if (!$this->isLoaded()) { throw new \LogicException('No valid image was loaded.'); } // No thumbFolder set -> we will create a thumbs folder in the current image folder if (\is_null($thumbsFolder)) { $thumbsFolder = \dirname($this->getPath()) . '/thumbs'; } // Check destination if (!is_dir($thumbsFolder) && (!is_dir(\dirname($thumbsFolder)) \|\| !@mkdir($thumbsFolder))) { throw new \InvalidArgumentException('Folder does not exist and cannot be created: ' . $thumbsFolder); } // Process thumbs $thumbsCreated = []; if ($thumbs = $this->generateThumbs($thumbSizes, $creationMethod)) { // Parent image properties $imgProperties = static::getImageFileProperties($this->getPath()); // Get image filename and extension. $pathInfo = pathinfo($this->getPath()); $filename = $pathInfo['filename']; $fileExtension = $pathInfo['extension'] ?? ''; foreach ($thumbs as $thumb) { // Get thumb properties $thumbWidth = $thumb->getWidth(); $thumbHeight = $thumb->getHeight(); if ($useOriginalName) { // Generate thumb name $thumbFileName = $filename . '.' . $fileExtension; } else { // Generate thumb name $thumbFileName = $filename . '_' . $thumbWidth . 'x' . $thumbHeight . '.' . $fileExtension; } // Save thumb file to disk $thumbFileName = $thumbsFolder . '/' . $thumbFileName; if ($thumb->toFile($thumbFileName, $imgProperties->type)) { // Return Image object with thumb path to ease further manipulation $thumb->path = $thumbFileName; $thumbsCreated[] = $thumb; } } } return $thumbsCreated; } /* * Method to create thumbnails from the current image and save them to disk. It allows creation by resizing or cropping the original image. * * @param mixed $thumbSizes string or array of strings. Example: $thumbSizes = ['150x75','250x150']; * @param integer $creationMethod 1-3 resize $scaleMethod \| 4 create cropping * @param string $thumbsFolder destination thumbs folder. null generates a thumbs folder in the image folder * * @return array * * @since 2.5.0 * @throws \LogicException * @throws \InvalidArgumentException * * @deprecated 4.0 will be removed in 6.0 * Use \Joomla\CMS\Image\createThumbnails instead / public function createThumbs($thumbSizes, $creationMethod = self::SCALE_INSIDE, $thumbsFolder = null) { return $this->createThumbnails($thumbSizes, $creationMethod, $thumbsFolder, false); } /* * Method to crop the current image. * * @param mixed $width The width of the image section to crop in pixels or a percentage. * @param mixed $height The height of the image section to crop in pixels or a percentage. * @param integer $left The number of pixels from the left to start cropping. * @param integer $top The number of pixels from the top to start cropping. * @param boolean $createNew If true the current image will be cloned, cropped and returned; else * the current image will be cropped and returned. * * @return Image * * @since 2.5.0 * @throws \LogicException / public function crop($width, $height, $left = null, $top = null, $createNew = true) { // Sanitize width. $width = $this->sanitizeWidth($width, $height); // Sanitize height. $height = $this->sanitizeHeight($height, $width); // Autocrop offsets if (\is_null($left)) { $left = round(($this->getWidth() - $width) / 2); } if (\is_null($top)) { $top = round(($this->getHeight() - $height) / 2); } // Sanitize left. $left = $this->sanitizeOffset($left); // Sanitize top. $top = $this->sanitizeOffset($top); // Create the new truecolor image handle. $handle = imagecreatetruecolor($width, $height); // Allow transparency for the new image handle. imagealphablending($handle, false); imagesavealpha($handle, true); if ($this->isTransparent()) { // Get the transparent color values for the current image. $rgba = imagecolorsforindex($this->getHandle(), imagecolortransparent($this->getHandle())); $color = imagecolorallocatealpha($handle, $rgba['red'], $rgba['green'], $rgba['blue'], $rgba['alpha']); // Set the transparent color values for the new image. imagecolortransparent($handle, $color); imagefill($handle, 0, 0, $color); } if (!$this->generateBestQuality) { imagecopyresized($handle, $this->getHandle(), 0, 0, $left, $top, $width, $height, $width, $height); } else { imagecopyresampled($handle, $this->getHandle(), 0, 0, $left, $top, $width, $height, $width, $height); } // If we are cropping to a new image, create a new Image object. if ($createNew) { return new static($handle); } // Swap out the current handle for the new image handle. $this->destroy(); $this->handle = $handle; return $this; } /* * Method to apply a filter to the image by type. Two examples are: grayscale and sketchy. * * @param string $type The name of the image filter to apply. * @param array $options An array of options for the filter. * * @return Image * * @since 2.5.0 * @see \Joomla\CMS\Image\Filter * @throws \LogicException / public function filter($type, array $options = []) { // Make sure the resource handle is valid. if (!$this->isLoaded()) { throw new \LogicException('No valid image was loaded.'); } // Get the image filter instance. $filter = $this->getFilterInstance($type); // Execute the image filter. $filter->execute($options); return $this; } /* * Method to get the height of the image in pixels. * * @return integer * * @since 2.5.0 * @throws \LogicException / public function getHeight() { return imagesy($this->getHandle()); } /* * Method to get the width of the image in pixels. * * @return integer * * @since 2.5.0 * @throws \LogicException / public function getWidth() { return imagesx($this->getHandle()); } /* * Method to return the path * * @return string * * @since 2.5.0 / public function getPath() { return $this->path; } /* * Method to determine whether or not an image has been loaded into the object. * * @return boolean * * @since 2.5.0 / public function isLoaded() { /* * Make sure the resource handle is valid. * @todo: Remove check for resource when we only support PHP 8 / if ( !((\is_object($this->handle) && get_class($this->handle) == 'GdImage') \|\| (\is_resource($this->handle) && get_resource_type($this->handle) == 'gd')) ) { return false; } return true; } /* * Method to determine whether or not the image has transparency. * * @return boolean * * @since 2.5.0 * @throws \LogicException / public function isTransparent() { return imagecolortransparent($this->getHandle()) >= 0; } /* * Method to load a file into the Image object as the resource. * * @param string $path The filesystem path to load as an image. * * @return void * * @since 2.5.0 * @throws \InvalidArgumentException * @throws \RuntimeException / public function loadFile($path) { // Destroy the current image handle if it exists $this->destroy(); // Make sure the file exists. if (!is_file($path)) { throw new \InvalidArgumentException('The image file does not exist.'); } // Get the image properties. $properties = static::getImageFileProperties($path); // Attempt to load the image based on the MIME-Type switch ($properties->mime) { case 'image/gif': // Make sure the image type is supported. if (empty(static::$formats[IMAGETYPE_GIF])) { throw new \RuntimeException('Attempting to load an image of unsupported type GIF.'); } // Attempt to create the image handle. $handle = imagecreatefromgif($path); $type = 'GIF'; break; case 'image/jpeg': // Make sure the image type is supported. if (empty(static::$formats[IMAGETYPE_JPEG])) { throw new \RuntimeException('Attempting to load an image of unsupported type JPG.'); } // Attempt to create the image handle. $handle = imagecreatefromjpeg($path); $type = 'JPEG'; break; case 'image/png': // Make sure the image type is supported. if (empty(static::$formats[IMAGETYPE_PNG])) { throw new \RuntimeException('Attempting to load an image of unsupported type PNG.'); } // Attempt to create the image handle. $handle = imagecreatefrompng($path); $type = 'PNG'; break; case 'image/webp': // Make sure the image type is supported. if (empty(static::$formats[IMAGETYPE_WEBP])) { throw new \RuntimeException('Attempting to load an image of unsupported type WebP.'); } // Attempt to create the image handle. $handle = imagecreatefromwebp($path); $type = 'WebP'; break; default: throw new \InvalidArgumentException('Attempting to load an image of unsupported type ' . $properties->mime); } /* * Check if handle has been created successfully * @todo: Remove check for resource when we only support PHP 8 / if (!(\is_object($handle) \|\| \is_resource($handle))) { throw new \RuntimeException('Unable to process ' . $type . ' image.'); } $this->handle = $handle; // Set the filesystem path to the source image. $this->path = $path; } /* * Method to resize the current image. * * @param mixed $width The width of the resized image in pixels or a percentage. * @param mixed $height The height of the resized image in pixels or a percentage. * @param boolean $createNew If true the current image will be cloned, resized and returned; else * the current image will be resized and returned. * @param integer $scaleMethod Which method to use for scaling * * @return Image * * @since 2.5.0 * @throws \LogicException / public function resize($width, $height, $createNew = true, $scaleMethod = self::SCALE_INSIDE) { // Sanitize width. $width = $this->sanitizeWidth($width, $height); // Sanitize height. $height = $this->sanitizeHeight($height, $width); // Prepare the dimensions for the resize operation. $dimensions = $this->prepareDimensions($width, $height, $scaleMethod); // Instantiate offset. $offset = new \stdClass(); $offset->x = $offset->y = 0; // Center image if needed and create the new truecolor image handle. if ($scaleMethod == self::SCALE_FIT) { // Get the offsets $offset->x = round(($width - $dimensions->width) / 2); $offset->y = round(($height - $dimensions->height) / 2); $handle = imagecreatetruecolor($width, $height); // Make image transparent, otherwise canvas outside initial image would default to black if (!$this->isTransparent()) { $transparency = imagecolorallocatealpha($this->getHandle(), 0, 0, 0, 127); imagecolortransparent($this->getHandle(), $transparency); } } else { $handle = imagecreatetruecolor($dimensions->width, $dimensions->height); } // Allow transparency for the new image handle. imagealphablending($handle, false); imagesavealpha($handle, true); if ($this->isTransparent()) { // Get the transparent color values for the current image. $rgba = imagecolorsforindex($this->getHandle(), imagecolortransparent($this->getHandle())); $color = imagecolorallocatealpha($handle, $rgba['red'], $rgba['green'], $rgba['blue'], $rgba['alpha']); // Set the transparent color values for the new image. imagecolortransparent($handle, $color); imagefill($handle, 0, 0, $color); } if (!$this->generateBestQuality) { imagecopyresized( $handle, $this->getHandle(), $offset->x, $offset->y, 0, 0, $dimensions->width, $dimensions->height, $this->getWidth(), $this->getHeight() ); } else { // Use resampling for better quality imagecopyresampled( $handle, $this->getHandle(), $offset->x, $offset->y, 0, 0, $dimensions->width, $dimensions->height, $this->getWidth(), $this->getHeight() ); } // If we are resizing to a new image, create a new Image object. if ($createNew) { return new static($handle); } // Swap out the current handle for the new image handle. $this->destroy(); $this->handle = $handle; return $this; } /* * Method to crop an image after resizing it to maintain * proportions without having to do all the set up work. * * @param integer $width The desired width of the image in pixels or a percentage. * @param integer $height The desired height of the image in pixels or a percentage. * @param boolean $createNew If true the current image will be cloned, resized, cropped and returned. * * @return Image * * @since 2.5.0 / public function cropResize($width, $height, $createNew = true) { $width = $this->sanitizeWidth($width, $height); $height = $this->sanitizeHeight($height, $width); $resizewidth = $width; $resizeheight = $height; if (($this->getWidth() / $width) < ($this->getHeight() / $height)) { $resizeheight = 0; } else { $resizewidth = 0; } return $this->resize($resizewidth, $resizeheight, $createNew)->crop($width, $height, null, null, false); } /* * Method to rotate the current image. * * @param mixed $angle The angle of rotation for the image * @param integer $background The background color to use when areas are added due to rotation * @param boolean $createNew If true the current image will be cloned, rotated and returned; else * the current image will be rotated and returned. * * @return Image * * @since 2.5.0 * @throws \LogicException / public function rotate($angle, $background = -1, $createNew = true) { // Sanitize input $angle = (float) $angle; // Create the new truecolor image handle. $handle = imagecreatetruecolor($this->getWidth(), $this->getHeight()); // Make background transparent if no external background color is provided. if ($background == -1) { // Allow transparency for the new image handle. imagealphablending($handle, false); imagesavealpha($handle, true); $background = imagecolorallocatealpha($handle, 0, 0, 0, 127); } // Copy the image imagecopy($handle, $this->getHandle(), 0, 0, 0, 0, $this->getWidth(), $this->getHeight()); // Rotate the image $handle = imagerotate($handle, $angle, $background); // If we are resizing to a new image, create a new Image object. if ($createNew) { return new static($handle); } // Swap out the current handle for the new image handle. $this->destroy(); $this->handle = $handle; return $this; } /* * Method to flip the current image. * * @param integer $mode The flip mode for flipping the image {@link http://php.net/imageflip#refsect1-function.imageflip-parameters} * @param boolean $createNew If true the current image will be cloned, flipped and returned; else * the current image will be flipped and returned. * * @return Image * * @since 3.4.2 * @throws \LogicException / public function flip($mode, $createNew = true) { // Create the new truecolor image handle. $handle = imagecreatetruecolor($this->getWidth(), $this->getHeight()); // Copy the image imagecopy($handle, $this->getHandle(), 0, 0, 0, 0, $this->getWidth(), $this->getHeight()); // Flip the image if (!imageflip($handle, $mode)) { throw new \LogicException('Unable to flip the image.'); } // If we are resizing to a new image, create a new Image object. if ($createNew) { // @codeCoverageIgnoreStart return new static($handle); // @codeCoverageIgnoreEnd } // Free the memory from the current handle $this->destroy(); // Swap out the current handle for the new image handle. $this->handle = $handle; return $this; } /* * Watermark the image * * @param Image $watermark The Image object containing the watermark graphic * @param integer $transparency The transparency to use for the watermark graphic * @param integer $bottomMargin The margin from the bottom of this image * @param integer $rightMargin The margin from the right side of this image * * @return Image * * @since 3.8.0 * @link https://secure.php.net/manual/en/image.examples-watermark.php / public function watermark(Image $watermark, $transparency = 50, $bottomMargin = 0, $rightMargin = 0) { imagecopymerge( $this->getHandle(), $watermark->getHandle(), $this->getWidth() - $watermark->getWidth() - $rightMargin, $this->getHeight() - $watermark->getHeight() - $bottomMargin, 0, 0, $watermark->getWidth(), $watermark->getHeight(), $transparency ); return $this; } /* * Method to write the current image out to a file or output directly. * * @param mixed $path The filesystem path to save the image. * When null, the raw image stream will be outputted directly. * @param integer $type The image type to save the file as. * @param array $options The image type options to use in saving the file. * For PNG and JPEG formats use `quality` key to set compression level (0..9 and 0..100) * * @return boolean * * @link http://www.php.net/manual/image.constants.php * @since 2.5.0 * @throws \LogicException / public function toFile($path, $type = IMAGETYPE_JPEG, array $options = []) { switch ($type) { case IMAGETYPE_GIF: return imagegif($this->getHandle(), $path); case IMAGETYPE_PNG: return imagepng($this->getHandle(), $path, (\array_key_exists('quality', $options)) ? $options['quality'] : 0); case IMAGETYPE_WEBP: return imagewebp($this->getHandle(), $path, (\array_key_exists('quality', $options)) ? $options['quality'] : 100); } // Case IMAGETYPE_JPEG & default return imagejpeg($this->getHandle(), $path, (\array_key_exists('quality', $options)) ? $options['quality'] : 100); } /* * Method to get an image filter instance of a specified type. * * @param string $type The image filter type to get. * * @return ImageFilter * * @since 2.5.0 * @throws \RuntimeException / protected function getFilterInstance($type) { // Sanitize the filter type. $type = strtolower(preg_replace('#[^A-Z0-9_]#i', '', $type)); // Verify that the filter type exists. $className = 'JImageFilter' . ucfirst($type); if (!class_exists($className)) { $className = __NAMESPACE__ . '\\Filter\\' . ucfirst($type); if (!class_exists($className)) { throw new \RuntimeException('The ' . ucfirst($type) . ' image filter is not available.'); } } // Instantiate the filter object. $instance = new $className($this->getHandle()); // Verify that the filter type is valid. if (!($instance instanceof ImageFilter)) { throw new \RuntimeException('The ' . ucfirst($type) . ' image filter is not valid.'); } return $instance; } /* * Method to get the new dimensions for a resized image. * * @param integer $width The width of the resized image in pixels. * @param integer $height The height of the resized image in pixels. * @param integer $scaleMethod The method to use for scaling * * @return \stdClass * * @since 2.5.0 * @throws \InvalidArgumentException If width, height or both given as zero / protected function prepareDimensions($width, $height, $scaleMethod) { // Instantiate variables. $dimensions = new \stdClass(); switch ($scaleMethod) { case self::SCALE_FILL: $dimensions->width = (int) round($width); $dimensions->height = (int) round($height); break; case self::SCALE_INSIDE: case self::SCALE_OUTSIDE: case self::SCALE_FIT: $rx = ($width > 0) ? ($this->getWidth() / $width) : 0; $ry = ($height > 0) ? ($this->getHeight() / $height) : 0; if ($scaleMethod != self::SCALE_OUTSIDE) { $ratio = max($rx, $ry); } else { $ratio = min($rx, $ry); } $dimensions->width = (int) round($this->getWidth() / $ratio); $dimensions->height = (int) round($this->getHeight() / $ratio); break; default: throw new \InvalidArgumentException('Invalid scale method.'); } return $dimensions; } /* * Method to sanitize a height value. * * @param mixed $height The input height value to sanitize. * @param mixed $width The input width value for reference. * * @return integer * * @since 2.5.0 / protected function sanitizeHeight($height, $width) { // If no height was given we will assume it is a square and use the width. $height = ($height === null) ? $width : $height; // If we were given a percentage, calculate the integer value. if (preg_match('/^[0-9]+(\.[0-9]+)?\%$/', $height)) { $height = (int) round($this->getHeight() (float) str_replace('%', '', $height) / 100); } else { // Else do some rounding so we come out with a sane integer value. $height = (int) round((float) $height); } return $height; } /** * Method to sanitize an offset value like left or top. * * @param mixed $offset An offset value. * * @return integer * * @since 2.5.0 / protected function sanitizeOffset($offset) { return (int) round((float) $offset); } /* * Method to sanitize a width value. * * @param mixed $width The input width value to sanitize. * @param mixed $height The input height value for reference. * * @return integer * * @since 2.5.0 / protected function sanitizeWidth($width, $height) { // If no width was given we will assume it is a square and use the height. $width = ($width === null) ? $height : $width; // If we were given a percentage, calculate the integer value. if (preg_match('/^[0-9]+(\.[0-9]+)?\%$/', $width)) { $width = (int) round($this->getWidth() (float) str_replace('%', '', $width) / 100); } else { // Else do some rounding so we come out with a sane integer value. $width = (int) round((float) $width); } return $width; } /** * Method to destroy an image handle and * free the memory associated with the handle * * @return boolean True on success, false on failure or if no image is loaded * * @since 2.5.0 / public function destroy() { if ($this->isLoaded()) { return imagedestroy($this->getHandle()); } return false; } /* * Method to call the destroy() method one last time * to free any memory when the object is unset * * @see Image::destroy() * @since 2.5.0 / public function __destruct() { $this->destroy(); } /* * Method for set option of generate thumbnail method * * @param boolean $quality True for best quality. False for best speed. * * @return void * * @since 3.7.0 */ public function setThumbnailGenerate($quality = true) { $this->generateBestQuality = (bool) $quality; } } ��

| ver. 1.4 | Github | . | PHP 8.3.23 | Generation time: 0 | proxy | phpinfo | Settings