PHPのrename()関数とは？ファイル・ディレクトリの名前変更方法をわかりやすく解説

PHPのrename()関数は、ファイルやディレクトリの名前を変更するための組み込み関数です。処理が成功した場合はTRUEを返し、失敗した場合はFALSEを返します。また、この関数は単なる名前変更だけでなく、ファイルを別のディレクトリへ移動させる用途にも利用できます。

構文（Syntax）

rename(old_filename, new_filename, context)

パラメータ（Parameters）

• old_filename − 名前を変更したいファイルまたはディレクトリの現在の名前（パス）を指定します。

• new_filename − 変更後の新しいファイル名またはディレクトリ名（パス）を指定します。

• context − ストリームの動作を制御するためのコンテキストリソースを指定します（省略可能）。

戻り値（Return）

rename()関数は、処理に成功した場合はTRUE、失敗した場合はFALSEを返します。

使用例1：同じディレクトリ内でファイル名を変更する

<?php
    rename("one.txt", "two.txt");
?>

出力結果

TRUE

上記の例では、カレントディレクトリにある「one.txt」というファイルの名前を「two.txt」に変更しています。

使用例2：別のディレクトリへファイルを移動する

<?php
    rename("D:\new\tutorials\java.docx", "D:\new\tutorials\programming\java.docx");
?>

出力結果

TRUE

この例では、「java.docx」ファイルを「tutorials」フォルダから「programming」フォルダへ移動させています。このように、新しいパスとして別のディレクトリを指定することで、移動と名前変更を同時に行うことも可能です。

注意点

• 対象のファイルやディレクトリに対して適切な読み書き権限が必要です。

• Windows環境では既存のファイルへの上書きが可能ですが、Unix系OSでは挙動が異なる場合があります。

• パスの指定ミスや権限不足などで失敗した場合はFALSEが返されるため、必要に応じてエラーハンドリングを行いましょう。