ファイルをリネームする

# rename

(PHP 4, PHP 5, PHP 7)

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

### 説明

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

`oldname` を `newname` にリネームし、必要ならディレクトリを移動しようと試みます。 ファイル名の変更かつ `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");
?>`

### 参考

- copy() - ファイルをコピーする
- unlink() - ファイルを削除する
- move_uploaded_file() - アップロードされたファイルを新しい位置に移動する