copy

(PHP 4, PHP 5, PHP 7, PHP 8)

copy — Copies file

Description

copy(string $from, string $to, ?resource $context = null): bool

Makes a copy of the file from to to.

If you wish to move a file, use the rename() function.

Parameters

from

Path to the source file.

to

The destination path. If to 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.

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