public function UploadedFile::move

Moves the file to a new location.

@api

Parameters

string $directory The destination folder:

string $name The new file name:

Return value

File A File object representing the new file

Throws

FileException if, for any reason, the file could not have been moved

Overrides File::move

File

drupal/core/vendor/symfony/http-foundation/Symfony/Component/HttpFoundation/File/UploadedFile.php, line 236

Class

UploadedFile

A file uploaded through a form.

Namespace

Code

public function move($directory, $name = null) {
  if ($this
    ->isValid()) {
    if ($this->test) {
      return parent::move($directory, $name);
    }
    $target = $this
      ->getTargetFile($directory, $name);
    if (!@move_uploaded_file($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 $target;
  }
  throw new FileException($this
    ->getErrorMessage($this
    ->getError()));
}