php / 8.1.5 / function.copy.html /

copy

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

copyCopies 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

© 1997–2021 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/function.copy.php