{category}

PHP - ファイル操作

rename()

リネーム(ファイルとI/O操作

意味 ファイル名の変更


rename()とは?

rename()関数は、ファイルやディレクトリの名前を変更するためのPHP関数です。既存のファイルやディレクトリに新しい名前を付けることができます。

rename()の具体的な使い方

ファイルの名前変更と移動

// テスト用のファイルを作成
file_put_contents('old_file.txt', 'これはテストファイルです。');

// ファイルの名前を変更
if (rename('old_file.txt', 'new_file.txt')) {
    echo "ファイル名を 'old_file.txt' から 'new_file.txt' に変更しました。\n";
} else {
    echo "ファイル名の変更に失敗しました。\n";
}

// ファイルを別のディレクトリに移動(存在する場合)
if (is_dir('subdir')) {
    if (rename('new_file.txt', 'subdir/moved_file.txt')) {
        echo "ファイルを 'subdir/moved_file.txt' に移動しました。\n";
    } else {
        echo "ファイルの移動に失敗しました。\n";
    }
} else {
    echo "移動先のディレクトリが存在しません。\n";
}

// 結果を確認
echo "\n最終的なファイルの状態:\n";
echo (file_exists('old_file.txt') ? "old_file.txt が存在します。\n" : "old_file.txt は存在しません。\n");
echo (file_exists('new_file.txt') ? "new_file.txt が存在します。\n" : "new_file.txt は存在しません。\n");
echo (file_exists('subdir/moved_file.txt') ? "subdir/moved_file.txt が存在します。\n" : "subdir/moved_file.txt は存在しません。\n");

👇出力結果

ファイル名を 'old_file.txt' から 'new_file.txt' に変更しました。
移動先のディレクトリが存在しません。

最終的なファイルの状態:
old_file.txt は存在しません。
new_file.txt が存在します。
subdir/moved_file.txt は存在しません。

この例では、rename()関数を使用してファイルの名前を変更し、別のディレクトリに移動する方法を示しています。まず、'old_file.txt' を 'new_file.txt' に名前変更し、次に 'new_file.txt' を 'subdir/moved_file.txt' に移動します(subdirディレクトリが存在する場合)。各操作の成功または失敗を確認し、最終的なファイルの状態を表示します。

rename()に関するよくある質問

Q. ディレクトリの名前変更も可能?
A. はい、rename()関数はディレクトリの名前変更にも使用できます。ファイルと同じように、古い名前と新しい名前を指定するだけです。
Q. 異なるディレクトリへの移動は?
A. rename()関数を使って、ファイルを異なるディレクトリに移動することも可能です。新しい名前として、移動先のパスを含めた完全なファイル名を指定します。
Q. rename()の失敗の主な原因は?
A. rename()が失敗する主な原因には、権限不足、ディスク容量不足、元のファイルが存在しない、新しい名前のファイルがすでに存在する、などがあります。エラーの詳細はerror_get()関数で確認できます。

rename()が学べる書籍の紹介

「プログラミング単語帳」を使って、プログラミングの単語を英単語のように学習してみませんか?
プログラミング単語帳には、PHPのrename()やfopen()、fclose()、file_put_contents()、などのような実務でよく使われる単語が数百以上収録されています。
この書籍には、プログラミングの単語の意味や読み方、単語の使い方がわかる例文などが掲載されており、いつでもどこでもプログラミングの学習ができます。

よく使われる単語にだけ絞って学習することができるので、効率的にプログラミングが学習できます。

1日5分の暗記でプログラミンが身に付く!プログラミング単語帳 公式ストアで発売中!

HTML編、CSS編、JavaScript編、PHP編、Ruby編、その他単語編の6シリーズ分が公式ストアにて販売中です。気になった方はぜひ購入してみてください。


PHPを学べる「プログラミング単語帳」アプリ

プログラミング単語帳がアプリになりました!PHPはもちろん、10種類のプログラミング言語の中から、よく使われる単語をスマホで学習できます。

収録単語は2,000単語以上!
現在は、HTML、CSS、JavaScirpt、PHP、Laravel、Ruby、Python、MySQL、Linux、など10カテゴリーの単語帳が1つのアプリに収録されています。

いつでも、どこでも、隙間時間を有効活用して、プログラミングを効率的に学べるので、ぜひダウンロードしてみてください。

2024年7月アップデート情報:「Laravel」カテゴリーが追加されましました!

2024年8月アップデート情報:「MySQL」「Linux」カテゴリーが追加されましました!


関連するそのほかの単語

fopen()

ファイルを開く関数

種類: ファイル読み書き

fclose()

ファイルを閉じる関数

種類: ファイル読み書き

file_put_contents()

ファイルにデータを書き込む

種類: ファイル読み書き

三項演算子

条件に基づいて値を選択

種類: 条件分岐

SOAP

XMLベースのメッセージング規約

種類: Webサービス