File.php

Go to the documentation of this file.

<?php
 
declare(strict_types=1);
 
/*
 * This file is part of the TYPO3 CMS project.
 *
 * It is free software; you can redistribute it and/or modify it under
 * the terms of the GNU General Public License, either version 2
 * of the License, or any later version.
 *
 * For the full copyright and license information, please read the
 * LICENSE.txt file that was distributed with this source code.
 *
 * The TYPO3 project - inspiring people to share!
 */
 
namespace ‪TYPO3\CMS\Core\Resource;
 
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
 
class ‪File extends ‪AbstractFile
{
    protected ‪$updatedProperties = [];
 
    private ‪$metaDataAspect;
 
    public function ‪__construct(array $fileData, ‪ResourceStorage ‪$storage, array $metaData = [])
    {
        $this->identifier = $fileData['identifier'] ?? null;
        $this->name = $fileData['name'] ?? '';
        $this->‪properties = $fileData;
        $this->storage = ‪$storage;
 
        if (!empty($metaData)) {
            $this->‪getMetaData()->add($metaData);
        }
    }
 
    /*******************************
     * VARIOUS FILE PROPERTY GETTERS
     *******************************/
    public function ‪getProperty(string $key): mixed
    {
        if (parent::hasProperty($key)) {
            return parent::getProperty($key);
        }
        return $this->‪getMetaData()[$key];
    }
 
    public function ‪hasProperty($key): bool
    {
        if (!parent::hasProperty($key)) {
            return isset($this->‪getMetaData()[$key]);
        }
        return true;
    }
 
    public function ‪getProperties(): array
    {
        return array_merge(
            parent::getProperties(),
            array_diff_key($this->‪getMetaData()->get(), parent::getProperties()),
            [
                'metadata_uid' => $this->‪getMetaData()->get()['uid'] ?? 0,
            ]
        );
    }
 
    /******************
     * CONTENTS RELATED
     ******************/
    public function ‪getContents(): string
    {
        return $this->‪getStorage()->getFileContents($this);
    }
 
    public function ‪getSha1(): string
    {
        if (empty($this->‪properties['sha1'])) {
            $this->‪properties['sha1'] = parent::getSha1();
        }
        return $this->‪properties['sha1'];
    }
 
    public function ‪setContents(string $contents): self
    {
        $this->‪getStorage()->setFileContents($this, $contents);
        return $this;
    }
 
    /***********************
     * INDEX RELATED METHODS
     ***********************/
    public function ‪isIndexed(): bool
    {
        return true;
    }
 
    public function ‪updateProperties(array ‪$properties)
    {
        // Setting identifier and name to update values; we have to do this
        // here because we might need a new identifier when loading
        // (and thus possibly indexing) a file.
        if (isset(‪$properties['identifier'])) {
            $this->identifier = ‪$properties['identifier'];
        }
        if (isset(‪$properties['name'])) {
            $this->name = ‪$properties['name'];
        }
 
        if (isset(‪$properties['uid']) && $this->‪properties['uid'] != 0) {
            unset(‪$properties['uid']);
        }
        foreach (‪$properties as $key => $value) {
            if (!isset($this->‪properties[$key]) || $this->‪properties[$key] !== $value) {
                if (!in_array($key, $this->updatedProperties)) {
                    $this->updatedProperties[] = $key;
                }
                $this->‪properties[$key] = $value;
            }
        }
        // If the mime_type property should be updated and it was changed also update the type.
        if (array_key_exists('mime_type', ‪$properties) && in_array('mime_type', $this->updatedProperties)) {
            $this->updatedProperties[] = 'type';
            unset($this->‪properties['type']);
            $this->‪getType();
        }
        if (array_key_exists('storage', ‪$properties) && in_array('storage', $this->updatedProperties)) {
            $this->storage = GeneralUtility::makeInstance(StorageRepository::class)->findByUid((int)‪$properties['storage']);
        }
    }
 
    public function ‪getUpdatedProperties()
    {
        return ‪$this->updatedProperties;
    }
 
    /****************************************
     * STORAGE AND MANAGEMENT RELATED METHODS
     ****************************************/
    public function ‪checkActionPermission($action)
    {
        return $this->‪getStorage()->checkFileActionPermission($action, $this);
    }
 
    /*****************
     * SPECIAL METHODS
     *****************/
    public function ‪calculateChecksum()
    {
        return md5(
            $this->‪getCombinedIdentifier() . '|' .
            $this->‪getMimeType() . '|' .
            ‪$GLOBALS['TYPO3_CONF_VARS']['SYS']['encryptionKey']
        );
    }
 
    public function ‪process(string $taskType, array $configuration): ‪ProcessedFile
    {
        return $this->‪getStorage()->processFile($this, $taskType, $configuration);
    }
 
    public function toArray(): array
    {
        ‪$array = [
            'id' => $this->‪getCombinedIdentifier(),
            'name' => $this->‪getName(),
            'extension' => $this->‪getExtension(),
            'type' => $this->‪getType(),
            'mimetype' => $this->‪getMimeType(),
            'size' => $this->getSize(),
            'url' => $this->‪getPublicUrl(),
            'indexed' => true,
            'uid' => $this->‪getUid(),
            'permissions' => [
                'read' => $this->‪checkActionPermission('read'),
                'write' => $this->‪checkActionPermission('write'),
                'delete' => $this->‪checkActionPermission('delete'),
            ],
            'checksum' => $this->‪calculateChecksum(),
        ];
        foreach ($this->‪properties as $key => $value) {
            ‪$array[$key] = $value;
        }
        ‪$stat = $this->‪getStorage()->getFileInfo($this);
        foreach (‪$stat as $key => $value) {
            ‪$array[$key] = $value;
        }
        return ‪$array;
    }
 
    public function ‪isMissing()
    {
        return (bool)$this->‪getProperty('missing');
    }
 
    public function ‪setMissing($missing)
    {
        $this->‪updateProperties(['missing' => $missing ? 1 : 0]);
    }
 
    public function ‪getPublicUrl(): ?string
    {
        if ($this->‪isMissing() || $this->deleted) {
            return null;
        }
        return $this->‪getStorage()->‪getPublicUrl($this);
    }
 
    public function ‪_getPropertyRaw($key)
    {
        return parent::getProperty($key);
    }
 
    public function ‪getMetaData(): MetaDataAspect
    {
        if ($this->metaDataAspect === null) {
            $this->metaDataAspect = GeneralUtility::makeInstance(MetaDataAspect::class, $this);
        }
        return ‪$this->metaDataAspect;
    }
}