Php/docs/function.rename

提供:Dev Guides
< Php
移動先:案内検索

rename

(PHP 4, PHP 5, PHP 7)

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


説明

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

oldnamenewname にリネームし、必要ならディレクトリを移動しようと試みます。 ファイル名の変更かつ newname が存在する場合、上書きされます。 ディレクトリ名の変更かつ newname が存在する場合、 この関数は警告を発します。


パラメータ

oldname

変更前の名前。

注意:

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

newname

変更後の名前。

注意:

Windows では、newname が既に存在する場合、 そのファイルは書き込み可能でなければなりません。 書き込み可能でない場合、rename() は失敗し、 E_WARNING が発生します。

context

注意: コンテキストのサポートは、

PHP 5.0.0 で追加されました。contexts の説明に関しては、

ストリーム を参照してください。


返り値

成功した場合に true を、失敗した場合に false を返します。


例1 rename() の例

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

参考

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