PHPでファイルの書き込みを行う方法|file_puts_contents関数を理解する!【初心者向け】

プログラミング初心者向けにPHPでfile_puts_contens()を使ってファイルの書き込むを行う方法について解説しています。データベースだけでなく、テキストファイルにもデータを書き込むことができるので、ぜひ覚えておきましょう。

テックアカデミーマガジンは受講者数No.1のプログラミングスクール「テックアカデミー」が運営。初心者向けにプロが解説した記事を公開中。現役エンジニアの方はこちらをご覧ください。 ※ アンケートモニター提供元:GMOリサーチ株式会社 調査期間:2021年8月12日~8月16日  調査対象:2020年8月以降にプログラミングスクールを受講した18~80歳の男女1,000名  調査手法:インターネット調査

監修してくれたメンター

井上 祐介

NEC・Microsoftの認定インストラクター。Z80アセンブラ・C++・C#・PHP・Javaなどの経験を経て業務で使用するプログラムの開発や新入社員プログラミング研修の講師を行った。

文字をファイルに保存するにはテキストエディタを使いますが、この記事ではPHPのプログラムからファイルへ書き込む方法を扱います。

この記事では関数1つでファイルへの書き込みができるfile_put_contents関数と、ファイルの書き込み処理を3つに分けたfopen・fwrite・fclose関数について、テックアカデミーのメンター(現役エンジニア)が実際のコードを使用して初心者向けに解説します。

PHPのデータはデータベースだけでなく、テキストファイルに書き込むこともできるので、ぜひ書き方を覚えておきましょう。

目次

1時間でできる無料体験!

そもそもPHPについてよく分からないという方は、PHPとは何なのか解説した記事を読むとさらに理解が深まります。

 

file_puts_contents関数とは

本来、ファイルの書き込み操作をプログラムから行うには、ファイルを開く書き込む閉じるという一連の操作が必要です。

このファイルへの書き込みの3つの処理を一度にしてくれるのがfile_puts_contents関数です。

ファイル名の文字列と書き込みたい内容file_puts_contents関数に渡すだけで、必要な処理を行ってくれます。

file_puts_contents関数を使うと、存在しないファイル名を指定した場合は新規作成され、すでに存在するファイル名を指定した場合は上書き保存されます。

また同時に書き込むことがないよう、処理中にファイルをロックすることも可能です。

 

ファイル書き込みの書き方

自動でファイルの書き込み【file_put_contents関数】

通常のファイル操作で必要なファイルを開く・書き込み・閉じる処理をすべて自動で行ってくれます。

書き込んだバイト数 = file_put_contents(ファイル名, 書き込む内容);

書き込みたいファイル名と、ファイルに書き込む内容file_puts_contents関数に渡します。

戻り値は、書き込みが失敗した場合はfalse、成功した場合は書き込まれたバイト数を返します。

バイト(byte)とは256通りの情報を扱える単位で、ファイルへの書き込みの最小単位です。半角英数は1バイトで表現できますが、漢字やひらがなの全角文字は2から3バイトで表現されます。
※3つめのパラメータにFILE_APPENDフラグを指定してファイルの末尾から追記したり、LOCK_EXフラグで他のプログラムなどから同じファイルを開かれて同時に書き込まれないようにできます。

 

手動でファイルの書き込み【fopen・fwrite・fclose関数】

ファイルを開く書き込む閉じる処理を分けて行うには、それぞれfopenfwritefclose関数を使います。

1.ファイルを開く

ファイルポインタ = fopen(ファイル名, モード);

fopen関数で指定したファイル名を開きます。

モードは、開いたファイルをアクセスする形式を指定します。

主なモードには以下の種類があります。

モード 説明
“r” 読み込み専用で開きます。書き込みはできません。
“w” 書き込み専用で開きます。既存ファイルの中身は消去されます。
“r+” 読み書き両用で開きます。ファイルの先頭から処理されます。
“a” 追記用で開きます。ファイルの最後から書き込まれます。

戻り値のファイルポインタとは、ファイルを処理するときの管理用のもので開いたファイルを特定し、次に読み書きされるファイル内の位置を記憶しています。

※ファイルポインタの位置を設定するには、ファイルを開いたときのモードで指定する(たとえば”w”なら最初、”a”なら最後など)か、任意の位置に移動させるfseek関数などを使って行います。
※ファイルを読み書きするとファイルポインタの位置が移動します。

 

2.ファイルへ書き込む

書き込んだバイト数 = fwrite(ファイルポインタ, 書き込む内容);

すでに開かれているファイルと処理する位置をファイルポインタで指定し、書き込む内容を関数に渡します。

戻り値は書き込みが成功した場合は書き込まれたバイト数、失敗した場合はfalseを返します。

 

3.ファイルを閉じる

fclose(ファイルポインタ);

ファイルの処理が終了したら、fclose関数に処理が終わったファイルポインタを渡してファイルを閉じます。

 

[PR] PHPプログラミングで挫折しない学習方法を動画で公開中

実際に書いてみよう

file_put_contents

<?php
  define("TESTFILE","./TEST.txt");
  $s = "上書き";
  print_r("file_put_tcontents関数n");
  file_put_contents(TESTFILE,$s);
  var_dump(file_get_contents(TESTFILE));
?>

 

実行結果

$ php 01.php
file_put_tcontents関数
string(9) "上書き"

 

fwrite

<?php
  define("TESTFILE","./TEST.txt");
  $fh = fopen(TESTFILE, "w");

  echo "fwrite関数n";
  fwrite($fh,"書き込み");
  fclose($fh);

  var_dump(file_get_contents(TESTFILE));
?>

 

実行結果

$ php fwrite.php
fwrite関数
string(12) "書き込み"

 

コラム

実は私も!?独学で損する人の特徴

「スクールは高いから独学で成功する」という気持ちの方は多いと思います。
もちろんその方が金額は低く抑えられるでしょう。
ただ 独学には向き不向きがあり、実はスクールが向いている人も大勢います。

そんな方のために参考として、 テックアカデミー卒業生がスクールを選んだ理由 をご紹介します。

  • ・困って挫折しそうなときに、質問や相談できる相手がいる環境で学んでいきたいなと思った
  • ・わかった気になっているだけだったので、自分を追い込む環境に置いた方がいいと感じた
  • ・スクールのカリキュラムで市場に求められるスキルを学ぶべきと思った

少しでも当てはまる部分があれば、 スクールが向いているかもしれません。
お試しのつもりで、まずは一度 無料相談 に参加してみませんか?

現役エンジニア・デザイナーに何でも気軽に相談できる30分すべて無料で できます。
無理な勧誘は一切ない ので、お気軽にご参加ください。

今なら相談した方限定の割引・参加特典付き! 無料相談はこちら

おわりに

ファイルの書き込みを実行できるようになると、プログラムを終了してもデータを保持できます。

基本的ですが、とても重宝する機能なのでしっかりとマスターしましょう。

 

大石ゆかり

file_put_contents関数は、1行でファイルに書き込めていますね。

田島悠介

fwriteだと、ファイルを開くモードを指定してファイルを開き、ファイルハンドルを取得してから書き込まなければならないんだよ。

大石ゆかり

ちょっと面倒ですね。

田島悠介

そうだね。ファイルに書き込むのは簡単だけど、PHPの場合、Webで複数人で使用する場合が多いよね。そうなるとファイルロックが必要になるんだよ。そこで違ってきたりするんだよね。

 

PHPを学習中の方へ

これで解説は終了です、お疲れさまでした。

  • つまずかず「効率的に」学びたい
  • 副業や転職後の「現場で使える」知識やスキルを身につけたい

プログラミングを学習していて、このように思ったことはありませんか?

テックアカデミーのPHP/Laravelコースでは、第一線で活躍する「プロのエンジニア」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。

合格率10%の選考を通過した、選ばれたエンジニアの手厚いサポートを受けながら、PHP/Laravelを使ったWebアプリケーション開発を学べます。

まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役エンジニアから教わること」を実感してみてください。

時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします!

初心者・未経験でもできる。まずはテックアカデミーに相談しよう

プログラミングを独学していて、このように感じた経験はないでしょうか?

  • ・調べてもほしい情報が見つからない
  • ・独学のスキルが実際の業務で通用するのか不安
  • ・目標への学習プランがわからず、迷子になりそう

テックアカデミーでは、このような 学習に不安を抱えている方へ、現役エンジニア講師とマンツーマンで相談できる機会を無料で提供 しています。
30分間、オンラインでどんなことでも質問し放題です。

「受けてよかった」と感じていただけるよう 厳しい試験を通過した講師 があなたの相談に真摯に向き合います。

「ただ気になることを相談したい」
「漠然としているがプロの話を聞いてみたい」

こんな気持ちでも大丈夫です。

無理な勧誘は一切ありません ので、まずはお気軽にご参加ください。
※体験用のカリキュラムも無料で配布いたします。(1週間限定)

今なら参加者限定の割引特典付き! 無料相談を予約する