Copies file (original) (raw)
copy
(PHP 4, PHP 5, PHP 7)
copy — Copies file
Description
copy ( string $source , string $dest [, resource $context ] ) : bool
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.
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.4 | Changed the context parameter to actually have an effect. Previously, any context was ignored. |
| 5.3.0 | Added context support. |
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