OneFileInfo::isImage() - Code Metrics - Inspection of "FIX: cleanup" - sunnysideup/silverstripe-assets_overview - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — master ( b0afa4...2243e7 )

by Nicolaas
created 2025-01-08 23:26 UTC
OneFileInfo::isImage() A

↳ Parent: OneFileInfo
Complexity

Conditions	2
Paths	2
Size

Total Lines	9
Code Lines	5
Duplication

Lines	0
Ratio	0 %
Importance

Changes
Metric	Value
cc	2
eloc	5
c	0
b	0
f	0
nc	2
nop	1
dl	0
loc	9
rs	10
<?php

namespace Sunnysideup\AssetsOverview\Files;

use Exception;
use SilverStripe\Assets\File;
use SilverStripe\Assets\Folder;
use SilverStripe\Assets\Storage\DBFile;
use SilverStripe\Control\Controller;
use SilverStripe\Core\Config\Configurable;
use SilverStripe\Core\Injector\Injectable;
use SilverStripe\Core\Injector\Injector;
use SilverStripe\ORM\DataObject;
use SilverStripe\ORM\DB;
use SilverStripe\ORM\FieldType\DBDate;
use SilverStripe\ORM\FieldType\DBDatetime;
use SilverStripe\ORM\ValidationResult;
use Sunnysideup\AssetsOverview\Interfaces\FileInfo;
use Sunnysideup\AssetsOverview\Traits\Cacher;
use Sunnysideup\AssetsOverview\Traits\FilesystemRelatedTraits;
use Sunnysideup\Flush\FlushNow;

class OneFileInfo implements FileInfo
{
    use FilesystemRelatedTraits;
    use Injectable;
    use Configurable;
    use Cacher;
    use FlushNow;

    protected static array $cached_inst = [];

    public static function inst(string $path, ?bool $exists = null): OneFileInfo
    {
        if (!isset(self::$cached_inst[$path])) {
            self::$cached_inst[$path] = new OneFileInfo($path, $exists);
        }
        return self::$cached_inst[$path];
    }

    protected bool $debug = false;

    protected array $errorFields = [
        'ErrorDBNotPresent',
        'ErrorDBNotPresentLive',
        'ErrorDBNotPresentStaging',
        'ErrorExtensionMisMatch',
        'ErrorFindingFolder',
        'ErrorInFilename',
        'ErrorInSs3Ss4Comparison',
        'ErrorParentID',
        'ErrorInDraftOnly',
        'ErrorNotInDraft',
    ];

    /**
     * @var string
     */
    protected string $hash = '';

    /**
     * @var string
     */
    protected string $path = '';
    protected string $absoletePath = '';

    /**
     * @var array
     */
    protected array $intel = [];

    /**
     * @var array
     */
    protected array $parthParts = [];

    /**
     * @var bool
     */
    protected bool $fileExists = false;

    protected array $folderCache = [];

    public function __construct(string $location, ?bool $fileExists = null)
    {
        $this->path = $location;
        $this->absoletePath = ASSETS_PATH . DIRECTORY_SEPARATOR . $this->path;
        $this->hash = md5($this->path);
        $this->fileExists = null === $fileExists ? file_exists($this->absoletePath) : $fileExists;
    }

    public function toArray(?bool $recalc = false): array
    {
        $cachekey = $this->getCacheKey();
        if (! $this->hasCacheKey($cachekey) || $recalc) {
            $this->getUncachedIntel();
            if ($this->debug) {
                echo $this->intel['ErrorHasAnyError'] ? 'x ' : '✓ ';
            }
            $this->setCacheValue($cachekey, $this->intel);
        } else {
            $this->intel = $this->getCacheValue($cachekey);
        }

        return $this->intel;
    }

    protected function getUncachedIntel(): void
    {

        $this->addFileSystemDetails();
        $this->addImageDetails();

        $obj = AllFilesInfo::inst();
        $dbFileData = $obj->getAnyData($this->intel['Path']);
        $this->addFolderDetails($dbFileData);
        $this->addDBDetails($dbFileData);
        $this->addCalculatedValues();
        $this->addHumanValues();
        ksort($this->intel);
    }

    protected function isRegularImage(string $extension): bool
    {
        return in_array(
            strtolower($extension),
            ['jpg', 'gif', 'png', 'webp', 'jpeg', 'bmp', 'tiff', 'svg'],
            true
        );
    }

    protected function isImage(string $absolutePath): bool
    {
        try {
            $outcome = (bool) @exif_imagetype($absolutePath);
        } catch (Exception $exception) {
            $outcome = false;
        }

        return $outcome;
    }

    protected function addFileSystemDetails()
    {
        //get path parts
        $this->parthParts = [];
        if ($this->fileExists) {
            $this->parthParts = pathinfo($this->absoletePath);
class Id
{
    public $id;

    public function __construct($id)
    {
        $this->id = $id;
    }

}

class Account
{
    /** @var  Id $id */
    public $id;
}

$account_id = false;

if (starsAreRight()) {
    $account_id = new Id(42);
}

$account = new Account();
if ($account instanceof Id)
{
    $account->id = $account_id;
}
        }

        $this->parthParts['extension'] = $this->parthParts['extension'] ?? '';
        $this->parthParts['filename'] = $this->parthParts['filename'] ?? '';
        $this->parthParts['dirname'] = $this->parthParts['dirname'] ?? '';

        //basics!
        $this->intel['Path'] = $this->path;
        $this->intel['PathFolderPath'] = $this->parthParts['dirname'] ?: dirname($this->intel['Path']);
        //file name
        $this->intel['PathFileName'] = $this->parthParts['filename'] ?: basename($this->absoletePath);
        $this->intel['PathFileNameFirstLetter'] = strtoupper(substr((string) $this->intel['PathFileName'], 0, 1));

        //defaults
        $this->intel['ErrorIsInFileSystem'] = true;
        $this->intel['PathFileSize'] = 0;
        $this->intel['IsDir'] = is_dir($this->absoletePath);

        //in file details
        if ($this->fileExists) {
            $this->intel['ErrorIsInFileSystem'] = false;
            $this->intel['PathFileSize'] = filesize($this->absoletePath);
        }

        //path
        $this->intel['PathFromPublicRoot'] = trim(str_replace($this->getPublicBaseFolder(), '', (string) $this->absoletePath), DIRECTORY_SEPARATOR);
        $this->intel['Path'] = trim($this->path, '/');
        $this->intel['AbsoletePath'] = Controller::join_links(ASSETS_PATH, $this->intel['Path']);
        $this->intel['PathFolderFromAssets'] = dirname($this->path);
        if ('.' === $this->intel['PathFolderFromAssets']) {
            $this->intel['PathFolderFromAssets'] = '--in-root-folder--';
        }

        //folder
        // $relativeDirFromAssetsFolder = str_replace($this->getAssetsBaseFolder(), '', (string) $this->intel['PathFolderPath']);

        //extension
        $this->intel['PathExtension'] = $this->parthParts['extension'] ?: $this->getExtension($this->path);
        $this->intel['PathExtensionAsLower'] = (string) strtolower($this->intel['PathExtension']);
        $this->intel['ErrorExtensionMisMatch'] = $this->intel['PathExtension'] !== $this->intel['PathExtensionAsLower'];
        $pathExtensionWithDot = '.' . $this->intel['PathExtension'];
        $extensionLength = strlen((string) $pathExtensionWithDot);
        $pathLength = strlen((string) $this->intel['PathFileName']);
        if (substr((string) $this->intel['PathFileName'], (-1 * $extensionLength)) === $pathExtensionWithDot) {
            $this->intel['PathFileName'] = substr((string) $this->intel['PathFileName'], 0, ($pathLength - $extensionLength));
        }

        $this->intel['ErrorInvalidExtension'] = false;
        if (false !== $this->intel['IsDir']) {
            $test = Injector::inst()->get(DBFile::class);
            $validationResult = Injector::inst()->get(ValidationResult::class);
            $this->intel['ErrorInvalidExtension'] = (bool) $test->validate(
                $validationResult,
                $this->intel['PathFileName']
            );
        }
    }

    protected function addImageDetails()
    {
        $this->intel['ImageRatio'] = '0';
        $this->intel['ImagePixels'] = 'n/a';
        $this->intel['ImageIsImage'] = $this->isRegularImage($this->intel['PathExtension']);
        $this->intel['ImageIsRegularImage'] = false;
        $this->intel['ImageWidth'] = 0;
        $this->intel['ImageHeight'] = 0;
        $this->intel['ImageType'] = $this->intel['PathExtension'];
        $this->intel['ImageAttribute'] = 'n/a';

        if ($this->fileExists) {
            $this->intel['ImageIsRegularImage'] = $this->isRegularImage($this->intel['PathExtension']);
            $this->intel['ImageIsImage'] = $this->intel['ImageIsRegularImage'] ? true : $this->isImage($this->absoletePath);
            if ($this->intel['ImageIsImage']) {
                try {
                    list($width, $height, $type, $attr) = getimagesize($this->absoletePath);
                } catch (Exception $exception) {
                    $width = 0;
                    $height = 0;
                    $type = 0;
                    $attr = [];
                }
                $this->intel['ImageAttribute'] = print_r($attr, 1);
                $this->intel['ImageWidth'] = $width;
                $this->intel['ImageHeight'] = $height;
                if ($height > 0) {
                    $this->intel['ImageRatio'] = round($width / $height, 3);
                } else {
                    $this->intel['ImageRatio'] = 0;
                }
                $this->intel['ImagePixels'] = $width * $height;
                $this->intel['ImageType'] = $type;
                $this->intel['IsResizedImage'] = (bool) strpos($this->intel['PathFileName'], '__');
            }
        }
    }

    protected function addFolderDetails($dbFileData)
    {
        $folder = [];
        if (! empty($dbFileData['ParentID'])) {
            if (isset($this->folderCache[$dbFileData['ParentID']])) {
                $folder = $this->folderCache[$dbFileData['ParentID']];
            } else {
                $sql = 'SELECT * FROM "File" WHERE "ID" = ' . $dbFileData['ParentID'];
                $rows = DB::query($sql);
                foreach ($rows as $folder) {
                    $this->folderCache[$dbFileData['ParentID']] = $folder;
                }
            }
        }

        if (empty($folder)) {
            $this->intel['ErrorFindingFolder'] = ! empty($dbFileData['ParentID']);
            $this->intel['FolderID'] = 0;
        } else {
            $this->intel['ErrorFindingFolder'] = false;
            $this->intel['FolderID'] = $folder['ID'];
        }

        $this->intel['FolderCMSEditLink'] = '/admin/assets/show/' . $this->intel['FolderID'] . '/';
    }

    protected function addDBDetails($dbFileData)
    {
        $time = 0;
        if (empty($dbFileData)) {
            $this->intel['ErrorParentID'] = false;
            $this->intel['DBID'] = 0;
            $this->intel['DBClassName'] = 'Not in database';
            $this->intel['DBParentID'] = 0;
            $this->intel['DBPath'] = '';
            $this->intel['DBFilenameSS3'] = '';
            $this->intel['DBFilenameSS4'] = '';
            $this->intel['ErrorDBNotPresentStaging'] = true;
            $this->intel['ErrorDBNotPresentLive'] = true;
            $this->intel['ErrorInDraftOnly'] = false;
            $this->intel['ErrorNotInDraft'] = false;
            $this->intel['DBCMSEditLink'] = '/admin/assets/';
            $this->intel['DBTitle'] = '-- no title set in database';
            $this->intel['ErrorInFilename'] = false;
            $this->intel['ErrorInSs3Ss4Comparison'] = false;
            if ($this->fileExists) {
                $time = filemtime($this->absoletePath);
            }
        } else {
            $obj = AllFilesInfo::inst();
            $dbFileData['Filename'] = $dbFileData['Filename'] ?? '';
            $this->intel['DBID'] = $dbFileData['ID'];
            $this->intel['DBClassName'] = $dbFileData['ClassName'];
            $this->intel['DBParentID'] = $dbFileData['ParentID'];
            $this->intel['DBPath'] = $dbFileData['FileFilename'] ?? $dbFileData['Filename'] ?? '';
            $this->intel['DBFilename'] = $dbFileData['Name'] ?: basename($this->intel['DBPath']);
            $existsOnStaging = $obj->existsOnStaging($this->intel['DBID']);
            $existsOnLive = $obj->existsOnLive($this->intel['DBID']);
            $this->intel['ErrorDBNotPresentStaging'] = ! $existsOnStaging;
            $this->intel['ErrorDBNotPresentLive'] = ! $existsOnLive;
            $this->intel['ErrorInDraftOnly'] = $existsOnStaging && ! $existsOnLive;
            $this->intel['ErrorNotInDraft'] = ! $existsOnStaging && $existsOnLive;
            $this->intel['DBCMSEditLink'] = '/admin/assets/EditForm/field/File/item/' . $this->intel['DBID'] . '/edit';
            $this->intel['DBTitle'] = $dbFileData['Title'];
            $this->intel['DBFilenameSS4'] = $dbFileData['FileFilename'];
            $this->intel['DBFilenameSS3'] = $dbFileData['Filename'];
            $this->intel['ErrorInFilename'] = $this->intel['Path'] !== $this->intel['DBPath'];
            $ss3FileName = $dbFileData['Filename'] ?? '';
            if ('assets/' === substr((string) $ss3FileName, 0, strlen('assets/'))) {
                $ss3FileName = substr((string) $ss3FileName, strlen('assets/'));
            }

            $this->intel['ErrorInSs3Ss4Comparison'] = $this->intel['DBFilenameSS3'] && $dbFileData['FileFilename'] !== $ss3FileName;
            $time = strtotime((string) $dbFileData['LastEdited']);
            $this->intel['ErrorParentID'] = true;
            if (0 === (int) $this->intel['FolderID']) {
                $this->intel['ErrorParentID'] = (bool) (int) $dbFileData['ParentID'];
            } elseif ($this->intel['FolderID']) {
                $this->intel['ErrorParentID'] = (int) $this->intel['FolderID'] !== (int) $dbFileData['ParentID'];
            }
        }

        $this->intel['ErrorDBNotPresent'] = $this->intel['ErrorDBNotPresentLive'] && $this->intel['ErrorDBNotPresentStaging'];

        $this->intel['DBLastEditedTS'] = $time;
        $this->intel['DBLastEdited'] = DBDate::create_field(DBDatetime::class, $time)->Ago();

        $this->intel['DBTitleFirstLetter'] = strtoupper(substr((string) $this->intel['DBTitle'], 0, 1));
    }

    protected function addHumanValues()
    {
        $this->intel['HumanImageDimensions'] = $this->intel['ImageWidth'] . 'px wide by ' . $this->intel['ImageHeight'] . 'px high';
        $this->intel['HumanImageIsImage'] = $this->intel['ImageIsImage'] ? 'Is image' : 'Is not an image';
        $this->intel['HumanErrorExtensionMisMatch'] = $this->intel['ErrorExtensionMisMatch'] ?
            'irregular extension' : 'normal extension';

        //file size
        $this->intel['HumanFileSize'] = $this->humanFileSize($this->intel['PathFileSize']);
        $this->intel['HumanFileSizeRounded'] = '~ ' . $this->humanFileSize(round($this->intel['PathFileSize'] / 204800) * 204800);
        $this->intel['HumanFileSizeRounded'] = '~ ' . $this->humanFileSize(/** @scrutinizer ignore-type */ round($this->intel['PathFileSize'] / 204800) * 204800);
        $this->intel['HumanErrorIsInFileSystem'] = $this->intel['ErrorIsInFileSystem'] ? 'File does not exist' : 'File exists';

        $this->intel['HumanFolderIsInOrder'] = $this->intel['FolderID'] ? 'In sub-folder' : 'In root folder';

        $this->intel['HumanErrorInFilename'] = $this->intel['ErrorInFilename'] ? 'Error in filename case' : 'No error in filename case';
        $this->intel['HumanErrorParentID'] = $this->intel['ErrorParentID'] ? 'Error in folder ID' : 'Perfect folder ID';
        $stageDBStatus = $this->intel['ErrorDBNotPresentStaging'] ? 'Is not on draft site' : ' Is on draft site';
        $liveDBStatus = $this->intel['ErrorDBNotPresentLive'] ? 'Is not on live site' : ' Is on live site';
        $this->intel['HumanErrorDBNotPresent'] = $stageDBStatus . ', ' . $liveDBStatus;
        $this->intel['HumanErrorInSs3Ss4Comparison'] = $this->intel['ErrorInSs3Ss4Comparison'] ?
            'Filename and FileFilename do not match' : 'Filename and FileFilename match';
        $this->intel['HumanIcon'] = File::get_icon_for_extension($this->intel['PathExtensionAsLower']);
    }

    protected function addCalculatedValues()
    {
        $this->intel['ErrorHasAnyError'] = false;
        foreach ($this->errorFields as $field) {
            if ($this->intel[$field]) {
                $this->intel['ErrorHasAnyError'] = true;
            }
        }
    }

    // protected function getBackupDataObject()
    // {
    //     $file = DataObject::get_one(File::class, ['FileFilename' => $this->intel['Path']]);
    //     //backup for file ...
    //     if (! $file) {
    //         if ($folder) {
    //             $nameInDB = $this->intel['PathFileName'] . '.' . $this->intel['PathExtension'];
    //             $file = DataObject::get_one(File::class, ['Name' => $nameInDB, 'ParentID' => $folder->ID]);
    //         }
    //     }
    //     $filter = ['FileFilename' => $this->intel['PathFolderFromAssets']];
    //     if (Folder::get()->filter($filter)->count() === 1) {
    //         $folder = DataObject::get_one(Folder::class, $filter);
    //     }
    //
    //     return $file;
    // }

    //#############################################
    // CACHE
    //#############################################

    protected function getCacheKey(): string
    {
        return $this->hash;
    }
}

sunnysideup / silverstripe-assets_overview

Push — master ( b0afa4...2243e7 )

OneFileInfo::isImage() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
