copy

(PHP 4, PHP 5, PHP 7)

copyファイルをコピーする

説明

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

ファイル sourcedest にコピーします。

ファイルを移動したいならば、rename() 関数を使用してください。

パラメータ

source

コピー元ファイルへのパス。

dest

コピー先のパス。dest が URL の場合、 既存ファイルへの上書きをラッパーがサポートしていない場合にはコピーが失敗します。

警告

コピー先のファイルが既に存在する場合、上書きされます。

context

stream_context_create() で作成した有効なコンテキストリソース。

返り値

成功した場合に TRUE を、失敗した場合に FALSE を返します。

変更履歴

バージョン 説明
5.3.4 context パラメータが実際に効力を持つようになりました。 以前のバージョンでは、context に何を指定しても無視されていました。
5.3.0 コンテキストのサポートが追加されました。
4.3.0 "fopen wrappers" が有効の場合は sourcedest のどちらにも URL を指定することができます。 詳細は fopen() を参照ください。

例1 copy() の例

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

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

参考