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
destis 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
0044 203 3971 555 (UK)