UnifiedArchive::getFileData() - Code Metrics - Inspection of "Use separate files for formats" - wapmorgan/UnifiedArchive - Measure and Improve Code Quality continuously with Scrutinizer

Passed
Push — 0.1.x ( 81ff64...72f342 )

by f
created 2018-11-25 08:47 UTC
UnifiedArchive::getFileData() A

↳ Parent: UnifiedArchive
Complexity

Conditions	2
Paths	2
Size

Total Lines	6
Code Lines	3
Duplication

Lines	0
Ratio	0 %
Importance

Changes
Metric	Value
cc	2
eloc	3
nc	2
nop	1
dl	0
loc	6
rs	10
c	0
b	0
f	0
<?php
namespace wapmorgan\UnifiedArchive;

use Archive7z\Archive7z;
filter:
    dependency_paths: ["lib/*"]
use Exception;
use wapmorgan\UnifiedArchive\Formats\BasicFormat;
use wapmorgan\UnifiedArchive\Formats\SevenZip;
use wapmorgan\UnifiedArchive\Formats\Zip;
use ZipArchive;

/**
 * Class which represents archive in one of supported formats.
 */
class UnifiedArchive extends BasicArchive
{
    const VERSION = '0.1.1';

    const ZIP = 'zip';
    const SEVEN_ZIP = '7zip';
    const RAR = 'rar';
    const GZIP = 'gzip';
    const BZIP = 'bzip2';
    const LZMA = 'lzma2';
    const ISO = 'iso';
    const CAB = 'cab';
    const TAR = 'tar';
    const TAR_GZIP = 'tgz';
    const TAR_BZIP = 'tbz2';
    const TAR_LZMA = 'txz';
    const TAR_LZW = 'tar.z';

    /** @var array List of archive format handlers */
    protected static $formatHandlers = [
        self::ZIP => 'Zip',
        self::SEVEN_ZIP => 'SevenZip',
        self::RAR => 'Rar',
        self::GZIP => 'Gzip',
        self::BZIP => 'Bzip',
        self::LZMA => 'Lzma',
        self::ISO => 'Iso',
        self::CAB => 'Cab',
        self::TAR => 'Tar',
        self::TAR_GZIP => 'Tar',
        self::TAR_BZIP => 'Tar',
        self::TAR_LZMA => 'Tar',
        self::TAR_LZW => 'Tar',
    ];

    /** @var array List of archive formats with support state */
    static protected $enabledTypes = [];

    /** @var string Type of current archive */
    protected $type;

    /** @var BasicFormat Adapte for current archive */
    protected $archive;

    /** @var array List of files in current archive */
    protected $files;

    /** @var int Number of files */
    protected $filesQuantity;

    /** @var int Size of uncompressed files */
    protected $uncompressedFilesSize;

    /** @var int Size of compressed files */
    protected $compressedFilesSize;

    /** @var int Size of archive */
    protected $archiveSize;

    /**
     * Creates instance with right type.
     * @param  string $fileName Filename
     * @return UnifiedArchive|null Returns UnifiedArchive in case of successful reading of the file
     * @throws \Exception
     */
    public static function open($fileName)
    {
        self::checkRequirements();

        if (!file_exists($fileName) || !is_readable($fileName))
            throw new Exception('Could not open file: '.$fileName);

        $type = self::detectArchiveType($fileName);
        if (!self::canOpenType($type)) {
            return null;
        }

        return new self($fileName, $type);
        return new self($fileName, /** @scrutinizer ignore-type */ $type);
    }

    /**
     * Checks whether archive can be opened with current system configuration
     * @param string $fileName
     * @return boolean
     */
    public static function canOpenArchive($fileName)
    {
        self::checkRequirements();

        $type = self::detectArchiveType($fileName);
        if ($type !== false && self::canOpenType($type)) {
            return true;
        }

        return false;
    }

    /**
     * Checks whether specific archive type can be opened with current system configuration
     *
     * @param $type
     *
     * @param bool $onOwn
     * @return boolean
     */
    public static function canOpenType($type)
    {
        self::checkRequirements();

        return (isset(self::$enabledTypes[$type]))
            ? self::$enabledTypes[$type]
            : false;
    }

    /**
     * Detect archive type by its filename or content.
     *
     * @param string $fileName
     * @param bool $contentCheck
     * @return string|boolean One of UnifiedArchive type constants OR false if type is not detected
     */
    public static function detectArchiveType($fileName, $contentCheck = true)
    {
        // by file name
        $ext = strtolower(pathinfo($fileName, PATHINFO_EXTENSION));

        // by file name
        if (stripos($fileName, '.tar.') !== false && preg_match('~\.(?<ext>tar\.(gz|bz2|xz|z))$~', strtolower($fileName), $match)) {
            switch ($match['ext']) {
                case 'tar.gz':
                    return self::TAR_GZIP;
                case 'tar.bz2':
                    return self::TAR_BZIP;
                case 'tar.xz':
                    return self::TAR_LZMA;
                case 'tar.z':
                    return self::TAR_LZW;
            }
        }

        switch ($ext) {
            case 'zip':
                return self::ZIP;
            case '7z':
                return self::SEVEN_ZIP;
            case 'rar':
                return self::RAR;
            case 'gz':
                return self::GZIP;
            case 'bz2':
                return self::BZIP;
            case 'xz':
                return self::LZMA;
            case 'iso':
                return self::ISO;
            case 'cab':
                return self::CAB;
            case 'tar':
                return self::TAR;
            case 'tgz':
                return self::TAR_GZIP;
            case 'tbz2':
                return self::TAR_BZIP;
            case 'txz':
                return self::TAR_LZMA;

        }

        // by content
        if ($contentCheck) {
            $mime_type = mime_content_type($fileName);
            switch ($mime_type) {
                case 'application/zip':
                    return self::ZIP;
                case 'application/x-7z-compressed':
                    return self::SEVEN_ZIP;
                case 'application/x-rar':
                    return self::RAR;
                case 'application/zlib':
                    return self::GZIP;
                case 'application/x-bzip2':
                    return self::BZIP;
                case 'application/x-lzma':
                    return self::LZMA;
                case 'application/x-iso9660-image':
                    return self::ISO;
                case 'application/vnd.ms-cab-compressed':
                    return self::CAB;
                case 'application/x-tar':
                    return self::TAR;
                case 'application/x-gtar':
                    return self::TAR_GZIP;

            }
        }

        return false;
    }

    /**
     * Opens the file as one of supported formats.
     *
     * @param string $fileName Filename
     * @param string $type Archive type.
     * @throws Exception If archive can not be opened
     */
    public function __construct($fileName, $type)
    {
        self::checkRequirements();

        $this->type = $type;
        $this->archiveSize = filesize($fileName);

        if (!isset(static::$formatHandlers[$type]))
            throw new Exception('Unsupported archive type: '.$type.' of archive '.$fileName);

        $handler_class = __NAMESPACE__.'\\Formats\\'.static::$formatHandlers[$type];

        $this->archive = new $handler_class($fileName);
        $this->scanArchive();
    }

    /**
     * Rescans array after modification
     */
    protected function scanArchive()
    {
        $information = $this->archive->getArchiveInformation();
        $this->files = $information->files;
        $this->compressedFilesSize = $information->compressedFilesSize;
        $this->uncompressedFilesSize = $information->uncompressedFilesSize;
        $this->filesQuantity = count($information->files);
    }

    /**
     * Closes archive.
     */
    public function __destruct()
    {
        unset($this->archive);
    }

//    /**
//     * Returns an instance of class implementing PclZipOriginalInterface
//     * interface.
//     *
//     * @return PclZipOriginalInterface Returns an instance of a class
//     * implementing PclZipOriginalInterface
//     * @throws Exception
//     */
//    public function getPclZipInterface()
//    {
//        switch ($this->type) {
//            case 'zip':
//                return new PclZipLikeZipArchiveInterface($this->zip);
//        }
//
//        throw new Exception('PclZip-like interface IS NOT available for '.$this->type.' archive format');
//    }

    /**
     * Counts number of files
     * @return int
     */
    public function countFiles()
    {
        return $this->filesQuantity;
    }

    /**
     * Counts size of all uncompressed data (bytes)
     * @return int
     */
    public function countUncompressedFilesSize()
    {
        return $this->uncompressedFilesSize;
    }

    /**
     * Returns size of archive
     * @return int
     */
    public function getArchiveSize()
    {
        return $this->archiveSize;
    }

    /**
     * Returns type of archive
     * @return string
     */
    public function getArchiveType()
    {
        return $this->type;
    }

    /**
     * Counts size of all compressed data (in bytes)
     * @return int
     */
    public function countCompressedFilesSize()
    {
        return $this->compressedFilesSize;
    }

    /**
     * Returns list of files
     * @return array List of files
     */
    public function getFileNames()
    {
        return array_values($this->files);
    }

    /**
     * Checks that file exists in archive
     * @param string $fileName
     * @return bool
     */
    public function isFileExists($fileName)
    {
        return in_array($fileName, $this->files, true);
    }

    /**
     * Returns file metadata
     * @param string $fileName
     * @return ArchiveEntry|bool
     */
    public function getFileData($fileName)
    {
        if (!in_array($fileName, $this->files, true))
            return false;

        return $this->archive->getFileData($fileName);
    }

    /**
     * Returns file content
     *
     * @param $fileName
     *
     * @return bool|string
     * @throws \Exception
     */
    public function getFileContent($fileName)
    {
        if (!in_array($fileName, $this->files, true))
            return false;

        return $this->archive->getFileContent($fileName);
    }

    /**
     * Returns a resource for reading file from archive
     * @param string $fileName
     * @return bool|resource|string
     */
    public function getFileResource($fileName)
    {
        if (!in_array($fileName, $this->files, true))
            return false;

        return $this->archive->getFileResource($fileName);

    }

    /**
     * Unpacks files to disk.
     * @param string $outputFolder Extraction output dir.
     * @param string|array|null $files One files or list of files or null to extract all content.
     * @param bool $expandFilesList Should be expanded paths like 'src/' to all files inside 'src/' dir or not.
     * @return false|int
     * @throws Exception If files can not be extracted
     */
    public function extractFiles($outputFolder, $files = null, $expandFilesList = false)
    {
        if ($files !== null) {
            if (is_string($files)) $files = [$files];

            if ($expandFilesList)
                $files = self::expandFileList($this->files, $files);

            return $this->archive->extractFiles($outputFolder, $files);
        } else {
            return $this->archive->extractArchive($outputFolder);
        }
    }

    /**
     * Updates existing archive by removing files from it.
     * Only 7zip and zip types support deletion.
     * @param string|string[] $fileOrFiles
     * @param bool $expandFilesList
     *
     * @return bool|int
     * @throws Exception
     */
    public function deleteFiles($fileOrFiles, $expandFilesList = false)
    {
        $fileOrFiles = is_string($fileOrFiles) ? [$fileOrFiles] : $fileOrFiles;

        if ($expandFilesList && $fileOrFiles !== null)
            $fileOrFiles = self::expandFileList($this->files, $fileOrFiles);

        $result = $this->archive->deleteFiles($fileOrFiles);
        $this->scanArchive();
        return $result;
    }

    /**
     * Updates existing archive by adding new files.
     *
     * @param string[] $fileOrFiles
     *
     * @return int|bool False if failed, number of added files if success
     * @throws Exception
     */
    public function addFiles($fileOrFiles)
    {
        $files_list = self::createFilesList($fileOrFiles);
        $result = $this->archive->addFiles($files_list);
        $result = $this->archive->addFiles(/** @scrutinizer ignore-type */ $files_list);
        $this->scanArchive();
        return $result;
    }

    /**
     * Creates an archive.
     * @param string|string[]|array $fileOrFiles
     * @param $archiveName
     * @param bool $emulate
     * @return array|bool|int
     * @throws Exception
     */
    public static function archiveFiles($fileOrFiles, $archiveName, $emulate = false)
    {
        if (file_exists($archiveName))
            throw new Exception('Archive '.$archiveName.' already exists!');

        self::checkRequirements();

        $archiveType = self::detectArchiveType($archiveName, false);
//        if (in_array($archiveType, [TarArchive::TAR, TarArchive::TAR_GZIP, TarArchive::TAR_BZIP, TarArchive::TAR_LZMA, TarArchive::TAR_LZW], true))
//            return TarArchive::archiveFiles($fileOrFiles, $archiveName, $emulate);
        if ($archiveType === false)
            return false;

        $files_list = self::createFilesList($fileOrFiles);

        // fake creation: return archive data
        if ($emulate) {
            $totalSize = 0;
            foreach ($files_list as $fn) $totalSize += filesize($fn);

            return array(
                'totalSize' => $totalSize,
                'numberOfFiles' => count($files_list),
                'numberOfFiles' => count(/** @scrutinizer ignore-type */ $files_list),
                'files' => $files_list,
                'type' => $archiveType,
            );
        }

        if (!isset(static::$formatHandlers[$archiveType]))
            throw new Exception('Unsupported archive type: '.$archiveType.' of archive '.$archiveName);

        $handler_class = __NAMESPACE__.'\\Formats\\'.static::$formatHandlers[$archiveType];

        return $handler_class::createArchive($files_list, $archiveName);
    }

    /**
     * Tests system configuration
     */
    protected static function checkRequirements()
    {
        if (empty(self::$enabledTypes)) {
            self::$enabledTypes[self::ZIP] = extension_loaded('zip');
            self::$enabledTypes[self::SEVEN_ZIP] = class_exists('\Archive7z\Archive7z');
            self::$enabledTypes[self::RAR] = extension_loaded('rar');
            self::$enabledTypes[self::GZIP] = extension_loaded('zlib');
            self::$enabledTypes[self::BZIP] = extension_loaded('bz2');
            self::$enabledTypes[self::LZMA] = extension_loaded('xz');
            self::$enabledTypes[self::ISO] = class_exists('\CISOFile');
            self::$enabledTypes[self::CAB] = class_exists('\CabArchive');
            self::$enabledTypes[self::TAR] = class_exists('\Archive_Tar') || class_exists('\PharData');
            self::$enabledTypes[self::TAR_GZIP] = (class_exists('\Archive_Tar') || class_exists('\PharData')) && extension_loaded('zlib');

            self::$enabledTypes[self::TAR_BZIP] = (class_exists('\Archive_Tar') || class_exists('\PharData')) && extension_loaded('bz2');

            self::$enabledTypes[self::TAR_LZMA] = class_exists('\Archive_Tar') && extension_loaded('lzma2');
            self::$enabledTypes[self::TAR_LZMA] = class_exists('\Archive_Tar') && LzwStreamWrapper::isBinaryAvailable();
        }
    }
}

wapmorgan / UnifiedArchive

Push — 0.1.x ( 81ff64...72f342 )

UnifiedArchive::getFileData() A

Complexity

Size

Duplication

Importance

Duplication Side-by-Side

Filter issues like
