ModelTrait::getFilePresignedUrl() - Code Metrics - Inspection of "Skip Instance Check" - wanforge/yii2-flysystem - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — main ( 35f9ac...082ac6 )

by Sugeng
created 2023-04-28 12:58 UTC
ModelTrait::getFilePresignedUrl() A

↳ Parent: ModelTrait
Complexity

Conditions	2
Paths	2
Size

Total Lines	9
Code Lines	5
Duplication

Lines	0
Ratio	0 %
Importance

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

namespace diecoding\flysystem\traits;

use League\Flysystem\UnableToDeleteFile;
use League\Flysystem\UnableToWriteFile;
use Yii;
use yii\web\UploadedFile;

/**
 * Trait ModelTrait for Model
 * 
 * @package diecoding\flysystem\traits
 * 
 * @link      https://sugengsulistiyawan.my.id/
 * @author    Sugeng Sulistiyawan <[email protected]>
 * @copyright Copyright (c) 2023
 */
trait ModelTrait
{
    /**
     * @return \diecoding\flysystem\AbstractComponent
     */
    public function getFsComponent()
    {
        return Yii::$app->get('fs');

    }

    /**
     * Save UploadedFile to AWS S3.
     * ! Important: This function uploads this model filename to keep consistency of the model.
     * 
     * @param UploadedFile $file Uploaded file to save
     * @param string $attribute Attribute name where the uploaded filename name will be saved
     * @param string $fileName Name which file will be saved. If empty will use the name from $file
     * @param bool $autoExtension `true` to automatically append or replace the extension to the file name. Default is `true`
     * @param array $config
     * 
     * @return bool `true` for Uploaded full path of filename on success or `false` in failure.
     */
    public function saveUploadedFile(UploadedFile $file, $attribute, $fileName = '', $autoExtension = true, $config = [])
    {
        if ($this->hasError) {
            return false;
        }
        if (empty($fileName)) {
            $fileName = $file->name;
        }
        if ($autoExtension) {
            $_file = (string) pathinfo($fileName, PATHINFO_FILENAME);
            $fileName = $_file . '.' . $file->extension;
        }
        $filePath = $this->getAttributePath($attribute) . $fileName;
        try {
            $localPath = $file->tempName;
            $handle    = fopen($localPath, 'r');
            $contents  = fread($handle, filesize($localPath));
            fclose($handle);
            
            $filesystem = $this->getFsComponent();
            $filesystem->write($filesystem->normalizePath($filePath), $contents, $config);

            return true;
        } catch (UnableToWriteFile $exception) {

            Yii::error([
                'message' => $exception->getMessage(),
                'trace' => $exception->getTraceAsString(),
            ]);

            return false;
        }
    }

    /**
     * Delete model file attribute from AWS S3.
     * 
     * @param string $attribute Attribute name which holds the filename
     * 
     * @return bool `true` on success or if file doesn't exist.
     */
    public function removeFile($attribute)
    {
        if (empty($this->{$attribute})) {
            return true;
        }
        $filePath = $this->getAttributePath($attribute) . $this->{$attribute};
        try {
            $filesystem = $this->getFsComponent();
            $filesystem->delete($this->normalizePath($filePath));
            $filesystem->delete($this->/** @scrutinizer ignore-call */ normalizePath($filePath));

            $this->{$attribute} = null;

            return true;
        } catch (UnableToDeleteFile $exception) {

            Yii::error([
                'message' => $exception->getMessage(),
                'trace' => $exception->getTraceAsString(),
            ]);

            return false;
        }
    }

    /**
     * Retrieves the URL for a given model file attribute.
     * 
     * @param string $attribute Attribute name which holds the filename
     * 
     * @return string URL to access file
     */
    public function getFileUrl($attribute)
    {
        if (empty($this->{$attribute})) {
            return '';
        }

        return $this->getFsComponent()->getUrl($this->getAttributePath($attribute) . $this->{$attribute});
        return $this->getFsComponent()->/** @scrutinizer ignore-call */ getUrl($this->getAttributePath($attribute) . $this->{$attribute});
    }

    /**
     * Retrieves the presigned URL for a given model file attribute.
     * 
     * @param string $attribute Attribute name which holds the filename
     * 
     * @return string Presigned URL to access file
     */
    public function getFilePresignedUrl($attribute)
    {
        if (empty($this->{$attribute})) {
            return '';
        }

        return $this->getFsComponent()->getPresignedUrl(
        return $this->getFsComponent()->/** @scrutinizer ignore-call */ getPresignedUrl(
            $this->getAttributePath($attribute) . $this->{$attribute},
            $this->getPresignedUrlDuration($attribute)
        );
    }

    /**
     * Retrieves the URL signature expiration.
     * 
     * @param string $attribute Attribute name which holds the duration
     * 
     * @return mixed URL expiration
     */
    public function getPresignedUrlDuration($attribute)
    public function getPresignedUrlDuration(/** @scrutinizer ignore-unused */ $attribute)
    {
        return '+30 minutes';
    }

    /**
     * List the paths on AWS S3 to each model file attribute.
     * It must be a Key-Value array, where Key is the attribute name and Value is the base path for the file in S3.
     * Override this method for saving each attribute in its own "folder".
     * 
     * @return array Key-Value of attributes and its paths.
     */
    public function attributePaths()
    {
        return [];
    }

    /**
     * Retrieves the base path on AWS S3 for a given attribute.
     * @see attributePaths()
     * 
     * @param string $attribute Attribute to get its path
     * 
     * @return string The path where all file of that attribute should be stored. Returns empty string if the attribute isn't in the list.
     */
    public function getAttributePath($attribute)
    {
        $paths = $this->attributePaths();
        if (array_key_exists($attribute, $paths)) {
            return $paths[$attribute];
        }

        return '';
    }
}

wanforge / yii2-flysystem

Push — main ( 35f9ac...082ac6 )

ModelTrait::getFilePresignedUrl() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
