copy

(PHP 4, PHP 5, PHP 7)

copy — ファイルをコピーする

説明

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

ファイル source を dest にコピーします。

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

パラメータ

source

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

dest

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

警告

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

context

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

返り値

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

変更履歴

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

例

例1 copy() の例

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

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

参考