PHP fopen()関数


PHP Filesystem 参考手册PHP Filesystem リファレンスマニュアル完全版

定義と使用法

fopen() 関数はファイルまたは URL を開きます。

fopen() が失敗した場合、FALSE とエラーメッセージを返します。関数名の前に '@' を追加することで、エラー出力を非表示にすることができます。

構文

fopen(filename,mode,include_path,context)

パラメータ 説明
filename 必須。開くファイルまたは URL を指定します。
mode 必須。そのファイル/ストリームへのアクセス型を指定します。

指定可能な値:

  • "r" (読み取り専用で開き、ファイルポインタをファイルの先頭に置きます)
  • "r+" (読み書き用に開き、ファイルポインタをファイルの先頭に置きます)
  • "w" (書き込み専用で開き、ファイルの内容をクリアします。ファイルが存在しない場合は作成を試みます)
  • "w+" (読み書き用に開き、ファイルの内容をクリアします。ファイルが存在しない場合は作成を試みます)
  • "a" (書き込み専用で開き、ファイルポインタをファイルの末尾に置いて書き込みます。ファイルが存在しない場合は作成を試みます)
  • "a+" (読み書き用に開き、ファイルポインタをファイルの末尾に置いて書き込むことで、ファイルの内容を保持します)
  • "x" (新しいファイルを作成し、書き込み専用で開きます。ファイルが既に存在する場合は FALSE とエラーを返します)
  • "x+" (新しいファイルを作成し、読み書き用に開きます。ファイルが既に存在する場合は FALSE とエラーを返します)
include_path オプション。include_path(php.ini 内)でもファイルを検索する場合は、このパラメータを '1' に設定してください。
context オプション。ファイルハンドルの環境を指定します。context はストリームの動作を変更できる一連のオプションです。


ヒントと注記

注記:テキストファイルを書き込むときは、正しい行終端文字を使用していることを確認してください!Unix システムでは行終端文字は \n です。Windows システムでは行終端文字は \r\n です。Macintosh システムでは行終端文字は \r です。Windows システムでは、テキスト変換フラグ "t" が用意されており、\n を \r\n に透過的に変換します。また、"b" を使用してバイナリモードを強制することもできます。この場合、データは変換されません。これらのフラグを使用するには、mode パラメータの最後の文字として "b" または "t" を使用してください。


例

<?php
$file = fopen("test.txt","r");
$file = fopen("/home/test/test.txt","r");
$file = fopen("/home/test/test.gif","wb");
$file = fopen("http://www.example.com/","r");
$file = fopen("ftp://user:password@example.com/test.txt","w");
?>


PHP Filesystem 参考手册PHP Filesystem リファレンスマニュアル完全版 その他の拡張機能