copy
(PHP 4, PHP 5)
copy — Copies file
Description
bool copy
( string $source
, string $dest
[, resource $context
] )
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.
WarningIf the destination file already exists, it will be overwritten.
- context
-
A valid context resource created with stream_context_create().
Return Values
Returns TRUE on success or FALSE on failure.
Changelog
| Version | Description |
|---|---|
| 5.3.0 | Added context support. |
| 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";
}
?>
See Also
- move_uploaded_file() - Moves an uploaded file to a new location
- rename() - Renames a file or directory
- The section of the manual about handling file uploads