rename: ファイルをリネームする (ファイルシステム 関数) - PHPプロ！マニュアル
PHPマニュアル
rename: ファイルをリネームする
rename
(PHP 4, PHP 5)
rename — ファイルをリネームする
説明
bool rename (
string
$oldname , string $newname [, resource $context ] )
oldname を 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() - アップロードされたファイルを新しい位置に移動する
ページのトップへ
再帰関数は最初の内は混乱しますが、非常に上手く使える場面もいずれ出てきます。これを機会に学んでいけるといいですね。