readfile
そふぃのPHP入門 >> PHP関数リファレンス >> ファイルシステム関数 >> readfile

readfile

解説 ファイルを出力する
書式 int readfile( string filename [, bool use_include_path ] )
int readfile( string ファイル名 [, bool インクルードパス ] )
引数 filename ファイル名
use_include_path インクルードパスを検索するかどうか
返値 読み込んだバイト数／FALSE（読み込み失敗）

PHPマニュアル：readfile readfile()

readfile()関数：概略解説

readfile()は指定したファイル内容を全読み込んで標準出力に出力する関数です。標準出力とはWebサーバでPHPを動作させている場合にWebブラウザとなります。

readfile()関数：返り値解説

ファイルから読み込んだバイト数を返します。ファイルの読み込みに失敗した場合はFALSEを返しエラーを発します。エラー制御演算子（@）でエラーの出力を抑える事ができます。

readfile()関数：引数解説

filenameファイル名
出力したいファイルをパスでを指定します。
use_include_pathインクルードパス
インクルードパスを検索するかどうかのオプションです。デフォルトでは検索しない（FALSE）となっていますので、第2引数にTRUEを指定するとインクルードパスへの検索も行うようになります。

readfile()関数：補足解説

fopen_wrappersという設定値がONとなっていれば、第1引数のファイル名にURL（http://から始まる絶対パス）を指定する事ができます。

参考関数

  • file_get_contents() ---- ファイルの内容を全て取得する
  • file() ---- ファイルの内容を全て取得して配列に格納する
  • fpassthru() ---- 現在のファイルポインタの位置以降全てのデータを出力する

サンプルスクリプト

簡単な利用例

  1. <?php
  2. readfile('somefile.txt')
  3. ?>

ファイルの内容をすべて出力

  1. <?php
  2. $fp = @fopen("test.php", "r");
  3. while( ! feof( $fp ) ){
  4.   echo fgets( $fp, 9182 ) . "<br>";
  5. }
  6. fclose($fp);
  7. ?>

参考関数

  • fopen() ---- ファイルまたはURLを開く
  • fclose() ---- ファイルポインタを閉じる
  • feof() ---- ファイルの終端に達しているかどうか調べる
  • fgets() ---- ファイルから１行取得する
PHP辞典
PHP辞典 PHP5の関数にも対応したリファレンスですが、関数ごとにバージョンが表示されているのでPHP4ユーザにも安心。簡単なサンプルが全ての関数についている事と目的別検索が魅力です。
PHPポケットリファレンス
PHPポケットリファレンス 携帯用でもOKの小さめの本。関数本にありがちな分厚い・重い・見るのがおっくうという欠点をコンパクト化で解消してます。小さいながらも関数の掲載量・内容は共に十分充実しており、関数ごとのサンプルや目的別検索もあります。