copy

(PHP 3, PHP 4, PHP 5)

copy -- Копирует файл

Описание

bool copy ( string source, string dest )

Создает копию файла, чье имя передано в параметре source, в файле с именем dest. Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.

Пример 1. Пример использования функции copy()

<?php
$file
= 'example.txt';
$newfile = 'example.txt.bak';

if (!
copy($file, $newfile)) {
    echo
"не удалось скопировать $file...\n";
}
?>

Если вы хотите переместить файл, воспользуйтесь функцией rename().

Замечание: Начиная с PHP версии 4.3.0, оба параметра, source и dest, могут быть URL'ами, если были включены "упаковщики fopen". За более подробной информацией обратитесь к описанию функции fopen(). Если параметр dest является URL, выполнение функции может завершиться ошибкой, если упаковщик не поддерживает перезапись существующих файлов.

Внимание

Если файл-назначение существует, он будет перезаписан.

Замечание: Замечание отностильно совместимости Windows: Если вы копируете пустой файл, copy() вернёт FALSE, но файл будет нормально скопирован.

См.также описание функций move_uploaded_file(), rename(), а также главу руководства Обработка загрузки файлов.