rename

(PHP 3, PHP 4, PHP 5)

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

説明

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

oldnamenewnameにリネームしようと試みます。

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

例 1. rename() の例

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

注意: PHP 4.3.3 未満では、rename() は *nix ベースシステムにおいて パーティション越しにファイル名を変更することはできません。

注意: PHP 5.0.0 以降、rename()いくつかの URL ラッパーを併用することが可能です。 rename() をサポートしているラッパーの一覧については、 付録O を参照ください。

注意: oldname で使用されるラッパーは、 newname で使用するラッパーと適合 している必要があります

注意: コンテキストのサポートは、 PHP 5.0.0 で追加されました。contexts の説明に関しては、 参照CLX, ストリーム関数 を参照してください。

copy()unlink() および move_uploaded_file() も参照ください。