ArchivedFile.php

Go to the documentation of this file.

<?php
class ArchivedFile {
        var $id, # filearchive row ID
                $name, # image name
                $group, # FileStore storage group
                $key, # FileStore sha1 key
                $size, # file dimensions
                $bits,  # size in bytes
                $width, # width
                $height, # height
                $metadata, # metadata string
                $mime, # mime type
                $media_type, # media type
                $description, # upload description
                $user, # user ID of uploader
                $user_text, # user name of uploader
                $timestamp, # time of upload
                $dataLoaded, # Whether or not all this has been loaded from the database (loadFromXxx)
                $deleted, # Bitfield akin to rev_deleted
                $sha1, # sha1 hash of file content
                $pageCount,
                $archive_name;

        var $handler;
        var $title; # image title

        function __construct( $title, $id = 0, $key = '' ) {
                $this->id = -1;
                $this->title = false;
                $this->name = false;
                $this->group = 'deleted'; // needed for direct use of constructor
                $this->key = '';
                $this->size = 0;
                $this->bits = 0;
                $this->width = 0;
                $this->height = 0;
                $this->metadata = '';
                $this->mime = "unknown/unknown";
                $this->media_type = '';
                $this->description = '';
                $this->user = 0;
                $this->user_text = '';
                $this->timestamp = null;
                $this->deleted = 0;
                $this->dataLoaded = false;
                $this->exists = false;
                $this->sha1 = '';

                if( $title instanceof Title ) {
                        $this->title = File::normalizeTitle( $title, 'exception' );
                        $this->name = $title->getDBkey();
                }

                if ( $id ) {
                        $this->id = $id;
                }

                if ( $key ) {
                        $this->key = $key;
                }

                if ( !$id && !$key && !( $title instanceof Title ) ) {
                        throw new MWException( "No specifications provided to ArchivedFile constructor." );
                }
        }

        public function load() {
                if ( $this->dataLoaded ) {
                        return true;
                }
                $conds = array();

                if( $this->id > 0 ) {
                        $conds['fa_id'] = $this->id;
                }
                if( $this->key ) {
                        $conds['fa_storage_group'] = $this->group;
                        $conds['fa_storage_key'] = $this->key;
                }
                if( $this->title ) {
                        $conds['fa_name'] = $this->title->getDBkey();
                }

                if( !count( $conds ) ) {
                        throw new MWException( "No specific information for retrieving archived file" );
                }

                if( !$this->title || $this->title->getNamespace() == NS_FILE ) {
                        $this->dataLoaded = true; // set it here, to have also true on miss
                        $dbr = wfGetDB( DB_SLAVE );
                        $row = $dbr->selectRow(
                                'filearchive',
                                self::selectFields(),
                                $conds,
                                __METHOD__,
                                array( 'ORDER BY' => 'fa_timestamp DESC' )
                        );
                        if ( !$row ) {
                                // this revision does not exist?
                                return null;
                        }

                        // initialize fields for filestore image object
                        $this->loadFromRow( $row );
                } else {
                        throw new MWException( 'This title does not correspond to an image page.' );
                }
                $this->exists = true;

                return true;
        }

        public static function newFromRow( $row ) {
                $file = new ArchivedFile( Title::makeTitle( NS_FILE, $row->fa_name ) );
                $file->loadFromRow( $row );
                return $file;
        }

        static function selectFields() {
                return array(
                        'fa_id',
                        'fa_name',
                        'fa_archive_name',
                        'fa_storage_key',
                        'fa_storage_group',
                        'fa_size',
                        'fa_bits',
                        'fa_width',
                        'fa_height',
                        'fa_metadata',
                        'fa_media_type',
                        'fa_major_mime',
                        'fa_minor_mime',
                        'fa_description',
                        'fa_user',
                        'fa_user_text',
                        'fa_timestamp',
                        'fa_deleted',
                        'fa_sha1',
                );
        }

        public function loadFromRow( $row ) {
                $this->id = intval( $row->fa_id );
                $this->name = $row->fa_name;
                $this->archive_name = $row->fa_archive_name;
                $this->group = $row->fa_storage_group;
                $this->key = $row->fa_storage_key;
                $this->size = $row->fa_size;
                $this->bits = $row->fa_bits;
                $this->width = $row->fa_width;
                $this->height = $row->fa_height;
                $this->metadata = $row->fa_metadata;
                $this->mime = "$row->fa_major_mime/$row->fa_minor_mime";
                $this->media_type = $row->fa_media_type;
                $this->description = $row->fa_description;
                $this->user = $row->fa_user;
                $this->user_text = $row->fa_user_text;
                $this->timestamp = $row->fa_timestamp;
                $this->deleted = $row->fa_deleted;
                if( isset( $row->fa_sha1 ) ) {
                        $this->sha1 = $row->fa_sha1;
                } else {
                        // old row, populate from key
                        $this->sha1 = LocalRepo::getHashFromKey( $this->key );
                }
        }

        public function getTitle() {
                return $this->title;
        }

        public function getName() {
                return $this->name;
        }

        public function getID() {
                $this->load();
                return $this->id;
        }

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

        public function getKey() {
                $this->load();
                return $this->key;
        }

        public function getStorageKey() {
                return $this->getKey();
        }

        public function getGroup() {
                return $this->group;
        }

        public function getWidth() {
                $this->load();
                return $this->width;
        }

        public function getHeight() {
                $this->load();
                return $this->height;
        }

        public function getMetadata() {
                $this->load();
                return $this->metadata;
        }

        public function getSize() {
                $this->load();
                return $this->size;
        }

        public function getBits() {
                $this->load();
                return $this->bits;
        }

        public function getMimeType() {
                $this->load();
                return $this->mime;
        }

        function getHandler() {
                if ( !isset( $this->handler ) ) {
                        $this->handler = MediaHandler::getHandler( $this->getMimeType() );
                }
                return $this->handler;
        }

        function pageCount() {
                if ( !isset( $this->pageCount ) ) {
                        if ( $this->getHandler() && $this->handler->isMultiPage( $this ) ) {
                                $this->pageCount = $this->handler->pageCount( $this );
                        } else {
                                $this->pageCount = false;
                        }
                }
                return $this->pageCount;
        }

        public function getMediaType() {
                $this->load();
                return $this->media_type;
        }

        public function getTimestamp() {
                $this->load();
                return wfTimestamp( TS_MW, $this->timestamp );
        }

        function getSha1() {
                $this->load();
                return $this->sha1;
        }

        public function getUser() {
                $this->load();
                if( $this->isDeleted( File::DELETED_USER ) ) {
                        return 0;
                } else {
                        return $this->user;
                }
        }

        public function getUserText() {
                $this->load();
                if( $this->isDeleted( File::DELETED_USER ) ) {
                        return 0;
                } else {
                        return $this->user_text;
                }
        }

        public function getDescription() {
                $this->load();
                if( $this->isDeleted( File::DELETED_COMMENT ) ) {
                        return 0;
                } else {
                        return $this->description;
                }
        }

        public function getRawUser() {
                $this->load();
                return $this->user;
        }

        public function getRawUserText() {
                $this->load();
                return $this->user_text;
        }

        public function getRawDescription() {
                $this->load();
                return $this->description;
        }

        public function getVisibility() {
                $this->load();
                return $this->deleted;
        }

        public function isDeleted( $field ) {
                $this->load();
                return ($this->deleted & $field) == $field;
        }

        public function userCan( $field, User $user = null ) {
                $this->load();
                return Revision::userCanBitfield( $this->deleted, $field, $user );
        }
}