MWFileProps.php

Go to the documentation of this file.

<?php
class MWFileProps {
    private $magic;
 
    public function __construct( MimeAnalyzer $magic ) {
        $this->magic = $magic;
    }
 
    public function getPropsFromPath( $path, $ext ) {
        $fsFile = new FSFile( $path );
 
        $info = $this->newPlaceholderProps();
        $info['fileExists'] = $fsFile->exists();
        if ( $info['fileExists'] ) {
            $info['size'] = $fsFile->getSize(); // bytes
            $info['sha1'] = $fsFile->getSha1Base36();
 
            # MIME type according to file contents
            $info['file-mime'] = $this->magic->guessMimeType( $path, false );
            # Logical MIME type
            $ext = ( $ext === true ) ? FileBackend::extensionFromPath( $path ) : $ext;
 
            # XXX: MimeAnalyzer::improveTypeFromExtension() may return null (T253483).
            # Unclear if callers of this method expect that.
            $info['mime'] = $this->magic->improveTypeFromExtension( $info['file-mime'], $ext );
 
            list( $info['major_mime'], $info['minor_mime'] ) = File::splitMime( $info['mime'] );
            $info['media_type'] = $this->magic->getMediaType( $path, $info['mime'] );
 
            # Height, width and metadata
            $handler = MediaHandler::getHandler( $info['mime'] );
            if ( $handler ) {
                $info['metadata'] = $handler->getMetadata( $fsFile, $path );
                // @phan-suppress-next-line PhanParamTooMany
                $gis = $handler->getImageSize( $fsFile, $path, $info['metadata'] );
                if ( is_array( $gis ) ) {
                    $info = $this->extractImageSizeInfo( $gis ) + $info;
                }
            }
        }
 
        return $info;
    }
 
    private function extractImageSizeInfo( array $gis ) {
        $info = [];
        # NOTE: $gis[2] contains a code for the image type. This is no longer used.
        $info['width'] = $gis[0];
        $info['height'] = $gis[1];
        $info['bits'] = $gis['bits'] ?? 0;
 
        return $info;
    }
 
    public function newPlaceholderProps() {
        return FSFile::placeholderProps() + [
            'metadata' => '',
            'width' => 0,
            'height' => 0,
            'bits' => 0,
            'media_type' => MEDIATYPE_UNKNOWN
        ];
    }
}