ファイルを出力する

# readfile

(PHP 4, PHP 5, PHP 7)

readfile — ファイルを出力する

### 説明

readfile ( string `$filename` [, bool `$use_include_path` = `FALSE` [, resource `$context` ]] ) : int

ファイルを読んで標準出力に書き出します。

### パラメータ

`filename`

  読み込もうとするファイルの名前。

`use_include_path`

  オプションの2番目の引数を使用して、これに`TRUE`を設定することにより、 include_path のファイルの検索も行うことができます。

`context`

  コンテキストストリームリソース。

### 返り値

ファイルから読み込んだバイト数を返します。エラーが起こると `FALSE`を返し、また@readfile()という名前でコールされない限り、 エラーメッセージが表示されます。

### 例

例1 readfile() によるダウンロードの強制

`<?php
$file = 'monkey.gif';
if (file_exists($file)) {
header('Content-Description: File Transfer');
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename="'.basename($file).'"');
header('Expires: 0');
header('Cache-Control: must-revalidate');
header('Pragma: public');
header('Content-Length: ' . filesize($file));
readfile($file);
exit;
}
?>`

上の例の出力は、 たとえば以下のようになります。

### 注意

> 注意:

> readfile() 自体にはメモリに関する問題はなく、 巨大なファイルを送ってもかまいません。out of memoryエラーが出る場合は、 ob_get_level() で出力バッファリングを無効にしてください。

ヒント

fopen wrappers が有効の場合、この関数のファイル名として URL を使用することができます。ファイル名の指定方法に関する詳細は fopen() を参照ください。 サポートするプロトコル/ラッパー には、さまざまなラッパーの機能やその使用法、 提供される定義済み変数などの情報がまとめられています。

> 注意: コンテキストのサポートは、 PHP 5.0.0 で追加されました。contexts の説明に関しては、 ストリーム を参照してください。

### 参考

- fpassthru() - ファイルポインタ上に残っているすべてのデータを出力する
- file() - ファイル全体を読み込んで配列に格納する
- fopen() - ファイルまたは URL をオープンする
- include - include
- require - require
- virtual() - Apache サブリクエストを実行する
- file_get_contents() - ファイルの内容を全て文字列に読み込む
- サポートするプロトコル/ラッパー