function file_unmanaged_move in Zircon Profile 8

Same name and namespace in other branches

1. 8.0 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

file_move()

Related topics

8 calls to file_unmanaged_move()

EntityFile::writeFile in core/modules/file/src/Plugin/migrate/destination/EntityFile.php

Tries to move or copy a file.

file_move in core/modules/file/file.module

Moves a file to a new location and update the file's database entry.

file_unmanaged_save_data in core/includes/file.inc

Saves a file to the specified destination without invoking file API.

GDToolkit::save in core/modules/system/src/Plugin/ImageToolkit/GDToolkit.php

Writes an image resource to a destination file.

ImageItem::generateSampleValue in core/modules/image/src/Plugin/Field/FieldType/ImageItem.php

Generates placeholder field values.

... See full list

File

core/includes/file.inc, line 589

API for handling file uploads and server file management.

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;
}