Same name and namespace in other branches

1. 9 core/lib/Drupal/Core/File/FileSystem.php \Drupal\Core\File\FileSystem::copy()
2. 8.9.x core/lib/Drupal/Core/File/FileSystem.php \Drupal\Core\File\FileSystem::copy()
3. 10 core/lib/Drupal/Core/File/FileSystem.php \Drupal\Core\File\FileSystem::copy()

Copies a file to a new location without invoking the file API.

This is a powerful function that in many ways performs like an advanced version of copy().

• If $source and $destination are valid and readable/writable, then only perform the copy operation.
• If $source and $destination are equal then a FileException exception is thrown.
• If the $destination file already exists, the behavior depends on the $fileExists parameter as follows `FileExists::Error` will error out, `FileExists::Replace` will replace the existing file, and `FileExists::Rename` will assign a new unique name.
• Provides a fallback using realpaths if the move fails using stream wrappers. This can occur because PHP's copy() function does not properly support streams if open_basedir is enabled.

Example:

use Drupal\Core\File\FileExists;
use Drupal\Core\File\FileSystemInterface;
...
$directory = 'public://example-dir';
$file_system = \Drupal::service('file_system');
$file_system->copy($filepath, $directory . '/' . basename($filepath), FileExists::Replace);

In this example, file is copied from $filepath and is replaced at the destination if exists.

Parameters

string $source: A string specifying the filepath or URI of the source file.

string $destination: A URI containing the destination that $source should be copied to. The URI may be a bare filepath (without a scheme).

\Drupal\Core\File\FileExists|int $fileExists: The behavior when the destination file already exists.

Return value

string The path to the new file.

Overrides FileSystemInterface::copy

File

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

Class

FileSystem

Provides helpers to operate on files and stream wrappers.

Namespace

Drupal\Core\File

Code

public function copy($source, $destination, $fileExists = FileExists::Rename) {
  if (!$fileExists instanceof FileExists) {
    // @phpstan-ignore staticMethod.deprecated
    $fileExists = FileExists::fromLegacyInt($fileExists, __METHOD__);
  }
  $this->prepareDestination($source, $destination, $fileExists);
  if (!@copy($source, $destination)) {
    // If the copy failed and realpaths exist, retry the operation using them
    // instead.
    $real_source = $this->realpath($source) ?: $source;
    $real_destination = $this->realpath($destination) ?: $destination;
    if ($real_source === FALSE || $real_destination === FALSE || !@copy($real_source, $real_destination)) {
      throw new FileWriteException("The specified file '{$source}' could not be copied to '{$destination}'.");
    }
  }
  // Set the permissions on the new file.
  $this->chmod($destination);
  return $destination;
}

---