copy
(PHP 4, PHP 5, PHP 7)
copy — ファイルをコピーする
説明
bool copy
( string
$source
, string $dest
[, resource $context
] )
ファイル 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";
}
?>
忘却曲線を使ってこの関数を確実に記憶に残す
