COPY(3) 1 COPY(3)
copy - Copies file
SYNOPSIS
bool copy (string $source, string $dest, [resource $context])
DESCRIPTION
Makes a copy of the file $source to $dest.
If you wish to move a file, use the rename(3) function.
PARAMETERS
o $source
- Path to the source file.
o $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.
o $context
- A valid context resource created with stream_context_create(3).
RETURN VALUES
Returns TRUE on success or FALSE on failure.
CHANGELOG
+--------+---------------------------------------------------+
|Version | |
| | |
| | Description |
| | |
+--------+---------------------------------------------------+
| 5.3.4 | |
| | |
| | Changed the $context parameter to actually have |
| | an effect. Previously, any $context was ignored. |
| | |
| 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(3) |
| | for more details. |
| | |
+--------+---------------------------------------------------+
EXAMPLES
Example #1
copy(3) example
<?php
$file = 'example.txt';
$newfile = 'example.txt.bak';
if (!copy($file, $newfile)) {
echo "failed to copy $file...
";
}
?>
SEE ALSO
move_uploaded_file(3), rename(3), The section of the manual about handling file uploads.
PHP Documentation Group COPY(3)