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");
?>

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

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

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

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

copy(), unlink(), move_uploaded_file()も参照してください。