function file_unmanaged_move
Same name in other branches
- 8.9.x core/includes/file.inc \file_unmanaged_move()
Moves a file to a new location without database changes or hook invocation.
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
Related topics
7 calls to file_unmanaged_move()
- FilePrivateTestCase::testPrivateFileDownloadAccessGranted in modules/
file/ tests/ file.test - Tests file access for private nodes when file download access is granted.
- FileUnmanagedMoveTest::testMissing in modules/
simpletest/ tests/ file.test - Try to move a missing file.
- FileUnmanagedMoveTest::testNormal in modules/
simpletest/ tests/ file.test - Move a normal file.
- FileUnmanagedMoveTest::testOverwriteSelf in modules/
simpletest/ tests/ file.test - Try to move a file onto itself.
- file_move in includes/
file.inc - Moves a file to a new location and update the file's database entry.
File
-
includes/
file.inc, line 1139
Code
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;
}
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.