(PHP 4, PHP 5)
copy — 拷贝文件
$source
, string $dest
)
将文件从 source
拷贝到 dest
。成功时返回 TRUE
, 或者在失败时返回 FALSE
.
Example #1 copy() 例子
<?php
$file = 'example.txt';
$newfile = 'example.txt.bak';
if (!copy($file, $newfile)) {
echo "failed to copy $file...\n";
}
?>
如果要移动文件的话,请使用 rename() 函数。
Note:
从 PHP 4.3.0 开始,如果启用了“fopen wrappers”的话,
source
和dest
都可以是 URL。更多细节见 fopen()。如果dest
是一个 URL,则如果封装协议不支持覆盖已有的文件时拷贝操作会失败。
如果目标文件已存在,将会被覆盖。
Note: Windows 兼容
如果复制一个零字节的文件, copy() 将返回
FALSE
,但文件也会被正确复制。
参见 move_uploaded_file(), rename() 和手册中的文件上传处理一章。
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.
If the destination file already exists, it will be overwritten.
context
A valid context resource created with stream_context_create().
成功时返回 TRUE
, 或者在失败时返回 FALSE
.
版本 | 说明 |
---|---|
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() for more details.
|
Example #2 copy() example
<?php
$file = 'example.txt';
$newfile = 'example.txt.bak';
if (!copy($file, $newfile)) {
echo "failed to copy $file...\n";
}
?>