interface UploadedFileInterface in Drupal 10

Provides an interface for uploaded files.

Hierarchy

• interface \Drupal\file\Upload\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

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

Name	Modifiers	Type	Description	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