# copy

(PHP 4, PHP 5, PHP 7)

copy — 拷贝文件

### 说明

copy ( string `$source` , string `$dest` [, resource `$context` ] ) : bool

将文件从 `source` 拷贝到 `dest`。

如果要移动文件的话，请使用 rename() 函数。

### 参数

`source`

  源文件路径。

`dest`

  目标路径。如果 `dest` 是一个 URL，则如果封装协议不支持覆盖已有的文件时拷贝操作会失败。

  Warning

  如果目标文件已存在，将会被覆盖。

`context`

  A valid context resource created with stream_context_create().

### 返回值

成功时返回 `TRUE`， 或者在失败时返回 `FALSE`。

### 更新日志

版本 | 说明
--- | ---
5.3.0 | 增加了对 context 的支持。
4.3.0 | 如果启用了“fopen wrappers”的话，`source` 和 `dest` 都可以是 URL。更多细节见 fopen()。

### 范例

Example #1 copy() 例子

    <?php
    $file = 'example.txt';
    $newfile = 'example.txt.bak';

    if (!copy($file, $newfile)) {
        echo "failed to copy $file...\n";
    }
    ?>

### 参见

- move_uploaded_file() - 将上传的文件移动到新位置
- rename() - 重命名一个文件或目录
- The section of the manual about handling file uploads