ファイルをリネームする

bool rename ( string $oldname , string $newname [, resource $context ] )

oldname を newname にリネームし、必要ならディレクトリを移動しようと試みます。 newname が存在する場合は、上書きします。

oldname: 注意:
変更前の名前。 oldname で使用されるラッパーは、 newname で使用するラッパーと適合 している必要があります 。
newname: 変更後の名前。
context: 注意: コンテキストのサポートは、 PHP 5.0.0 で追加されました。contexts の説明に関しては、ストリームを参照してください。

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

バージョン	説明
5.3.1	rename() は Windows で別のドライブにリネームできるようになりました。
5.0.0	rename() はいくつかの URL ラッパーを併用することができるようになりました。 rename() をサポートしているラッパーの一覧については、サポートするプロトコル/ラッパーを参照ください。
4.3.3	rename() は nix ベースシステムでパーティション越しにファイル名を変更できるようになりました。適切なパーミッションが保持されます。移動先のファイルシステムで chown()* あるいは chmod() といったシステムコールが実行できない場合 (移動先のファイルシステムが FAT である場合など) は警告が発生します。

例1 rename() の例


<?php
rename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");
?>