PHP Manual: copy


Enter the keyword for better results

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.

Parameters

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.

Return Values

Returns TRUE on success or FALSE on failure.

ChangeLog

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

Examples

Example 1. copy() example

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

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

Notes

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

See Also

move_uploaded_file()
rename()
The section of the manual about handling file uploads