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