rename

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

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

説明

rename(string $from, string $to, ?resource $context = null): bool

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

パラメータ

from

変更前の名前。

注意:

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

to

変更後の名前。

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

context

ストリームコンテキストリソース

戻り値

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

例1 rename() の例

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

参考

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

関連キーワード:  ファイル, rename, from, 変更, 存在, 移動, 失敗, 書き込み, 注意, 名前