Home › API reference › file.inc

file_unmanaged_move

  1. drupal
    1. 7
Versions
7 file_unmanaged_move($source, $destination = NULL, $replace = FILE_EXISTS_RENAME)

Move a file to a new location without calling any hooks or making any changes to the database.

Parameters

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

$destination A string containing the destination that $source should be moved to. This must be a stream wrapper URI. If this value is omitted, Drupal's default files scheme will be used, usually "public://".

$replace Replace behavior when the destination file already exists:

  • FILE_EXISTS_REPLACE - Replace the existing file.
  • FILE_EXISTS_RENAME - Append _{incrementing number} until the filename is unique.
  • FILE_EXISTS_ERROR - Do nothing and return FALSE.

Return value

The URI of the moved file, or FALSE in the event of an error.

See also

file_move()

Related topics

File interface
Common file handling functions.

▸ 3 functions call file_unmanaged_move()

▾ 3 functions call file_unmanaged_move()

file_move in drupal/includes/file.inc
Move a file to a new location and update the file's database entry.
file_unmanaged_save_data in drupal/includes/file.inc
Save a string to the specified destination without invoking file API.
image_gd_save in drupal/modules/system/image.gd.inc
GD helper to write an image resource to a destination file.

Code

drupal/includes/file.inc, line 1054

<?php
function file_unmanaged_move($source, $destination = NULL, $replace = FILE_EXISTS_RENAME) {
  $filepath = file_unmanaged_copy($source, $destination, $replace);
  if ($filepath == FALSE || file_unmanaged_delete($source) == FALSE) {
    return FALSE;
  }
  return $filepath;
}
?>