function FileSystem::move

Same name in other branches
  1. 8.9.x core/lib/Drupal/Core/File/FileSystem.php \Drupal\Core\File\FileSystem::move()
  2. 10 core/lib/Drupal/Core/File/FileSystem.php \Drupal\Core\File\FileSystem::move()
  3. 11.x core/lib/Drupal/Core/File/FileSystem.php \Drupal\Core\File\FileSystem::move()

Overrides FileSystemInterface::move

1 call to FileSystem::move()
FileSystem::saveData in core/lib/Drupal/Core/File/FileSystem.php
Saves a file to the specified destination without invoking file API.

File

core/lib/Drupal/Core/File/FileSystem.php, line 377

Class

FileSystem
Provides helpers to operate on files and stream wrappers.

Namespace

Drupal\Core\File

Code

public function move($source, $destination, $replace = self::EXISTS_RENAME) {
    $this->prepareDestination($source, $destination, $replace);
    // Ensure compatibility with Windows.
    // @see \Drupal\Core\File\FileSystemInterface::unlink().
    if (!$this->streamWrapperManager
        ->isValidUri($source) && substr(PHP_OS, 0, 3) == 'WIN') {
        chmod($source, 0600);
    }
    // Attempt to resolve the URIs. This is necessary in certain
    // configurations (see above) and can also permit fast moves across local
    // schemes.
    $real_source = $this->realpath($source) ?: $source;
    $real_destination = $this->realpath($destination) ?: $destination;
    // Perform the move operation.
    if (!@rename($real_source, $real_destination)) {
        // Fall back to slow copy and unlink procedure. This is necessary for
        // renames across schemes that are not local, or where rename() has not
        // been implemented. It's not necessary to use FileSystem::unlink() as the
        // Windows issue has already been resolved above.
        if (!@copy($real_source, $real_destination)) {
            $this->logger
                ->error("The specified file '%source' could not be moved to '%destination'.", [
                '%source' => $source,
                '%destination' => $destination,
            ]);
            throw new FileWriteException("The specified file '{$source}' could not be moved to '{$destination}'.");
        }
        if (!@unlink($real_source)) {
            $this->logger
                ->error("The source file '%source' could not be unlinked after copying to '%destination'.", [
                '%source' => $source,
                '%destination' => $destination,
            ]);
            throw new FileException("The source file '{$source}' could not be unlinked after copying to '{$destination}'.");
        }
    }
    // Set the permissions on the new file.
    $this->chmod($destination);
    return $destination;
}

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