php文件读取函数fread fgets fgetc fgetss file_get_contents及file区别与实例讲解

fread

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

语法：

string fread ( resource $handle , int $length )

fread() 从文件指针 handle 读取最多 length 个字节。 该函数在遇上以下几种情况时停止读取文件： 

1. 读取了 length 个字节 
2. 到达了文件末尾（EOF） 

参数：

1. handle 文件系统指针，是典型地由 fopen() 创建的 resource(资源)。
2. length 最多读取 length 个字节。 

返回值：

返回所读取的字符串， 或者在失败时返回 FALSE。 

实例：从文件中读取 10 个字节（包括空格）：

<?php
$filename = \"test.txt\";
$fh = fopen($filename, \"r\");
echo fread($fh, \"10\");
fclose($fh);
?>

提示：如果只是想将一个文件的内容读入到一个字符串中，应该用性能更好的file_get_contents()

file_get_contents

file_get_contents — 将整个文件读入一个字符串

和 file() 一样，只除了 file_get_contents() 把文件读入一个字符串。将在参数 offset 所指定的位置开始读取长度为 maxlen 的内容。如果失败，file_get_contents() 将返回 FALSE。 

file_get_contents() 函数是用来将文件的内容读入到一个字符串中的首选方法。如果操作系统支持还会使用内存映射技术来增强性能。 

注意: 如果要打开有特殊字符的 URL （比如说有空格），就需要使用 urlencode() 进行 URL 编码。 

语法：

string file_get_contents( string filename [, int offset [, int maxlen]] )

参数：

1. filename    要读取的文件名称
2. offset    可选，指定读取开始的位置，默认为文件开始位置
3. maxlen    可选，指定读取文件的长度，单位字节

返回值：The function returns the read data 或者在失败时返回 FALSE. 

实例：下面是一个使用file_get_contents()打开URL的例子。

<?php
$fh= file_get_contents(\'http://www.baidu.com/\');
echo $fh;
?>

从此例子看到，file_get_contents()打开网页后，返回的$fh是一个字符串，可以直接输出的。

fgets

fgets — 从文件指针中读取一行，从指向的文件中读取了指定字节后返回字符串。 如果文件指针中没有更多的数据或发送错误则返回 FALSE。

语法：

string fgets ( resource $handle [, int $length ] )

参数：

1. handle：文件指针必须是有效的，必须指向由 fopen() 或 fsockopen() 成功打开的文件(并还未由 fclose() 关闭)。
2. length：从 handle 指向的文件中读取一行并返回长度最多为 length - 1 字节的字符串。碰到换行符（包括在返回值中）、EOF 或者已经读取了 length - 1 字节后停止（看先碰到那一种情况）。如果没有指定 length，则默认为 1K，或者说 1024 字节。 

注意： 从 PHP 4.3 开始，忽略掉 length 则行的长度被假定为 1024，将继续从流中读取数据直到行结束。如果文件中的大多数行都大于 8KB，则在脚本中指定最大行的长度在利用资源上更为有效。 

实例：使用fgets()函数计算文件有多少段落(计算文件的段落数)

<?php
$paragraphs = 0;
/* http://www.manongjc.com/article/1346.html */
if ($fh = fopen(\'great-american-novel.txt\',\'r\')) {
  while (! feof($fh)) {
    $s = fgets($fh);
    if ((\"\\n\" == $s) || (\"\\r\\n\" == $s)) {
      $paragraphs++;
    }
  }
}
print $paragraphs;
?>

fgetss

fgetss — 从文件指针中读取一行并过滤掉HTML标签

语法：

string fgetss ( resource $handle [, int $length [, string $allowable_tags ]] )

和 fgets() 相同，只除了 fgetss() 尝试从读取的文本中去掉任何 HTML 和 PHP 标记。 

参数：

1. handle 文件指针必须是有效的，必须指向由 fopen() 或 fsockopen() 成功打开的文件(并还未由 fclose() 关闭)。
2. length 取回该长度的数据。 
3. allowable_tags 可以用可选的第三个参数指定哪些标记不被去掉。 

返回值：

从 handle 指向的文件中大读取 length - 1 个字节的字符，并过滤了所有的 HTML 和 PHP 代码。 错误发生时返回 FALSE。 

实例：fgetss读取文件并过滤掉除<h2><h3><p><b><a><img>以外的所有标签：

<?php
   $tags = \"<h2><h3><p><b><a><img>\";

   $fh = fopen(\"article.html\", \"rt\");

   while (!feof($fh)) {
      $article .= fgetss($fh, 1024, $tags);
   }
   fclose($fh);

   $fh = fopen(\"article.html\", \"wt\");
   fwrite($fh, $article);
   fclose($fh);
?>

fgetc

fgetc — 从文件指针中读取字符，该字符从指向的文件中得到。 碰到 EOF 则返回 FALSE 。

语法：

string fgetc(resource $handle)

从文件句柄中获取一个字符。

参数：

1. handle 文件指针必须是有效的，必须指向由 fopen() 或 fsockopen() 成功打开的文件(并还未由 fclose() 关闭)。

实例：使用fgetc()函数读取文件内容。

<?php
    $filename = \"test.txt\";
    $fp = fopen( $filename, \"r\" ) or die(\"Couldn\'t open $filename\");
    while ( ! feof( $fp ) ) {
     $char = fgetc( $fp );
     print \"$char<br/>\";
    }
?>

file

file() 函数用于把 整个文件 读入一个数组中，数组中的每个单元都是文件中相应的一行，包括换行符在内。成功返回一个数组，失败则返回 FALSE。

语法：

array file( string filename )

实例：

<?php
$lines = file(\'test.txt\');
// 在数组中循环并加上行号
foreach ($lines as $line_num => $line) {
    echo \"Line #{$line_num} : \",$line,\'<br />\';
}
?>

test.txt 文件内容：

你好！
这是第二行文字。

浏览器显示：

Line #0 : 你好！ 
Line #1 : 这是第二行文字。