ファイルシステム 関数
PHP Manual

rename

(PHP 4, PHP 5)

renameファイルをリネームする

説明

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

oldnamenewname にリネームし、必要ならディレクトリを移動しようと試みます。 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");
?>

参考


ファイルシステム 関数
PHP Manual