fopen/fclose関数の使い方(ファイルのオープンとクローズ)

PHP で用意されている組み込み関数の一つである fopen 関数および fclose 関数の使い方です。 fopen 関数は引数に指定したファイルを、指定したモードで開きます。また fclose 関数は引数に指定した handle が指しているファイルをクローズします。

(2022 年 09 月 28 日公開 / 2022 年 09 月 28 日更新)

fopen関数およびfclose関数の書式と基本的な使い方

fopen 関数は次のように定義されています。

resource fopen(string filename, string mode) 

引数に指定したファイルを、指定したモードで開きます。

引数：
  filename  対象のファイル名
  mode  開くモード(後述)
返り値：
  ファイルを表すハンドル

引数で指定したファイルを、指定したモードで開きます。指定可能なモードは下記の通りです。

モード読み書き区分動作
r読みファイルポインタをファイルの先頭に置きます。
r+読み/書きファイルポインタをファイルの先頭に置きます。
w書きファイルポインタをファイルの先頭に置き、ファイルサイズをゼロにします。ファイルが存在しない場合には、作成を試みます。
w+読み/書きファイルポインタをファイルの先頭に置き、ファイルサイズをゼロにします。ファイルが存在しない場合には、作成を試みます。
a書きファイルポインタをファイルの終端に置きます。ファイルが存在しない場合には、作成を試みます。
a+読み/書きファイルポインタをファイルの終端に置きます。ファイルが存在しない場合には、作成を試みます。
x書きファイルポインタをファイルの先頭に置きます。ファイルが既に存在する場合にはfopen()は失敗し、E_WARNINGレベルのエラーを発行します。ファイルが存在しない場合には新規作成を試みます。
x+読み/書きファイルポインタをファイルの先頭に置きます。ファイルが既に存在する場合にはfopen()は失敗し、E_WARNINGレベルのエラーを発行します。ファイルが存在しない場合には新規作成を試みます。

※Windowsの場合、バイナリモードで開く場合には「b」を追加する必要があります。例えばモードに「w」を指定したい場合で、バイナリモードで開く場合には「wb」となります。

ファイルを開く目的(読み込むためか、書き込むためか、両方か)と、挙動を考慮してモードを指定します。ファイルポインタとはファイルの中で読み込みや書き込みを行う位置を表します。ファイルポイントが先頭で読み込みを開始すればファイルの先頭から読み込みを行う事になりますし、先頭から書き込みを行うというのは既にファイルに何か書いてあっても既存の内容を破棄してファイルの先頭から書き込みを行うことを意味します。また、ファイルポイントが最後というのは既存の内容の最後に追加として書き込みを行うことを意味しています。

ファイルはPHPシステムと同じローカルシステム上にあり、開こうとしているファイルのパーミッションが適切に設定されている必要があります。

次にファイルをクローズする方法です。

bool fclose(resource handle) 

handleが指しているファイルがクローズされます。

引数：
  handle  対象となるハンドル
返り値：
  成功した場合に TRUE を、失敗した場合に FALSE

実際の流れとしては下記のようになります。 

$fp = fopen('filename', 'mode');

// ファイルに対する操作を行う

fclose($fp);
サンプルコード

では実際に試してみます。 

<html>
<head><title>PHP TEST</title></head>
<body>

<?php

$fp = fopen('sample.txt', 'r');

$flag = fclose($fp);

if ($flag){
    print('無事クローズしました');
}else{
    print('クローズに失敗しました');
}

?>
</body>
</html>

上記では、まず「sample.txt」を設置せずに上記ファイルを Web サーバに設置しブラウザ経由で見ると下記のように表示されます。

fopenのテスト

次に、このプログラムと同じディレクトリ内に「sample.txt」という適当なファイルを置いてから実行すると下記のように表示されます。

fopenのテスト

-- --

PHP で用意されている組み込み関数の一つである fopen 関数および fclose 関数の使い方について解説しました。

( Written by Tatsuo Ikura )

プロフィール画像

著者 / TATSUO IKURA

これから IT 関連の知識を学ばれる方を対象に、色々な言語でのプログラミング方法や関連する技術、開発環境構築などに関する解説サイトを運営しています。