rename
(PHP 4, PHP 5, PHP 7)
rename — ファイルをリネームする
説明
rename
( string $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() の例
<?phprename("/tmp/tmp_file.txt", "/home/user/login/docs/my_file.txt");?>