PHP Manual
Prev		Next

copy

(PHP 3, PHP 4, PHP 5)

copy -- Copies file

Description

bool copy ( string source, string dest )

Makes a copy of the file source to dest.

If you wish to move a file, use the rename() function.

source

Path to the source file.

dest

The destination path. If dest is a URL, the copy operation may fail if the wrapper does not support overwriting of existing files.

Warning

If the destination file already exists, it will be overwritten.

Returns TRUE on success or FALSE on failure.

Version	Description
4.3.0	Both `source` and `dest` may now be URLs if the "fopen wrappers" have been enabled. See fopen() for more details.

Example 1. copy() example


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

if (!copy($file, $newfile)) {
    echo "failed to copy $file...\n";
}
?>

Note: Windows compatibility: If you copy a file with no size, copy() will return FALSE, but the file will be correctly copied.

Prev	Home	Next
clearstatcache	Up	delete