ファイルをリネームする

# rename

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

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

### 説明

function rename(string `$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");
    ?>

### 参考

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

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open