file_move
includes/file.inc, строка 329
- Версии
- 5 – 6
file_move(&$source, $dest = 0, $replace = FILE_EXISTS_RENAME)
Перемещает файл в новое место.
- Проверяет, являются ли
$sourceи$destвалидными и доступными для чтения/записи. - Совершает перемещение файла, если
$sourceне равно$dest. - Если файл уже существует в
$dest, то в зависимости от параметра$replaceвызов завершится ошибкой, файл будет переименован или заменит старый.
Параметры
$source Строка, определяющая местонахождение оригинального файла.
Этот параметр будет содержать новое местонахождение файла в случае успешного завершения операции.
$dest Строка, содержащая директорию, в которую должен быть скопирован $source.
Если значение опущено, будет использована директория 'files' Друпала.
$replace Поведение функции в случае, если файл с таким именем уже существует.
- FILE_EXISTS_REPLACE - Заменить существующий файл
- FILE_EXISTS_RENAME - Добавлять _{увеличивающееся число}, пока имя файла не станет уникальным
- FILE_EXISTS_ERROR - Ничего не делать и вернуть
FALSE.
Возвращаемое значение
TRUE в случае удачи, и FALSE при ошибке.
Связанные темы
Код
<?php
function file_move(&$source, $dest = 0, $replace = FILE_EXISTS_RENAME) {
$path_original = is_object($source) ? $source->filepath : $source;
if (file_copy($source, $dest, $replace)) {
$path_current = is_object($source) ? $source->filepath : $source;
if ($path_original == $path_current || file_delete($path_original)) {
return 1;
}
drupal_set_message(t('The removal of the original file %file has failed.', array('%file' => $path_original)), 'error');
}
return 0;
}
?>