この記事にはプロモーションが含まれています。

【誰でも簡単！】テキストファイルにデータを出力する方法【PHP】

2024-08-072024-08-19

ケケンタ

こんにちは！　ケケンタです。

今回は

PHPでテキストファイルにデータを出力する方法

をご紹介します。

初めてテキストファイルへデータを出力してみようと考えた方の中には、もしかすると「難しそう」と想像している方もいらっしゃるかもしれません。

しかし実際にふたを開けてみると

テキストファイルへデータを出力するために必要なソースコード量は非常に少なく、とても簡単に実装できることがお分かりいただけるかと思います。

————

WordPressのスキルを伸ばしたい方におすすめの書籍

脱！WordPress初心者のための一冊

HTMLサイトをWordPressにする本 [ 久保田涼子 ]

created by Rinker

WordPressカスタマイズの基礎

WordPressユーザーのためのPHP入門　はじめから、ていねいに。　第4版 [ 水野史土 ]

created by Rinker

体系的に基本スキルを習得！

ビジネスサイトを作って学ぶ WordPressの教科書 Ver.6.x対応版 [ 小川欣一 ]

created by Rinker

上級者を目指すための一冊

サイトの拡張性を飛躍的に高める WordPressプラグイン開発のバイブル[ 宮内隆行 ]

created by Rinker

Web技術への理解を深め、Webアプリ開発者を目指したい方へ

「プロになるためのWeb技術入門」 ――なぜ、あなたはWebシステムを開発できないのか／小森裕介 (著)

by Amazon

プロになるためのWeb技術入門なぜ，あなたはWebシステムを開発できないのか [ 小森裕介 ]

created by Rinker

【ソースコード】テキストファイルにデータを出力する

基本的なソースコードは以下の通りです。

// 作成するファイル（パス）を指定
$filename = './filestream.txt';

// テキストファイルに出力
$content = "出力したい文字列など";
file_put_contents( $filename, $content);

変数$filenameには、ファイル名……というよりも、「どこになんという名前のファイルを作成するか（＝パス）」を指定します。
※上記のコードでは実行ファイルと同じディレクトリに「filestream.txt」が作成されます。

実際にテキストファイルへ出力する関数はfile_put_contents()

file_put_contents()関数の特徴

ファイルが存在しなければ「新規作成」する
ファイルが存在すれば「上書き」する　※モード指定により「追記」も可能（後述します）

ちなみに、他の記事などでfopen()、fwrite()、fclose()を使用する方法もご紹介されていますが、

file_put_contents()を用いる方法は、上記３つの関数を使用するのと同じ意味になります。
（詳しくは公式ドキュメントをご参照ください）

具体的な使用方法

ファイルを「新規作成」または「上書き」する

// 作成するファイル（パス）を指定
$filename = './filestream.txt';

// テキストファイルに出力
$content = "出力したい文字列";
file_put_contents( $filename, $content);

先ほどお見せしたソースコードとまったく同じです。
「出力したい文字列」を任意のデータに置きかえるだけで、このソースコードをそのままお使いいただけます。

ファイルへ「追記」する

// 作成するファイル（パス）を指定
$filename = './filestream.txt';

// テキストファイルに出力
$content = "出力したい文字列" . "\n";
file_put_contents( $filename, $content, FILE_APPEND );

ハイライト行に注目

ファイルへ追記したいときはfile_put_contents()の第３引数に「FILE_APPEND」を指定します。
こうすることで、すでに存在するファイルへ「追記」してくれます。
「追記」する場合は、データの末尾に改行コード（\n）を記述します。
これにより、テキストファイルに追加されたデータが１行にまとまってしまうのを防げます。