rename関数

関数 rename は、ファイルまたはディレクトリの名前を変更します。関数の最初のパラメータはファイルの現在の名前またはパスを受け取り、2番目のパラメータは新しい名前またはパスを受け取ります。関数は成功時に true を、エラー時に false を返します。

構文

phprename(string $oldname, string $newname, resource $context = null): bool

例

ファイルを 'old.txt' から 'new.txt' に名前変更します:

php<?php
  $res = rename('old.txt', 'new.txt');
  var_dump($res);
?>

コード実行結果:

phptrue

例

ファイルを別のディレクトリに移動します:

php<?php
  $res = rename('file.txt', 'newdir/file.txt');
  var_dump($res);
?>

コード実行結果:

phptrue

例

存在しないファイルの名前を変更してみます:

php<?php
  $res = rename('nonexistent.txt', 'new.txt');
  var_dump($res);
?>

コード実行結果:

phpfalse

例

ディレクトリの名前を変更します:

php<?php
  $res = rename('olddir', 'newdir');
  var_dump($res);
?>

コード実行結果:

phptrue

関連項目

  • 関数 copy,
    ファイルをコピーする関数
  • 関数 unlink,
    ファイルを削除する関数
  • 関数 move_uploaded_file,
    アップロードされたファイルを移動する関数