PHP Manual
后退 |  | 前进

# fread

(PHP 3, PHP 4, PHP 5)

fread -- 读取文件（可安全用于二进制文件）

## 说明

string fread ( int handle, int length )

fread() 从文件指针 handle 读取最多 length 个字节。 该函数在读取完 length 个字节数，或到达 EOF 的时候，或（对于网络流）当一个包可用时就会停止读取文件，视乎先碰到哪种情况。

`// get contents of a file into a string $filename = "/usr/local/something.txt"; $handle = fopen ($filename, "r"); $contents = fread ($handle, filesize ($filename)); fclose ($handle);`

警告
在区分二进制文件和文本文件的系统上（如 Windows）打开文件时，fopen() 函数的 mode 参数要加上 'b'。

`$filename = "c:\\files\\somepic.gif"; $handle = fopen ($filename, "rb"); $contents = fread ($handle, filesize ($filename)); fclose ($handle);`

警告
当从网络流或者管道读取时，例如在读取从远程文件或 popen() 以及 proc_open() 的返回时，读取会在一个包可用之后停止。这意味着你应该如下例所示将数据收集起来合并成大块。

`<?php $handle = fopen ("http://www.example.com/", "rb"); $contents = ""; do { $data = fread($handle, 8192); if (strlen($data) == 0) { break; } $contents .= $data; } while(true); fclose ($handle); ?>`

> 注: 上例比传统的使用 while(!feof()) 的方法性能要好，因为在每个循环中节约了函数调用的花费。

> 注: 如果你只是想将一个文件的内容读入到一个字符串中，用 file_get_contents()，它的性能比上面的代码好得多。

参见 fwrite()，fopen()，fsockopen()，popen()，fgets()，fgetss()，fscanf()，file() 和 fpassthru()。

后退 | 起点 | 前进
fputs | 上一级 | fscanf