PHP读取文件的常见几种方法

最近整理了PHP读取文件的常见几种方法，具体如下：

1.fread

string fread ( int $handle , int $length )

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

fread() 返回所读取的字符串，如果出错返回 FALSE。

<?php
 $filename = "/usr/local/something.txt";
 $handle = fopen($filename, "r");//读取二进制文件时，需要将第二个参数设置成'rb'
 
 //通过filesize获得文件大小，将整个文件一下子读到一个字符串中
 $contents = fread($handle, filesize ($filename));
 fclose($handle);
?>

如果所要读取的文件不是本地普通文件，而是远程文件或者流文件，就不能用这种方法，因为，filesize不能获得这些文件的大小。此时，你需要通过feof()或者fread()的返回值判断是否已经读取到了文件的末尾。

例如：

<?php
 $handle = fopen('http://www.baidu.com', 'r');
 $content = '';
 while(!feof($handle)){
  $content .= fread($handle, 8080);
 }
 echo $content;
 fclose($handle);
?>

或者：

<?php
 $handle = fopen('http://www.baidu.com', 'r');
 $content = '';
 while(false != ($a = fread($handle, 8080))){//返回false表示已经读取到文件末尾
  $content .= $a;
 }
 echo $content;
 fclose($handle);
?>

2.fgets

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

fgets()从 handle 指向的文件中读取一行并返回长度最多为 length - 1 字节的字符串。碰到换行符（包括在返回值中）、EOF 或者已经读取了 length - 1 字节后停止（看先碰到那一种情况）。如果没有指定 length，则默认为 1K，或者说 1024 字节。

<?php
 $handle = fopen('./file.txt', 'r');
 while(!feof($handle)){
  echo fgets($handle, 1024);
 }
 fclose($handle);
?>

Note: length 参数从 PHP 4.2.0 起成为可选项，如果忽略，则行的长度被假定为 1024。从 PHP 4.3 开始，忽略掉 length 将继续从流中读取数据直到行结束。如果文件中的大多数行都大于 8KB，则在脚本中指定最大行的长度在利用资源上更为有效。从 PHP 4.3 开始本函数可以安全用于二进制文件。早期的版本则不行。

3.fgetss

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

跟fgets功能一样，但是fgetss会尝试从读取的文本中去掉任何 HTML 和 PHP 标记，可以用可选的第三个参数指定哪些标记不被去掉。

<?php
 $handle = fopen('./file.txt', 'r');
 while(!feof($handle)){
  echo fgetss($handle, 1024, '<br>');
 }
 fclose($handle);
?>

4.file

array file ( string $filename [, int $use_include_path [, resource $context ]] )

将文件内容读入一个数组中，数组的每一项对应文件中的一行，包括换行符在内。不需要行结束符时可以使用 rtrim() 函数过滤换行符。

<?php
 $a = file('./file.txt');
 foreach($a as $line => $content){
  echo 'line '.($line + 1).':'.$content;
 }
?>

5.readfile

int readfile ( string $filename [, bool $use_include_path [, resource $context ]] )

读入一个文件并写入到输出缓冲。返回从文件中读入的字节数。如果出错返回 FALSE 并且除非是以 @readfile() 形式调用，否则会显示错误信息。

<?php
 $size = readfile('./file.txt');
 echo $size;
?>

6.file_get_contents

string file_get_contents ( string $filename [, bool $use_include_path [, resource $context [, int $offset [, int $maxlen ]]]] )

将文件读入一个字符串。第三个参数$context可以用来设置一些参数，比如访问远程文件时，设置超时等等。

另外，file_get_contents相对于以上几个函数，性能要好得多，所以应该优先考虑使用file_get_contents。但是readfile貌似比file_get_contents性能好一点（？），因为它不需要调用fopen。

<?php 
 $ctx = stream_context_create(array( 
  'http' => array( 
   'timeout' => 1 //设置超时
   ) 
  ) 
 ); 
 echo file_get_contents("http://www.baidu.com/", 0, $ctx); 
?>

7.fpassthru

int fpassthru ( resource $handle )

将给定的文件指针从当前的位置读取到 EOF 并把结果写到输出缓冲区。

<?php 
 header("Content-Type:text/html;charset=utf-8"); 
 $handle = fopen('./test2.php', 'r');
 fseek($handle, 1024);//将指针定位到1024字节处
 fpassthru($handle);
?>

8.parse_ini_file

array parse_ini_file ( string $filename [, bool $process_sections ] )

parse_ini_file() 载入一个由 filename 指定的 ini 文件，并将其中的设置作为一个联合数组返回。如果将最后的 process_sections 参数设为 TRUE，将得到一个多维数组，包括了配置文件中每一节的名称和设置。process_sections 的默认值是 FALSE。

注意：

1. 如果 ini 文件中的值包含任何非字母数字的字符，需要将其括在双引号中（"）。
2. 有些保留字不能作为 ini 文件中的键名，包括：null，yes，no，true 和 false。值为 null，no 和 false 等效于 ""，值为 yes 和 true 等效于 "1"。字符 {}|&~![()" 也不能用在键名的任何地方，而且这些字符在选项值中有着特殊的意义。

test.ini文件内容：

; This is a sample configuration file
; Comments start with ';', as in php.ini
[first_section]
one = 1
five = 5
animal = BIRD
[second_section]
path = "/usr/local/bin"
URL = "//www.jb51.net/

test.php内容：

<?php 
 $config = parse_ini_file('./test.ini', ture);
 print_r($config);
?>

输出内容：

Array
(
    [first_section] => Array
        (
            [one] => 1
            [five] => 5
            [animal] => BIRD
        )
  [second_section] => Array
        (
            [path] => /usr/local/bin
            [URL] => //www.jb51.net/
        )

)

几个注意事项：

1. 鼓励在处理二进制文件时使用 b 标志，即使系统并不需要，这样可以使脚本的移植性更好。

2. allow_url_fopen选项激活了 URL 形式的 fopen 封装协议使得可以访问 URL 对象例如文件。默认的封装协议提供用 ftp 和 http 协议来访问远程文件，一些扩展库例如 zlib 可能会注册更多的封装协议。出于安全性考虑，此选项只能在 php.ini 中设置。

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