rename

(PHP 4, PHP 5, PHP 7, PHP 8)

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() の例

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

参考

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