PHPには、ファイルへのデータ書き込み方法がいくつかあり、ニーズに合わせて柔軟に対応できます。この記事では、簡単な書き込みにはfile_put_contents()、より細かい制御にはfopen()、fwrite()、fclose()の2つの主要な方法について説明します。
目次
file_put_contents()の使用
file_put_contents()は、ファイルにデータ書き込みを行う最も簡単な方法です。ファイル名とデータを引数として受け取ります。既存のファイルは上書きされ、存在しない場合は新しいファイルが作成されます。
<?php
$data = "This is the text to be written.n";
$filename = "my_file.txt";
if (file_put_contents($filename, $data) !== false) {
echo "Data successfully written to $filename";
} else {
echo "Error writing to $filename";
}
?>
このスニペットは、$data文字列をmy_file.txtに書き込みます。if文は戻り値（成功時の書き込まれたバイト数、失敗時のfalse）をチェックします。
ファイルへの追記：上書きする代わりに追記するには、FILE_APPENDフラグを使用します。
<?php
$data = "This text will be appended.n";
$filename = "my_file.txt";
if (file_put_contents($filename, $data, FILE_APPEND) !== false) {
echo "Data successfully appended to $filename";
} else {
echo "Error appending to $filename";
}
?>
fopen()、fwrite()、fclose()の使用
より詳細な制御を行うには、fopen()、fwrite()、fclose()を使用します。fopen()はファイルをオープンし、fwrite()はデータを書込み、fclose()はファイルを閉じます。これは、大きなファイルや複数回の書き込み操作に役立ちます。
<?php
$filename = "my_file.txt";
$handle = fopen($filename, 'w'); // 'w'は書き込み用にオープンし、既存の内容を上書きします
if ($handle) {
$data = "This is the first line.n";
$data .= "This is the second line.n";
fwrite($handle, $data);
fclose($handle);
echo "Data successfully written to $filename";
} else {
echo "Error opening $filename";
}
?>
この例では、ファイルを書き込みモード（’w’）で開きます。既存の内容は消去されます。fwrite()はデータを書き込みます。fclose()は、データが書き込まれ、リソースが解放されることを保証するために重要です。
fopen()による追記：‘a’モードを使用すると追記できます。
<?php
$filename = "my_file.txt";
$handle = fopen($filename, 'a'); // 'a'は追記用にオープンします
if ($handle) {
$data = "This text will be appended.n";
fwrite($handle, $data);
fclose($handle);
echo "Data successfully appended to $filename";
} else {
echo "Error opening $filename";
}
?>
常にエラー（例：書き込み不可能なファイル、権限の問題）を処理します。関数の戻り値をチェックし、適切なエラー処理を実装してください。ニーズに基づいて、file_put_contents()とfopen()/fwrite()/fclose()を選択してください。file_put_contents()は簡単なタスクには簡潔です。fopen()/fwrite()/fclose()は複雑なシナリオでより大きな制御を提供します。