TechAcademy（テックアカデミー） プログラミング Python Pythonにおけるopen関数のwbの利用方法を現役エンジニアが解説【初心者向け】
オーダーメイドコース
icon
icon
Python

Pythonにおけるopen関数のwbの利用方法を現役エンジニアが解説【初心者向け】

初心者向けにPythonにおけるopen関数のwbの利用方法について現役エンジニアが解説しています。open関数はPythonの関数の一つでファイルを開き、操作することが出来ます。新規作成や読み込み用、書き込み用などでファイルを開くことが出来ます。

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

Pythonにおけるopen関数のwbの利用方法について解説します。

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

 

なお本記事は、TechAcademyのオンラインブートキャンプPython講座の内容をもとに紹介しています。

 

田島悠介

今回は、Pythonに関する内容だね！

大石ゆかり

どういう内容でしょうか？

田島悠介

Pythonにおけるopen関数のwbの利用方法について詳しく説明していくね！

大石ゆかり

お願いします！

 
この記事ではPythonでopen関数を使ってのファイル操作の方法について解説しています。
 

open関数とは？

open関数はPythonの関数の1つで、ファイルの新規作成や保存、書き込みなどファイル操作ができます。
 

open関数で用いられる基本的なオプション

open関数は以下のような形式で使えます。
 

open(ファイル名, オプション, 文字エンコード)

 
文字エンコードとはファイルに書き込む際にコンピュータ上で文字や記号を扱う際に割り振られている番号のことでUTF-8やShift-JISなどがあります。

オプションはファイルをどのように開くのか、どのように書き込むのかなどを指定します。

代表的なオプションには以下のものがあります。

  1. ‘w’ : 書き込み用で開きます。ファイル名に設定したものがすでに存在している場合はそのファイルに上書きします。
  2. ‘r’ : 読み込み用で開きます。
  3. ‘x’ : 新規ファイルの書き込みとして使います。既存に存在している場合はエラーとなる。
  4. ‘a’ : 書き込み用で開きます。既存に存在している場合は末行に追加していく。
  5. ‘b’ : バイナリモードで開きます。

 

[PR] 未経験からWebエンジニアを目指す方法とは

open関数のオプションを利用してファイル操作してみよう

open関数を使ってファイル操作をしてみましょう。
 

プログラムソースコード1

w = open('test.txt', 'w', encoding='utf-8')
w.write('1:テストですn')
w.close()

 

実行結果1

test.txtファイルが作成され、「1:テストです」と書き込まれている。
 

プログラムソースコード2

w = open('test.txt', 'w', encoding='utf-8')
w.write('2:テストですn')
w.close()

 

実行結果2

先ほど作成されたtest.txtが上書きされ、「2:テストです」のみ書かれている。
 

プログラムソースコード3

w = open('test.txt', 'a', encoding='utf-8')
w.write('3:テストですn')
w.close()

 

実行結果3

test.txtの末行に「3:テストです」が追加されている。
 

プログラムソースコード4

r = open('test.txt', 'r', encoding='utf-8')
print(r.read())
r.close()

 

実行結果4

以下のようなtest.txtに書かれている内容が表示される。

2:テストです
3:テストです

以上、Pythonのopen関数を使ってファイル操作をする方法について解説しました。
 

監修してくれたメンター

メンターSさん

システムエンジニアとしてこれまで行政システムや医療用システムの保守、開発に携わりました。

JavaやPython、PHP、Kotlinなど様々な言語での開発経験があります。
TechAcademyではJavaコース、Pythonコース、AIコースなど7コースを担当しています。

 

大石ゆかり

内容分かりやすくて良かったです！

田島悠介

ゆかりちゃんも分からないことがあったら質問してね！

大石ゆかり

分かりました。ありがとうございます！

 

TechAcademyでは、初心者でもPythonを使った人工知能（AI）や機械学習の基礎を習得できるオンラインブートキャンプPython講座を開催しています。

挫折しない学習方法を知れる説明動画や、現役エンジニアとのビデオ通話とチャットサポート、学習用カリキュラムを体験できる無料体験も実施しているので、ぜひ参加してみてください。

記事を検索

関連するキーワード

関連する記事

Pythonのif文でand,or演算子を使って複数条件を指定する方法を現役エンジニアが解説【初心者向け】

Pythonのif文でand,or演算子を使って複数条件を指定する方法について、テックアカデミーのメンター（現役エンジニア）が実際のコードを使用して初心者向け...
Python

Pythonのstrptime()関数の使い方を現役エンジニアが解説【初心者向け】

Pythonのstrptime()関数の使い方について、TechAcademyのメンター（現役エンジニア）が実際のコードを使用して、初心者向けに解説します。 ...
Python

pandasで株価のデータを取得する方法【初心者向け】

pandasで株価のデータを取得する方法について解説します。 そもそもPythonについてよく分からないという方は、Pythonとは何なのか解説した記事を...
Python

徹底比較！Pythonで人気のフレームワークまとめ

Pythonは、YouTubeなどで使われている言語で機械学習などを得意とする特徴を持っています。実際にWebサービスを開発しようと思ったらフレームワークを利用...
Python

PythonのDEAPフレームワークを並列処理で動作させる方法を現役エンジニアが解説【初心者向け】

PythonのDEAPフレームワークを並列処理で動作させる方法について、TechAcademyのメンター（現役エンジニア）が実際のコードを使用して、初心者向けに...
Python

Pythonにおけるwritelines()の利用方法を現役エンジニアが解説【初心者向け】

Pythonにおけるwritelines()の利用方法について、TechAcademyのメンター（現役エンジニア）が実際のコードを使用して、初心者向けに解説しま...
Python

あわせてよく読まれている記事

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

文字をファイルに保存するにはテキストエディタを使いますが、この記事ではPHPのプログラムからファイルへ書き込む方法を扱います。 この記事では関数1つでファイルへの書き込みができるfile_put_contents関数と、ファイルの書き込み処理を3つに分けたfopen・fwrite・fclose関数について、テックアカデミーのメンター（現役エンジニア）が実際のコードを使用して初心者向けに解説します。 PHPのデータはデータベースだけでなく、テキストファイルに書き込むこともできるので、ぜひ書き方を覚えておきましょう。 目次open関数とは？open関数で用いられる基本的なオプションopen関数のオプションを利用してファイル操作してみよう監修してくれたメンター そもそも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関数】 ファイルを開く・書き込む・閉じる処理を分けて行うには、それぞれfopen・fwrite・fclose関数を使います。 1.ファイルを開く ファイルポインタ = fopen(ファイル名, モード); fopen関数で指定したファイル名を開きます。 モードは、開いたファイルをアクセスする形式を指定します。 主なモードには以下の種類があります。 モード 説明 “r” 読み込み専用で開きます。書き込みはできません。 “w” 書き込み専用で開きます。既存ファイルの中身は消去されます。 “r+” 読み書き両用で開きます。ファイルの先頭から処理されます。 “a” 追記用で開きます。ファイルの最後から書き込まれます。 戻り値のファイルポインタとは、ファイルを処理するときの管理用のもので開いたファイルを特定し、次に読み書きされるファイル内の位置を記憶しています。 ※ファイルポインタの位置を設定するには、ファイルを開いたときのモードで指定する（たとえば”w”なら最初、”a”なら最後など）か、任意の位置に移動させるfseek関数などを使って行います。 ※ファイルを読み書きするとファイルポインタの位置が移動します。   2.ファイルへ書き込む 書き込んだバイト数 = fwrite(ファイルポインタ, 書き込む内容); すでに開かれているファイルと処理する位置をファイルポインタで指定し、書き込む内容を関数に渡します。 戻り値は書き込みが成功した場合は書き込まれたバイト数、失敗した場合はfalseを返します。   3.ファイルを閉じる fclose(ファイルポインタ); ファイルの処理が終了したら、fclose関数に処理が終わったファイルポインタを渡してファイルを閉じます。   [PR] 未経験からWebエンジニアを目指す方法とは実際に書いてみよう 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) "書き込み"   おわりに ファイルの書き込みを実行できるようになると、プログラムを終了してもデータを保持できます。 基本的ですが、とても重宝する機能なのでしっかりとマスターしましょう。   大石ゆかり file_put_contents関数は、1行でファイルに書き込めていますね。 田島悠介 fwriteだと、ファイルを開くモードを指定してファイルを開き、ファイルハンドルを取得してから書き込まなければならないんだよ。 大石ゆかり ちょっと面倒ですね。 田島悠介 そうだね。ファイルに書き込むのは簡単だけど、PHPの場合、Webで複数人で使用する場合が多いよね。そうなるとファイルロックが必要になるんだよ。そこで違ってきたりするんだよね。   PHPを学習中の方へ これで解説は終了です、お疲れさまでした。 つまずかず「効率的に」学びたい 副業や転職後の「現場で使える」知識やスキルを身につけたい プログラミングを学習していて、このように思ったことはありませんか？ テックアカデミーのPHP/Laravelコースでは、第一線で活躍する「プロのエンジニア」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。 合格率10%の選考を通過した、選ばれたエンジニアの手厚いサポートを受けながら、PHP/Laravelを使ったWebアプリケーション開発を学べます。 まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役エンジニアから教わること」を実感してみてください。 時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします！
PHP

Pythonでのファイル読み込みの方法を現役エンジニアが解説【初心者向け】

Pythonでのファイル読み込みの方法について、TechAcademyのメンター（現役エンジニア）が実際のコードを使用して、初心者向けに解説します。   Pythonについてそもそもよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まるでしょう。   なお本記事は、TechAcademyのオンラインブートキャンプ、Python講座の内容をもとに紹介しています。   田島悠介 今回は、Pythonに関する内容だね！ 大石ゆかり どういう内容でしょうか？ 田島悠介 Pythonでのファイル読み込みの方法について詳しく説明していくね！ 大石ゆかり お願いします！   open関数でファイルを開く方法 Pythonでファイルを開く場合、 open関数を使用しましょう。 open関数は、Pythonの組み込み関数の1つでファイルの操作に利用し、新規ファイルの作成や書き込み、読み込み、追記、保存等の作業を行うことが可能です。 open関数は、下記の記述で使用することができます。 open('開きたいファイル名')   read関数とは read関数とは、ファイルを全て読み込み、その文字列データに対して処理を行う関数です。 read関数は下記の記述で使用することが可能です。 f = open('開きたいファイル名') data = f.read() コード1行目では、open関数を使用し、変数”f”に開いたファイルの情報を渡しました。 コード2行目においては、read関数を使用し、先ほど開いたファイルの終端まで全て読んだデータを変数”data”に返している状態です。   [PR] 未経験からWebエンジニアを目指す方法とはreadline関数とは readline関数とは、ファイルを1行毎に読み込み、その処理を繰り返します。 対して、read関数はファイルを全て読み込み、その文字列データに対して処理を行います。 readline関数を使用する場合は、以下のように記述しましょう。 f = open('開きたいファイル名') line= f.readline() コード1行目では、open関数を使用し、変数”f”に開いたファイルの情報を渡しました。 コード2行目においては、readline関数を使用し、先ほど開いたファイルの1行を文字列として読み込んだ結果を変数”line”に返しています。   readlines関数でファイルの内容を取得する方法 readline関数がファイルを1行毎に読み込み、その処理を繰り返すものです。 対して、readlines関数はファイルを全て読み込み、1行毎に処理を行う関数です。 readlines関数は以下の記述で使用することが可能です。 f = open('開きたいファイル名') lines= f.readlines() コード1行目では、先ほどと同様にopen関数を使用し、変数”f”に開いたファイルの情報を渡している状態です。 コード2行目においては、readlines関数を使用し、先ほど開いたファイルを1行毎にファイル終端まで全て読み込んだ結果を変数”lines”に返しています。   実際に書いてみよう open関数/read関数/readline関数/readlines関数について、下記test.txtとサンプルコードを例に学習していきましょう。 [test.txt] これはサンプルテキストです。 2行目には名前が入ります。 3行目には年齢が入ります。 open関数/read関数 サンプルコードは以下です。 f = open('test.txt') data = f.read() print(data) 実行結果 これはサンプルテキストです。 2行目には名前が入ります。 3行目には年齢が入ります。 実行結果では、読み込んだファイルの全てのデータが文字列データとして出力されていることが確認可能です。   open関数/readline関数 サンプルコードは以下です。 f = open('test.txt') line = f.readline() while line: print(line) line = f.readline() 実行結果 これはサンプルテキストです。 2行目には名前が入ります。 3行目には年齢が入ります。 実行結果では、読み込んだファイルのデータが1行ずつ文字列データとして出力されていることが確認できるでしょう。   open関数/readlines関数 サンプルコードは以下です。 f = open('test.txt') lines = f.readlines() for line in lines: print(line) 実行結果 これはサンプルテキストです。 2行目には名前が入ります。 3行目には年齢が入ります。 実行結果では、読み込んだファイルのデータを行毎に全て読み込み、順番に出力されていることを確認可能です。   まとめ 今回は、Pythonでのファイル読み込み方法について紹介していきました。 紹介した手法は、Pythonでのデータ処理やアプリケーション開発時などにおけるデータのインプット部分などで重要となる手法です。 サンプルコードを例にうまく活用し、実践的な開発を行なってみましょう。   執筆してくれたメンター 菅繕久（すがよしひこ） 現在はフリーランスのエンジニアをしていてプログラミング歴は8年目になります。 普段は Python、FileMaker等を使って様々な業務で活用できるIoTプロダクトRPAツールを作成しています。 開発実績としては、業務自動化ツール(在庫管理・発注・ファイル操作 etc)、電子カルテシステム、ロボット用プログラムなどがあります。 TechAcademyではPythonコースを担当しております。   大石ゆかり Pythonでのファイル読み込みの方法がよく分かったので良かったです！ 田島悠介 ゆかりちゃん、これからも分からないことがあったら質問してね！ 大石ゆかり 分かりました。ありがとうございます！   TechAcademyでは、初心者でも、Pythonを使った人工知能（AI）や機械学習の基礎を習得できる、オンラインブートキャンプを開催しています。 また、現役エンジニアから学べる無料体験も実施しているので、参加してみてください。
Python

Pythonでファイルの「読み込み」と「書き込み」をする方法を現役エンジニアが解説【初心者向け】

Pythonでファイルの「読み込み」と「書き込み」をする方法について解説します。 そもそもPythonについてよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。   なお本記事は、TechAcademyのオンラインブートキャンプPython講座の内容をもとに紹介しています。   田島悠介 今回は、Pythonに関する内容だね！ 大石ゆかり どういう内容でしょうか？ 田島悠介 Pythonでファイルの「読み込み」と「書き込み」をする方法について詳しく説明していくね！ 大石ゆかり お願いします！   読み込みをする基本的な関数 Pythonでファイルの読み書きをするには、open()でファイルオブジェクトを取得する必要があります。open()は、第一引数にファイルのパス、第二引数(もしくは mode)にファイルへのアクセス種別(モード)を指定します。 modeは何も指定しない場合、mode=”r”(読み込み専用)となっているため、読み込みだけの場合はファイルパスだけ指定すれば、ファイルオブジェクトを取得できます。 ファイルオブジェクトを取得したら、read(), readlines(), readline()で中身の読み込みが可能です。 read() read()は、ファイルの中身を全て一括で読み込むメソッドになります。内容を文字列形式で取得できます。 readlines() readlines()は、ファイルの中身を全て一括で読み込むメソッドになります。 read()との違いは、read()が文字列形式で内容を取得するのに対し、readlines()は1行ごとのリスト形式で内容を取得します。 readline() readline()は、ファイルの中身を1行ずつ読み込むメソッドになります。1回目の実行で1行目、2回目の実行で2行目、というように先頭から順番に読み込むことが可能です。 書き込みをする基本的な関数 ファイルの書き込みをする場合には、mode=”w”や mode=”a”などの書き込みが可能なモードでファイルオブジェクトを取得します。 mode=”w”は新規作成、もしくは上書きモード、mode=”a”は追記モードになります。ファイルオブジェクトを取得したら、write(), writelines()でファイルの書き込みが可能です。 write() write()は、文字列を書き込むメソッドになります。数値などを書き込みたい場合は、str()で一度文字列に変換する必要があります。 writelines() writelines()は、文字列のリストをまとめて書き込むメソッドになります。write()と同じように、数値などを書き込みたい場合はstr()で文字列に変換しておく必要があります。 [PR] 未経験からWebエンジニアを目指す方法とは実際に書いてみよう ファイルの読み込み 事前に以下の内容のファイルをsample.txtという名前で作成しておきます。 line1 line2 line3   read() まずはread()による一括読み込みを試してみましょう。文字列として内容を取得できているのが分かりますね。 f = open("sample.txt") contents = f.read() print(type(contents)) # => <class 'str'> print(contents) # => line1 # line2 # line3 f.close()   readlines() 次はreadlines()を試してみましょう。文字列のリストとして内容を取得できているのが分かりますね。 f = open("sample.txt") contents = f.readlines() print(type(contents)) # => <class 'list'> print(len(contents)) # => 3 print(contents[0]) # => line1 print(contents[1]) # => line2 print(contents[2]) # => line3 f.close()   readline() 最後に readline()を試してみましょう。1行単位で文字列を取得できているのが分かりますね。 f = open("sample.txt") contents = f.readline() print(type(contents)) # => <class 'str'> print(contents) # => line1 contents = f.readline() print(contents) # => line2 contents = f.readline() print(contents) # => line3 f.close()   ファイルの書き込み write() まずは write()による書き込みを試してみましょう。前の内容を残したいので、追記モード(mode=”a”)でファイルオブジェクトを取得します。 # 追記モードでファイルオブジェクトを取得 f = open("sample.txt",
Python

PythonでCSVファイルを作成する方法を現役エンジニアが解説【初心者向け】

PythonでCSVファイルを作成する方法について、テックアカデミーのメンター（現役エンジニア）が実際のコードを使用して初心者向けに解説します。 CSVファイルとは、Comma Separated Valueの略です。 Comma Separated Valueというのは、カンマで（Comma）区切った（Separated）値（Value）という意味です。 例えば、Excelのデータも、カンマで区切ったデータです。 そのため、CSVファイルはExcelで利用できます。 つまり、ExcelのデータはCSVファイルとして利用することが可能だということです。 注意点としては、Excelファイルにあるデータすべてを、1つのCSVファイルとして利用できないことです。 Excelファイルの1シートずつをCSVファイルに変換します。 CSVファイルは、Excelだけでなく、ACCESSやMySQLなどのデータベースアプリケーション、そしてメモ帳でも使用できます。 PythonでCSVファイルを作成できるということは、様々なアプリケーションで利用可能なCSVファイルを自動処理することができるようになるということです。 この記事を機に、現在の実務でもPythonを活用できるように学習していきましょう。 目次open関数とは？open関数で用いられる基本的なオプションopen関数のオプションを利用してファイル操作してみよう監修してくれたメンター そもそもPythonについてよく分からないという方は、Pythonとは何なのか解説した記事を読むとさらに理解が深まります。   田島悠介 今回は、Pythonに関する内容だね！ 大石ゆかり どういう内容でしょうか？ 田島悠介 PythonでCSVファイルを作成する方法について詳しく説明していくね！ 大石ゆかり お願いします！   CSVファイルの特徴と作成時の注意点 CSVファイルとは、Comma Separated Valueの略称を指し、データを「, 」（カンマ）で区切ってデータを保存するファイル形式のことです。 下記は、実際の具体的なCSVファイルのデータです。 青森,apple,120 山形,cherry,50 栃木,strawberry,90 岡山,peach,350 愛媛,orange,100 沖縄,pineapple,200 CSVファイルのデータは、「何県のどの果物が1個あたり何円で売られているのか」といった情報をまとめたものです。 CSVファイルを使えば、簡単に情報を管理できます。   CSVモジュールの使い方 PythonでCSVファイルを扱うには、最初にCSVモジュールをimportする必要があります。 Importのやり方は非常に簡単で、以下のように実施します。 import csv   次に、CSVファイルの読み込み方について見ていきましょう。 既存のファイル名を指定し、読み込み用のオープンモードでopenします。 CSVファイルの読み込みにはreader()というメソッドを使用し、リーダーというインスタンスを生成することが可能です。 リーダーに対してfor文を使うと、読み込んだCSVファイルの各行を取得できます。 また、さらにfor文を使った場合、1行内の各列の要素についても取得できます。   以下が実際にCSVファイルを読み込む際のコード例です。 コード import csv file = open('fruits.csv', 'r') data = csv.reader(file) for row in data: for col in row: print(col, end=',') print() file.close()   解説 1行目のimport csvでは、CSVファイルを利用するためのライブラリをインポートしています。 2行目のfile = open(‘fruits.csv’, ‘r’)では、fruits.csvという名前のCSVファイルをrという指定で読み込むためにopenメソッドで開いています。 その後、開いた内容をfileオブジェクトに代入しています。 fileには次のようなデータが入っています。 青森,apple,120 山形,cherry,50 栃木,strawberry,90 岡山,peach,350 愛媛,orange,100 沖縄,pineapple,200 3行目のdata = csv.reader(file)では、2行目で用意したfileオブジェクトの内容を、csv.reader()というメソッドを利用して反復処理してdataオブジェクトに代入しています。 dataオブジェクトには次のような配列データが入っています。 ['青森', 'apple', '120'] ['山形', 'cherry', '50'] ['栃木',
Python

簡単に変換できる！PHPでCSVファイルを読み込む方法【初心者向け】現役エンジニアが解説

PHPでCSVファイルを読み込む方法について、テックアカデミーのメンター（現役エンジニア）が実際のコードを使用して初心者向けに解説します。 fgetcsv関数を使ってCSVファイルを読み込めば、表計算ソフトなどからPHPにデータを取り込めます。 たとえば、Excelで作った商品リストをCSVファイルで保存し、PHPで取り込めばショッピングサイトのデータとして活用できますし、Googleスプレッドシートで作成したタスクリストをCSVにしてPHPで読み込めばタスクの共有ができるアプリケーションが作成できます。 このように、他のアプリで作ったCSVファイルのデータ活用するために覚えておきたい知識なので、参考にしてみてください。   目次open関数とは？open関数で用いられる基本的なオプションopen関数のオプションを利用してファイル操作してみよう監修してくれたメンター   そもそもPHPについてよく分からないという方は、PHPとは何なのか解説した記事を読むとさらに理解が深まります。   田島悠介 今回はCSVファイルをPHPで読み込む方法をやっていくよ。 大石ゆかり 田島メンター！その前にちょっといいですか？ 「CSV」って何ですか？ 田島悠介 じゃあ、CSVとは何かを教えるね。 ゆかりちゃんは表計算ソフト、例えば「Excel」とか「Google スプレッドシート」は使ったことあるかな？ 大石ゆかり それならありますよ。大学時代にレポート作成でExcelを使ってましたし、仕事ではGoogle スプレッドシートを使っています。 田島悠介 もし、ゆかりちゃんが入力したデータをPHPのプログラムで読み込ませたいと思ったらどうしたらいいかな？ 大石ゆかり データを保存したファイルをPHPで読み込めばいいんじゃないですか？ PHPってファイルの読み込みもできましたよね？ 田島悠介 たしかに、PHPではファイルの読み込みができるんだけど、ExcelやGoogle スプレッドシートの専用ファイルはそのままでは読み込むのが難しいんだ。 PHPのファイル読み込みは、標準では文字だけで構成されたテキストファイルで作成されていることが前提だからね。 大石ゆかり そうなんですね・・・。じゃあ、表計算ソフトで保存するときPHPでも読み込めるテキストファイルの形式で保存したらいいんですか？ 田島悠介 その通り！さすがゆかりちゃん、理解が早い。 そのPHPにも対応しているテキストファイルの形式の1つがCSVファイルというわけだね。 大石ゆかり なるほどぉ。 今Google スプレッドシートでCSVの形式にエクスポートしてみました。 カンマ付きのシンプルな文字だけになるんですね。   Googleスプレッドシートの画面   名前,年齢,血液型 太郎,21,O ジョン,23,A ニキータ,32,AB 次郎,22,B CSVファイルの中身 田島悠介 そうだね。CSVファイルはカンマかタブ文字で区切られるんだ。 ちなみにCSVファイルはほとんどのアプリが対応しているから、PHPなどのプログラムからの読み込みだけでなく、アプリ同士でデータをやり取りしたいときにもよく使われるよ。 ただ、データの中身の文字だけしか保存されないから、罫線や文字色などの情報はなくなるけどね。 大石ゆかり CSVについてはよく分かりました！ 今回はそのCSVファイルをPHPで読み込む方法を教えてもらえるんですね！ 田島悠介 そういうことだね。 CSVは、読み込みと出力のそれぞれ書き方が違うから、今回は「読み込み」の方法について説明するね！ 大石ゆかり お願いしまーす！！   CSVファイルを読み込む関数「fgetcsv」 PHPでは、CSVファイルを読み込んで配列の形にしてくれる「fgetcsv関数」という関数があります。 fgetcsv関数を使うためには、まず対象のCSVファイルを開いておく必要があります。   ファイルを開く「fopen」 CSVファイルを開くには、fopen関数を使います。 $file_handler = fopen("読み込むCSVファイルのパス", "r"); fopen関数の戻り値で、読み込んだファイルを管理している名前（ファイルハンドル）を取得します。 fopen関数の2つ目のパラメータはファイルにアクセスする形式、つまり開いたファイルの書き込みを可能にするかどうかなどのファイルをアクセスする状態を設定します。 “r“は読み取り専用、つまり書き込みしない状態でファイルを開きます。 ※もし、対象ファイルが存在しなかったりファイルのアクセス権がない場合には、fopenは失敗しwarningを発行してFALSEを戻り値として返します。   CSVファイルを1行ずつ配列で読み込む「fgetcsv」 ファイルハンドルが取得できたら、fgetcsv関数でCSVファイルを1行ずつ読み込みます。 $data = fgetcsv($file_handler);   読み込まれた1行分のデータを項目（データ列）ごとに配列として戻り値で取得します。 たとえば下記のようなCSVファイルなら、1回目にfgetcsv関数を呼び出したときは、1行目のデータである「名前」「年齢」「血液型」の文字列が配列に代入されます。 名前,年齢,血液型 太郎,21,O ・ ・ ・   実際に書いてみよう では実際にプログラムを書いてみましょう。 事前に、以下のように書いた「test.csv」ファイルを作成しておきます。 名前,年齢,血液型 太郎,21,O ジョン,23,A ニキータ,32,AB 次郎,22,B   それでは、プログラムを書いてみましょう。 <?php // 読み取り専用でtest.csvを開きます。 $f = fopen("./test.csv", "r"); // test.csvの行を1行ずつ読み込みます。 while($data = fgetcsv($f)){ // 読み込んだ結果を表示します。 var_dump($data); } // test.csvを閉じます。 fclose($f); ?> 簡単にソースコードの説明をします。 最初に読み取り専用でtest.csvファイルを開き、while文で1行ずつファイルを読み込みます。 読み込んだ結果の配列を、var_dump関数でCSVファイル1行分のデータを表示しています。   以下、実行結果です。 1行ずつ読み込まれて、配列の形になっているのがわかります。   まとめ CSVファイルを読み込むときは、まずfopen関数でファイルを開きます。 そして、fgetcsv関数を使って1行ずつ配列にデータを読み込みます。   タブ文字で区切られたファイル 大石ゆかり 田島メンター、教えてもらった方法でデータをPHPで読み込もうとしたんですがうまくいきません・・・ 田島悠介 それは、データの区切り文字が違うからだよ。 CSVはカンマ区切りだけど、別の種類でタブ区切りのファイル形式が使われることがあるんだ。 大石ゆかり そうなんですね。よく見るとファイルの拡張子が.tsvになっていました。 田島悠介 そうだね。タブ区切りのファイルはtxtやtsvといった拡張子が使われるね。 タブ区切りのファイルを読み取るにはさっきと同じfgetcsv関数が使えるけど、パラメータを指定する必要があるよ。 大石ゆかり タブ区切りのファイルでも読み込めるんですね。 PHPで読み込む方法を教えてください！ fgetcsv関数でタブ区切りのファイルを読み込む fgetcsv関数でタブ区切りのファイルを読み込むには、3つ目のパラメータseparatorで区切り文字を指定します。 $data = fgetcsv($f, 0, "t") 今回はタブ区切りのファイルを読み込みたいので、区切りとしてタブ文字「t」を指定します。 ※2つ目のパラメータはlengthで、分割しない1行の最大文字数（改行文字なども含む）を指定します。0を指定するか省略すると、最大行長は制限されません。 (PHP 5.1.0以降)   まとめ タブ区切りのファイルをfgetcsv関数で読み込むときは、3つ目のパラメータでタブ文字 “t” を指定します。   [PR] 未経験からWebエンジニアを目指す方法とは空行がある場合 大石ゆかり CSVファイルを読み込んだら、値が空の配列が混じっていました。 田島悠介 それは読み込んだCSVに空の行が入っていたからなんだ。 1行ずつ繰り返すループの中で、空行かどうか判定する式を追加するだけで解決できるよ。 CSVファイルの読み込み時に空行の判定をする CSVファイルに空の行が含まれている場合、PHPの条件式で判定を行うコードを追加すれば、余分な空っぽの値が配列に入るのを防げます。 配列の1行分の要素すべてが空かどうか、配列の要素を文字列としてつなげて判定します。 1行分の配列の要素を文字列として結合するのに、implode関数を使います。   空行判定のコード例 配列に値があるかどうかで空行の判定をしています。 <?php // 読み取り専用でtest.csvを開きます。 $f = fopen("test.csv", "r"); // test.csvの行を1行ずつ読み込みます。 while($data = fgetcsv($f)){ // 1行分の要素すべてを文字列として結合しても空ではない、つまり空行でなければ出力します。 if(implode($data) != null){
PHP

fputcsv関数を覚える！PHPでCSVファイルを出力する方法【初心者向け】

PHPでCSVファイルを出力する方法について、テックアカデミーのメンター（現役エンジニア）が実際のコードを使用して初心者向けに解説します。 CSVファイルに配列を書き込む際はfputcsv関数が便利です。 本記事では、実際にCSVファイルを出力する流れをソースコードを書いて説明しているので、ぜひ書きながら理解していきましょう。 目次open関数とは？open関数で用いられる基本的なオプションopen関数のオプションを利用してファイル操作してみよう監修してくれたメンター そもそもPHPについてよく分からないという方は、PHPとは何なのか解説した記事を読むとさらに理解が深まります。   大石ゆかり 田島メンター！前回、CSVファイルをPHPに読み込む方法を教えてもらったと思うんですけど、逆にCSVファイルにするにはどうしたらいいんですか〜？ 田島悠介 CSVファイルに出力するには、また別の関数を使うから詳しく見ていこうか！ 大石ゆかり がんばって覚えますね♪   CSVファイルを出力する関数 fputcsv関数 PHPで配列からCSVファイルに出力するのに便利な関数として、「fputcsv関数」があります。 「fputcsv関数」は配列に代入されている値を、指定したファイルにCSVのフォーマットで書き込みます。   fputcsv関数の引数 fputcsv関数の書式は以下の通りです。 fputscsv($stream, $fields, $separator, $enclosure, $escape)   第1引数の$streamはfopen関数の出力結果を指定します。 以下のようにfopen関数で書き込みをするファイルを取得してから、$streamに指定します。 $stream = fopen("出力するCSVファイルのパス", "w");   第2引数の$fieldsは書き込み対象の配列を指定します。 以下のような配列で構いません。 array("名前", "身長", "血液型");   第3引数の$separatorは区切り文字を指定します。 省略すると「,」が使用されます。   第4引数の$enclosureは囲み文字を指定します。 省略すると「”」が使用されます。 ただし、出力対象の文字列に半角スペースが含まれる場合のみ、囲み文字が付加されるような仕様になっています。   第5引数の$escapeは文字として認識させたい特殊な文字を指定します。 例えば「”」を出力対象としたい場合は「”」を指定します。 ※「実際に書いてみよう」では第3,4,5引数は省略しています。   fputcsv関数の返り値 出力対象のCSVファイルに書き込まれた文字列の長さを数値(int型)で返します。   実際に書いてみよう それでは実際に書いてみましょう。 以下の例では、配列にあらかじめ設定した文字列をtest.csvに書き込みます。 output_csv.php --------------------------------- // CSVファイルに書き込む配列を定義します。 $ary = array(   array("名前", "年齢", "血液型"),   array("太郎", "21", "O"),   array("ジョン", "23", "A"),   array("ニキータ", "32", "AB"),   array("次郎", "22", "B") ); // ファイルを書き込み用に開きます。 $f = fopen("test.csv", "w"); // 正常にファイルを開くことができていれば、書き込みます。 if ( $f ) {   // $ary から順番に配列を呼び出して書き込みます。   foreach($ary as $line){ // fputcsv関数でファイルに書き込みます。     fputcsv($f, $line);   }  } // ファイルを閉じます。 fclose($f); ---------------------------------   はじめに、CSVファイルに書き込むためのデータとなる配列$aryを定義します。 次に、書き込み用にtest.csvを開き（作成し）、正常にtest.csvを開くことができていれば、$aryから順番に配列を取り出してきてtest.csvに1行ずつ書き込んでいきます。 出力結果を開くと、次のように書き込まれています。 test.csv --------------------------------- 名前,年齢,血液型 太郎,21,O ジョン,23,A ニキータ,32,AB 次郎,22,B ---------------------------------   [PR] 未経験からWebエンジニアを目指す方法とはまとめ PHPでプログラムを作成していると、CSVファイルを出力する場面というのはしばしばあります。 その時にfputcsv関数を使うことで簡単にCSVファイルを作成できますので、ぜひ活用してください。   田島悠介 「f~~」って関数が多いけど、全部必要な手順だから書き忘れないようにね！ 大石ゆかり 「fopen」とかの「f」ってファイルって意味ですか？ 田島悠介 そうだね！他にもURLをオープンする時なんかにも使うから知っておくと良いかもね！ 大石ゆかり そうなんですね！ありがとうございます♪   PHPを学習中の方へ これで解説は終了です、お疲れさまでした。 つまずかず「効率的に」学びたい 副業や転職後の「現場で使える」知識やスキルを身につけたい プログラミングを学習していて、このように思ったことはありませんか？ テックアカデミーのPHP/Laravelコースでは、第一線で活躍する「プロのエンジニア」が教えているので、効率的に実践的なスキルを完全オンラインでしっかり習得できます。 合格率10%の選考を通過した、選ばれたエンジニアの手厚いサポートを受けながら、PHP/Laravelを使ったWebアプリケーション開発を学べます。 まずは一度、無料体験で学習の悩みや今後のキャリアについて話してみて、「現役エンジニアから教わること」を実感してみてください。 時間がない方、深く知ってから体験してみたい方は、今スグ見られる説明動画から先に視聴することをおすすめします！
PHP

あなたの目的に合わせて学べるコース

副業したい方

Web制作の力を身につけ
副業までサポート

はじめての副業コース

転職したい方

未経験から
Webエンジニアに

Webエンジニア転職保証コース

スキルアップしたい方

AIも統計解析もできる
Pythonを学ぶ

Pythonコース

※ 経済産業省の行うリスキリングを通じたキャリアアップ支援事業の補助金対象コースです。条件を満たすことで支払った受講料の最大70％がキャッシュバックされます。詳しくは こちら のページをご確認ください。

TechAcademyから
現役エンジニアの方へ
お知らせ

オーダーメイドコース
TechAcademy（テックアカデミー） プログラミング Python Pythonにおけるopen関数のwbの利用方法を現役エンジニアが解説【初心者向け】