FSFile.php

Go to the documentation of this file.

<?php
class FSFile {
    protected $path;

    protected $sha1Base36;

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

    public function getPath() {
        return $this->path;
    }

    public function exists() {
        return is_file( $this->path );
    }

    public function getSize() {
        return filesize( $this->path );
    }

    public function getTimestamp() {
        MediaWiki\suppressWarnings();
        $timestamp = filemtime( $this->path );
        MediaWiki\restoreWarnings();
        if ( $timestamp !== false ) {
            $timestamp = wfTimestamp( TS_MW, $timestamp );
        }

        return $timestamp;
    }

    public function getProps( $ext = true ) {
        $info = self::placeholderProps();
        $info['fileExists'] = $this->exists();

        if ( $info['fileExists'] ) {
            $info['size'] = $this->getSize(); // bytes
            $info['sha1'] = $this->getSha1Base36();

            $mime = mime_content_type( $this->path );
            # MIME type according to file contents
            $info['file-mime'] = ( $mime === false ) ? 'unknown/unknown' : $mime;
            # logical MIME type
            $info['mime'] = $mime;

            if ( strpos( $mime, '/' ) !== false ) {
                list( $info['major_mime'], $info['minor_mime'] ) = explode( '/', $mime, 2 );
            } else {
                list( $info['major_mime'], $info['minor_mime'] ) = [ $mime, 'unknown' ];
            }
        }

        return $info;
    }

    public static function placeholderProps() {
        $info = [];
        $info['fileExists'] = false;
        $info['size'] = 0;
        $info['file-mime'] = null;
        $info['major_mime'] = null;
        $info['minor_mime'] = null;
        $info['mime'] = null;
        $info['sha1'] = '';

        return $info;
    }

    public function getSha1Base36( $recache = false ) {
        if ( $this->sha1Base36 !== null && !$recache ) {
            return $this->sha1Base36;
        }

        MediaWiki\suppressWarnings();
        $this->sha1Base36 = sha1_file( $this->path );
        MediaWiki\restoreWarnings();

        if ( $this->sha1Base36 !== false ) {
            $this->sha1Base36 = Wikimedia\base_convert( $this->sha1Base36, 16, 36, 31 );
        }

        return $this->sha1Base36;
    }

    public static function extensionFromPath( $path ) {
        $i = strrpos( $path, '.' );

        return strtolower( $i ? substr( $path, $i + 1 ) : '' );
    }

    public static function getPropsFromPath( $path, $ext = true ) {
        $fsFile = new self( $path );

        return $fsFile->getProps( $ext );
    }

    public static function getSha1Base36FromPath( $path ) {
        $fsFile = new self( $path );

        return $fsFile->getSha1Base36();
    }
}