| 1.20.x system.api.php | hook_file_copy(File $file, File $source) | 
Respond to a file that has been copied.
Parameters
File $file: The newly copied file entity.
File $source: The original file before the copy.
See also
Related topics
File
- modules/system/ system.api.php, line 2271 
- Hooks provided by Backdrop core and the System module.
Code
function hook_file_copy(File $file, 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;
    $file->save();
    watchdog('file', t('Copied file %source has been renamed to %destination', array('%source' => $source->filename, '%destination' => $file->filename)));
  }
}