fread

(PHP 3, PHP 4 )

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()