FileReference.php

Go to the documentation of this file.

<?php
namespace TYPO3\CMS\Core\Resource;

class FileReference implements FileInterface {

    protected $propertiesOfFileReference;

    protected $uidOfFileReference;

    protected $name;

    protected $originalFile;

    protected $mergedProperties = array();

    public function __construct(array $fileReferenceData, $factory = NULL) {
        $this->propertiesOfFileReference = $fileReferenceData;
        if (!$fileReferenceData['uid_local']) {
            throw new \InvalidArgumentException('Incorrect reference to original file given for FileReference.', 1300098528);
        }
        if (!$factory) {
            $factory = ResourceFactory::getInstance();
        }
        $this->originalFile = $factory->getFileObject($fileReferenceData['uid_local']);
        if (!is_object($this->originalFile)) {
            throw new \RuntimeException('Original File not found for FileReference.', 1300098529);
        }
        $this->name = $fileReferenceData['name'] !== '' ? $fileReferenceData['name'] : $this->originalFile->getName();
    }

    /*******************************
     * VARIOUS FILE PROPERTY GETTERS
     *******************************/
    public function hasProperty($key) {
        return array_key_exists($key, $this->getProperties());
    }

    public function getProperty($key) {
        if (!$this->hasProperty($key)) {
            throw new \InvalidArgumentException('Property "' . $key . '" was not found in file reference or original file.', 1314226805);
        }
        $properties = $this->getProperties();
        return $properties[$key];
    }

    public function getReferenceProperty($key) {
        if (!array_key_exists($key, $this->propertiesOfFileReference)) {
            throw new \InvalidArgumentException('Property "' . $key . '" of file reference was not found.', 1360684914);
        }
        return $this->propertiesOfFileReference[$key];
    }

    public function getProperties() {
        if (empty($this->mergedProperties)) {
            $this->mergedProperties = $this->propertiesOfFileReference;
            \TYPO3\CMS\Core\Utility\ArrayUtility::mergeRecursiveWithOverrule(
                $this->mergedProperties,
                $this->originalFile->getProperties(),
                TRUE,
                TRUE,
                FALSE
            );
            array_walk($this->mergedProperties, array($this, 'restoreNonNullValuesCallback'));
        }

        return $this->mergedProperties;
    }

    protected function restoreNonNullValuesCallback(&$value, $key) {
        if (array_key_exists($key, $this->propertiesOfFileReference) && $this->propertiesOfFileReference[$key] !== NULL) {
            $value = $this->propertiesOfFileReference[$key];
        }
    }

    public function getReferenceProperties() {
        return $this->propertiesOfFileReference;
    }

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

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

    public function getAlternative() {
        return $this->getProperty('alternative');
    }

    public function getDescription() {
        return $this->getProperty('description');
    }

    public function getLink() {
        return $this->propertiesOfFileReference['link'];
    }

    public function getUid() {
        return (int)$this->propertiesOfFileReference['uid'];
    }

    public function getSize() {
        return (int)$this->originalFile->getSize();
    }

    public function getSha1() {
        return $this->originalFile->getSha1();
    }

    public function getExtension() {
        return $this->originalFile->getExtension();
    }

    public function getNameWithoutExtension() {
        return $this->originalFile->getNameWithoutExtension();
    }

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

    public function getModificationTime() {
        return (int)$this->originalFile->getModificationTime();
    }

    public function getCreationTime() {
        return (int)$this->originalFile->getCreationTime();
    }

    public function getType() {
        return (int)$this->originalFile->getType();
    }

    public function isMissing() {
        return (bool) $this->originalFile->getProperty('missing');
    }

    /******************
     * CONTENTS RELATED
     ******************/
    public function getContents() {
        return $this->originalFile->getContents();
    }

    public function setContents($contents) {
        return $this->originalFile->setContents($contents);
    }

    /****************************************
     * STORAGE AND MANAGEMENT RELATED METHDOS
     ****************************************/
    public function getStorage() {
        return $this->originalFile->getStorage();
    }

    public function getIdentifier() {
        return $this->originalFile->getIdentifier();
    }

    public function getCombinedIdentifier() {
        return $this->originalFile->getCombinedIdentifier();
    }

    public function delete() {
        // TODO: Implement this function. This should only delete the
        // FileReference (sys_file_reference) record, not the file itself.
        throw new \BadMethodCallException('Function not implemented FileReference::delete().', 1333754461);
        //return $this->fileRepository->removeUsageRecord($this);
    }

    public function rename($newName) {
        // TODO: Implement this function. This should only rename the
        // FileReference (sys_file_reference) record, not the file itself.
        throw new \BadMethodCallException('Function not implemented FileReference::rename().', 1333754473);
        //return $this->fileRepository->renameUsageRecord($this, $newName);
    }

    /*****************
     * SPECIAL METHODS
     *****************/
    public function getPublicUrl($relativeToCurrentScript = FALSE) {
        return $this->originalFile->getPublicUrl($relativeToCurrentScript);
    }

    public function isIndexed() {
        return TRUE;
    }

    public function getForLocalProcessing($writable = TRUE) {
        return $this->originalFile->getForLocalProcessing($writable);
    }

    public function toArray() {
        $array = array_merge($this->originalFile->toArray(), $this->propertiesOfFileReference);
        return $array;
    }

    public function getOriginalFile() {
        return $this->originalFile;
    }

    public function getHashedIdentifier() {
        return $this->getStorage()->hashFileIdentifier($this->getIdentifier());
    }

    public function getParentFolder() {
        return $this->originalFile->getParentFolder();
    }
}