class File

1. 9.x drupal/core/vendor/symfony/http-foundation/Symfony/Component/HttpFoundation/File/File.php \Symfony\Component\HttpFoundation\File\File
2. 9.x drupal/core/modules/file/lib/Drupal/file/Plugin/views/field/File.php \Drupal\file\Plugin\views\field\File
3. 9.x drupal/core/modules/file/lib/Drupal/file/Plugin/views/wizard/File.php \Drupal\file\Plugin\views\wizard\File
4. 9.x drupal/core/modules/file/lib/Drupal/file/Plugin/Core/Entity/File.php \Drupal\file\Plugin\Core\Entity\File

FileTest.php in drupal/core/vendor/symfony/http-foundation/Symfony/Component/HttpFoundation/Tests/File/FileTest.php

MimeTypeTest.php in drupal/core/vendor/symfony/http-foundation/Symfony/Component/HttpFoundation/Tests/File/MimeType/MimeTypeTest.php

DirectoryTest::testFileCheckDirectoryHandling in drupal/core/modules/system/lib/Drupal/system/Tests/File/DirectoryTest.php

Test directory handling functions.

DirectoryTest::testFileCreateNewFilepath in drupal/core/modules/system/lib/Drupal/system/Tests/File/DirectoryTest.php

This will take a directory and path, and find a valid filepath that is not taken by another file.

DirectoryTest::testFileDestination in drupal/core/modules/system/lib/Drupal/system/Tests/File/DirectoryTest.php

This will test the filepath for a destination based on passed flags and whether or not the file exists.

FileFieldDisplayTest::getInfo in drupal/core/modules/file/lib/Drupal/file/Tests/FileFieldDisplayTest.php

FileFieldPathTest::getInfo in drupal/core/modules/file/lib/Drupal/file/Tests/FileFieldPathTest.php

... See full list

class File extends \SplFileInfo {

  /**
   * Constructs a new file from the given path.
   *
   * @param string  $path      The path to the file
   * @param Boolean $checkPath Whether to check the path or not
   *
   * @throws FileNotFoundException If the given path is not a file
   *
   * @api
   */
  public function __construct($path, $checkPath = true) {
    if ($checkPath && !is_file($path)) {
      throw new FileNotFoundException($path);
    }
    parent::__construct($path);
  }

  /**
   * Returns the extension based on the mime type.
   *
   * If the mime type is unknown, returns null.
   *
   * @return string|null The guessed extension or null if it cannot be guessed
   *
   * @api
   */
  public function guessExtension() {
    $type = $this
      ->getMimeType();
    $guesser = ExtensionGuesser::getInstance();
    return $guesser
      ->guess($type);
  }

  /**
   * Returns the mime type of the file.
   *
   * The mime type is guessed using the functions finfo(), mime_content_type()
   * and the system binary "file" (in this order), depending on which of those
   * is available on the current operating system.
   *
   * @return string|null The guessed mime type (i.e. "application/pdf")
   *
   * @api
   */
  public function getMimeType() {
    $guesser = MimeTypeGuesser::getInstance();
    return $guesser
      ->guess($this
      ->getPathname());
  }

  /**
   * Returns the extension of the file.
   *
   * \SplFileInfo::getExtension() is not available before PHP 5.3.6
   *
   * @return string The extension
   *
   * @api
   */
  public function getExtension() {
    return pathinfo($this
      ->getBasename(), PATHINFO_EXTENSION);
  }

  /**
   * Moves the file to a new location.
   *
   * @param string $directory The destination folder
   * @param string $name      The new file name
   *
   * @return File A File object representing the new file
   *
   * @throws FileException if the target file could not be created
   *
   * @api
   */
  public function move($directory, $name = null) {
    if (!is_dir($directory)) {
      if (false === @mkdir($directory, 0777, true)) {
        throw new FileException(sprintf('Unable to create the "%s" directory', $directory));
      }
    }
    elseif (!is_writable($directory)) {
      throw new FileException(sprintf('Unable to write in the "%s" directory', $directory));
    }
    $target = $directory . DIRECTORY_SEPARATOR . (null === $name ? $this
      ->getBasename() : basename($name));
    if (!@rename($this
      ->getPathname(), $target)) {
      $error = error_get_last();
      throw new FileException(sprintf('Could not move the file "%s" to "%s" (%s)', $this
        ->getPathname(), $target, strip_tags($error['message'])));
    }
    @chmod($target, 0666 & ~umask());
    return new File($target);
  }

}