function drupal_move_uploaded_file
Same name in other branches
- 8.9.x core/includes/file.inc \drupal_move_uploaded_file()
Moves an uploaded file to a new location.
PHP's move_uploaded_file() does not properly support streams if safe_mode or open_basedir are enabled, so this function fills that gap.
Compatibility: normal paths and stream wrappers.
Parameters
$filename: The filename of the uploaded file.
$uri: A string containing the destination URI of the file.
Return value
TRUE on success, or FALSE on failure.
See also
Related topics
1 call to drupal_move_uploaded_file()
- file_save_upload in includes/
file.inc - Saves a file upload to a new location.
File
-
includes/
file.inc, line 1707
Code
function drupal_move_uploaded_file($filename, $uri) {
$result = @move_uploaded_file($filename, $uri);
// PHP's move_uploaded_file() does not properly support streams if safe_mode
// or open_basedir are enabled so if the move failed, try finding a real path
// and retry the move operation.
if (!$result) {
if ($realpath = drupal_realpath($uri)) {
$result = move_uploaded_file($filename, $realpath);
}
else {
$result = move_uploaded_file($filename, $uri);
}
}
return $result;
}
Buggy or inaccurate documentation? Please file an issue. Need support? Need help programming? Connect with the Drupal community.