copy
(PHP 4, PHP 5)
copy — ファイルをコピーする
説明
bool copy
( string $source
, string $dest
[, resource $context
] )
ファイル source を dest にコピーします。
ファイルを移動したいならは、rename() 関数を使用してください。
パラメータ
- source
-
コピー元ファイルへのパス。
- dest
-
コピー先のパス。dest が URL の場合、 既存ファイルへの上書きをラッパーがサポートしていない場合にはコピーが失敗します。
警告コピー先のファイルが既に存在する場合、上書きされます。
- context
-
stream_context_create() で作成した有効なコンテキストリソース。
返り値
成功した場合に TRUE を、失敗した場合に FALSE を返します。
変更履歴
| バージョン | 説明 |
|---|---|
| 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";
}
?>