function hook_file_copy

7.x system.api.php hook_file_copy($file, $source)
8.x file.api.php hook_file_copy(Drupal\file\FileInterface $file, Drupal\file\FileInterface $source)

Respond to a file that has been copied.


$file: The newly copied file object.

$source: The original file before the copy.

See also


Related topics

1 function implements hook_file_copy()

Note: this list is generated by pattern matching, so it may include some functions that are not actually implementations of this hook.

file_test_file_copy in drupal/modules/simpletest/tests/file_test.module
Implements hook_file_copy().
1 invocation of hook_file_copy()
file_copy in drupal/includes/
Copies a file to a new location and adds a file record to the database.


drupal/modules/system/system.api.php, line 2913
Hooks provided by Drupal core and the System module.


function hook_file_copy($file, $source) {
  $file_user = user_load($file->uid);
  // Make sure that the file name starts with the owner's user name.
  if (strpos($file->filename, $file_user->name) !== 0) {
    $file->filename = $file_user->name . '_' . $file->filename;

    watchdog('file', t('Copied file %source has been renamed to %destination', array('%source' => $source->filename, '%destination' => $file->filename)));