interface UploadedFileInterface

Same name and namespace in other branches
  1. 9 core/modules/file/src/Upload/UploadedFileInterface.php \Drupal\file\Upload\UploadedFileInterface
  2. 10 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

2 files declare their use of UploadedFileInterface
FileUploadHandlerTest.php in core/modules/file/tests/src/Kernel/FileUploadHandlerTest.php
LegacyFileUploadHandlerTest.php in core/modules/file/tests/src/Kernel/Upload/LegacyFileUploadHandlerTest.php

File

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

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;
  
  /**
   * 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;
  
  /**
   * Validates the uploaded file information.
   *
   * @param \Symfony\Component\Validator\Validator\ValidatorInterface $validator
   *   A validator object.
   * @param array $options
   *   Options to pass to a constraint.
   *
   * @return \Symfony\Component\Validator\ConstraintViolationListInterface
   *   The list of violations.
   */
  public function validate(ValidatorInterface $validator, array $options = []) : ConstraintViolationListInterface;

}

Members

Title Sort descending Modifiers Object type Summary Overrides
UploadedFileInterface::getClientOriginalName public function Returns the original file name. 2
UploadedFileInterface::getFilename public function Gets the filename. 2
UploadedFileInterface::getPathname public function Gets the path to the file. 2
UploadedFileInterface::getRealPath public function Gets the absolute path to the file. 2
UploadedFileInterface::getSize public function Gets file size. 2
UploadedFileInterface::validate public function Validates the uploaded file information. 2

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