(PHP 4, PHP 5, PHP 7, PHP 8)
rename — ファイルをリネームする
$from
, string $to
, ?resource $context
= null
): bool
from
を
to
にリネームし、必要ならディレクトリを移動しようと試みます。
ファイル名の変更かつ 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");
?>