interface UploadedFileInterface

Same name in other branches
  1. 10 core/modules/file/src/Upload/UploadedFileInterface.php \Drupal\file\Upload\UploadedFileInterface
  2. 11.x core/modules/file/src/Upload/UploadedFileInterface.php \Drupal\file\Upload\UploadedFileInterface

Provides an interface for uploaded files.

Hierarchy

Expanded class hierarchy of UploadedFileInterface

All classes that implement UploadedFileInterface

1 file declares its use of UploadedFileInterface
FileUploadHandlerTest.php in core/modules/file/tests/src/Kernel/FileUploadHandlerTest.php

File

core/modules/file/src/Upload/UploadedFileInterface.php, line 8

Namespace

Drupal\file\Upload
View source
interface UploadedFileInterface {
    
    /**
     * Returns the original file name.
     *
     * The file name is extracted from the request that uploaded the file and as
     * such should not be considered a safe value.
     *
     * @return string
     *   The original file name supplied by the client.
     */
    public function getClientOriginalName() : string;
    
    /**
     * Returns whether the file was uploaded successfully.
     *
     * @return bool
     *   TRUE if the file has been uploaded with HTTP and no error occurred.
     */
    public function isValid() : bool;
    
    /**
     * Returns an informative upload error message.
     *
     * @return string
     *   The error message regarding a failed upload.
     */
    public function getErrorMessage() : string;
    
    /**
     * Returns the upload error code.
     *
     * If the upload was successful, the constant UPLOAD_ERR_OK is returned.
     * Otherwise, one of the other UPLOAD_ERR_XXX constants is returned.
     *
     * @return int
     *   The upload error code.
     */
    public function getError() : int;
    
    /**
     * Gets file size.
     *
     * @return int
     *   The filesize in bytes.
     *
     * @see https://www.php.net/manual/en/splfileinfo.getsize.php
     */
    public function getSize() : int;
    
    /**
     * Gets the absolute path to the file.
     *
     * @return string|false
     *   The path to the file, or FALSE if the file does not exist.
     *
     * @see https://php.net/manual/en/splfileinfo.getrealpath.php
     */
    public function getRealPath();
    
    /**
     * Gets the path to the file.
     *
     * @return string
     *   The path to the file.
     *
     * @see https://php.net/manual/en/splfileinfo.getpathname.php
     */
    public function getPathname() : string;
    
    /**
     * Gets the filename.
     *
     * @return string
     *   The filename.
     *
     * @see https://php.net/manual/en/splfileinfo.getfilename.php
     */
    public function getFilename() : string;

}

Members

Title Sort descending Modifiers Object type Summary Overrides
UploadedFileInterface::getClientOriginalName public function Returns the original file name. 1
UploadedFileInterface::getError public function Returns the upload error code. 1
UploadedFileInterface::getErrorMessage public function Returns an informative upload error message. 1
UploadedFileInterface::getFilename public function Gets the filename. 1
UploadedFileInterface::getPathname public function Gets the path to the file. 1
UploadedFileInterface::getRealPath public function Gets the absolute path to the file. 1
UploadedFileInterface::getSize public function Gets file size. 1
UploadedFileInterface::isValid public function Returns whether the file was uploaded successfully. 1

Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.