(PHP 4, PHP 5, PHP 7)
rename — ファイルをリネームする
$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");
?>