UploadedFile.php

Go to the documentation of this file.

<?php
 
/*
 * 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\Http;
 
use Psr\Http\Message\StreamInterface;
use Psr\Http\Message\UploadedFileInterface;
use ‪TYPO3\CMS\Core\Utility\GeneralUtility;
 
class ‪UploadedFile implements UploadedFileInterface
{
    protected ‪$file;
 
    protected ‪$stream;
 
    protected ‪$clientFilename;
 
    protected ‪$clientMediaType;
 
    protected ‪$error;
 
    protected ‪$moved = false;
 
    protected ‪$size;
 
    public function ‪__construct($input, ‪$size, $errorStatus, ‪$clientFilename = null, ‪$clientMediaType = null)
    {
        if (is_string($input)) {
            $this->file = $input;
        }
 
        if (is_resource($input)) {
            $this->stream = new ‪Stream($input);
        } elseif ($input instanceof StreamInterface) {
            $this->stream = $input;
        }
 
        if (!$this->file && !$this->stream) {
            throw new \InvalidArgumentException('The input given was not a valid stream or file.', 1436717301);
        }
 
        if (!is_int(‪$size)) {
            throw new \InvalidArgumentException('The size provided for an uploaded file must be an integer.', 1436717302);
        }
        $this->size = ‪$size;
 
        if (!is_int($errorStatus) || 0 > $errorStatus || 8 < $errorStatus) {
            throw new \InvalidArgumentException('Invalid error status for an uploaded file. See UPLOAD_ERR_* constant in PHP.', 1436717303);
        }
        $this->error = $errorStatus;
 
        if (‪$clientFilename !== null && !is_string(‪$clientFilename)) {
            throw new \InvalidArgumentException('Invalid client filename provided for an uploaded file.', 1436717304);
        }
        $this->clientFilename = ‪$clientFilename;
 
        if (‪$clientMediaType !== null && !is_string(‪$clientMediaType)) {
            throw new \InvalidArgumentException('Invalid client media type provided for an uploaded file.', 1436717305);
        }
        $this->clientMediaType = ‪$clientMediaType;
    }
 
    public function ‪getStream()
    {
        if ($this->moved) {
            throw new \RuntimeException('Cannot retrieve stream as it was moved.', 1436717306);
        }
 
        if ($this->stream instanceof StreamInterface) {
            return ‪$this->stream;
        }
 
        $this->stream = new Stream((string)$this->file);
        return ‪$this->stream;
    }
 
    public function ‪moveTo($targetPath)
    {
        if (!is_string($targetPath) || empty($targetPath)) {
            throw new \InvalidArgumentException('Invalid path while moving an uploaded file.', 1436717307);
        }
 
        if ($this->moved) {
            throw new \RuntimeException('Cannot move uploaded file, as it was already moved.', 1436717308);
        }
 
        // Check if the target path is inside the allowed paths of TYPO3, and make it absolute.
        $targetPath = GeneralUtility::getFileAbsFileName($targetPath);
        if (empty($targetPath)) {
            throw new \RuntimeException('Cannot move uploaded file, as it was already moved.', 1436717309);
        }
 
        if (!empty($this->file) && is_uploaded_file($this->file)) {
            if (GeneralUtility::upload_copy_move($this->file, $targetPath) === false) {
                throw new \RuntimeException('An error occurred while moving uploaded file', 1436717310);
            }
        } elseif ($this->stream) {
            $handle = fopen($targetPath, 'wb+');
            if ($handle === false) {
                throw new \RuntimeException('Unable to write to target path.', 1436717311);
            }
 
            $this->stream->rewind();
            while (!$this->stream->eof()) {
                fwrite($handle, $this->stream->read(4096));
            }
 
            fclose($handle);
        }
 
        $this->moved = true;
    }
 
    public function ‪getSize()
    {
        return ‪$this->size;
    }
 
    public function ‪getError()
    {
        return ‪$this->error;
    }
 
    public function ‪getClientFilename()
    {
        return ‪$this->clientFilename;
    }
 
    public function ‪getClientMediaType()
    {
        return ‪$this->clientMediaType;
    }
}