【PHP】文件写入和读取详解

一．实现文件读取和写入的基本思路：

1．通过fopen方法打开文件：$fp =fopen(/*参数，参数*/)，fp为Resource类型

2．进行文件读取或者文件写入操作（这里使用的函数以1中返回的$fp作为参数）

3. 调用fclose($fp)关闭关闭文件

二：使用fopen方法打开文件

fopen(文件路径[string],打开模式[string])

<1>fopen的第一个参数为文件路径

写文件路径的方式：1绝对路径，2相对路径

1绝对路径：

在windows下工作的小伙伴们应该很熟悉，windows下的路径分隔符是“\”而不是“/”，但我们在写入路径时不能以钦定的“\”为分隔符

那如果我们以“\”分隔符写入路径会怎样呢？

<?php
     $fp = fopen("C:\wamp64\www\text.txt",'w');
?>

复制

运行后报错，提示路径参数无效

所以我们要把分隔符“\”换成“/”:

<?php
    $fp = fopen("C:/wamp64/www/text.txt",'w');
?>

复制

运行时无报错，说明参数是有效的。

【注意】fopen函数不能理解“\”分隔符，如果你想要使用“\”，那么要使用转义，如写成："C:\\wamp64\\www\\text.txt"这种写法也是可以的，函数也能理解，不会报错。但即使这样，也不推荐使用“\”,因为在OS(mac)下只能识别“/”不能识别“\”

本小节的结论：推荐坚持使用“/”作为分隔符

2.相对路径：

上一小节介绍的是绝对路径的写法，但这样却带来了另外一个问题：服务器的目录结构可能会有较大的改变，这时原来写的绝对路径就要全部重写了，比如在我的电脑上的目标文件路径是C:/wamp64/www/text.txt，如果我把www文件夹改名为penghuwan呢？原来写入的路径参数就失效了。所以我们引入了相对路径的写法：

<?php
   $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT'];
   $fp = fopen("$DOCUMENT_ROOT/text.txt",'w');
?>

复制

• $_SERVER是PHP的超级全局变量（在代码任何地方都可访问，类型是数组），通过$_SERVER['DOCUMENT_ROOT']可取到服务器的默认根目录

服务器的默认根目录可通过php.ini修改（这个可自行百度）

• $_SERVER['DOCUMENT_ROOT']在这里等同于C:/wamp64/wwｗ

本小节的结论：推荐使用相对路径

<2>fopen的第二个参数为打开模式

设置打开模式后，我们就相当于为接下来的读写操作设置了权限：

最基本的几个模式：

“r”:只能读取文件，不能写入文件（写入操作被忽略）

“w”:只能写入文件，不能读取文件（读取操作被忽略）

“a”:只追加文件，与“w”类似，区别是“w”删除原有的内容，“a”不删除原有内容，只追加内容

<?php
   $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT'];
   $fp = fopen("$DOCUMENT_ROOT/text.txt",'w');
   fwrite($fp,'在写模式下写入');
   fclose($fp);
?>

复制

在设置了写操作的权限后，就能正常地写入文件了

运行后打开C:/wamp64/www/text.txt：

这次我们把权限设置为只读，并尝试写入文本：'在只读模式下写入'

<?php
    $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT'];
    $fp = fopen("$DOCUMENT_ROOT/text.txt",'r');
    fwrite($fp,'在读模式下写入');
    fclose($fp);
?>

复制

运行后打开C:/wamp64/www/text.txt，发现文件内容并没有改变，说明由于没有设置相应的权限，操作被忽略了

关于打开模式的网络资料，我想大家最可能找到的是这张表：(图来自W3C)

很全面，但我觉得这张表对新手有些不太友好，让人看后不知多云。 r是只读，w是只写（原来有的内容全删除），a是追加(不删除原有内容)，这都好理解。

但r+,w+，和a+的区别和联系讲的实在太模糊了呀。这里我就想详细地讲一下r+,w+，和a+三者的区别和联系:

首先r+,w+，和a+都是可读可写的，读取时的方式是一样的，关键在于写入方式的不同:

r+: 从文件[头部][覆盖]原有内容（[不删除]原有内容）；

a+:从文件[尾部][追加]内容（[不删除]原有内容）；

w+:[完全删除]原有内容，然后[再添加]新的内容

下面我依次演示上述的结论，首先我们没有写入的时候文本是”I am initialized value”(意为我是初始值)

• 采用r+模式写入文本“r+ mode”

<?php
    $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT'];
    $fp = fopen("$DOCUMENT_ROOT/text.txt",'r+');
    fwrite($fp,'r+ mode');
    fclose($fp);
?>

复制

运行后再打开文本，发现“I am in”被“r+ mode”覆盖了：

• 采用a+模式写入文本“a+ mode”

基于”I am initialized value”的初始文本我们运行以下代码：

<?php
    $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT'];
    $fp = fopen("$DOCUMENT_ROOT/text.txt",'a+');
    fwrite($fp,'a+ mode');
    fclose($fp);
?>

复制

I am initialized value没有被删除和覆盖，而是在后面追加了a+ mode的这一段新文本

运行多次后：

•采用w+模式写入文本“w+ mode”

基于”I am initialized value”的初始文本我们运行以下代码：

<?php
   $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT'];
   $fp = fopen("$DOCUMENT_ROOT/text.txt",'w+');
   fwrite($fp,'w+ mode');
   fclose($fp);
?>

复制

运行后，我们发现”I am initialized value”已经被删除了，然后才加上了“w+ mode”这段新文本

【注意】r+,a+,w+还有一个区别是a+,w+在文件不存在时则创建文件，r+文件不存在时报错

【吐槽】：关于r+和w+,a+的区别，我找了网络上，包括W3C和各种博客文章以及那本“PHP圣经”上的各种资料，发现都是一笔带过去的，这也是我写这篇文章的原因

三．文件读取和文件写入操作

先说说几个比较重要的函数：

• file_exists()：判断文件是否存在，返回布尔值

• filesize():判断一个文件大小，返回文件的字节数，为整型数字

• unlink():删除一个文件

写入文件

fwrite(资源文件对象[string],写入方式[string]),资源文件对象即为fopen方法返回的参数，为Resource类型，写入方式可以是w(或者w+,a+,r+)

已经有上面的例子，这里就不放demo了

读取文件

这是我们要读取的文件内容：

读取文件的方式有以下几种：

1.一次读取一个字节的数据 fgetc()

2.一次读取指定的字节数的数据 fread()

3.一次读取一行数据 fgets()/fgetcsv()

4.一次读完全部数据 fpassthru()/ file()

1. 一次读取一个字节 —— 通过fgetc()获取单个字节

<?php
     $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT'];
     $fp = fopen("$DOCUMENT_ROOT/text.txt",'r');//打开文件
     if(file_exists("$DOCUMENT_ROOT/text.txt")){//当文件存在时，才读取内容
          while(!feof($fp)){//判断文件指针是否到达末尾
               $c = fgetc($fp);//每执行一次fgetc()，文件指针就向后移动一位
               echo $c;//输出获取到的字节
            }
       }
     fclose($fp);//关闭文件
?>

复制

运行：

【注意】：无论是按文本格式输入输出还是按二进制格式输出，fgetc()每次获取的是一个字节而不是一个字符！

上面的例子中我们是逐个输出，现在让我们只做一次输出，看看结果怎样：

<?php
    $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT'];
    $fp = fopen("$DOCUMENT_ROOT/text.txt",'r');
    echo fgetc($fp);//只做一次输出
    close($fp);
?>

复制

运行结果如下，我们得到的不是汉字“我”，而是一个乱码，其实这个乱码就是一个字节

<?php
     $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT'];
     $fp = fopen("$DOCUMENT_ROOT/text.txt",'r');
     echo fgetc($fp);//连续做三次输出
     echo fgetc($fp);
     echo fgetc($fp);
     fclose($fp);
?>

复制

2.一次读取多个字节 ——通过fread()方法：

<?php
   $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT'];
   $fp = fopen("$DOCUMENT_ROOT/text.txt",'r');
   echo fread($fp, 3);//一次输出三个字节即一个汉字字符（UTF-8）
   fclose($fp);
?>

复制

运行结果：

改成：

echo fread($fp, 6);

复制

运行结果如下，输出了6个字节也即两个汉字字符（UTF-8）

3.一次读取一行——通过fgets()获取一行内容

<?php
       $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT']
       $fp = fopen("$DOCUMENT_ROOT/text.txt",'r');//打开文件
       if(file_exists("$DOCUMENT_ROOT/text.txt")){//当文件存在时，才读取内容
          while(!feof($fp)){//判断文件指针是否到达末尾
             $line = fgets($fp);//返回一行文本，并将文件指针移动到下一行头部
             echo $line."<br/>";//输出获取到的一行文本
          }
       }
       fclose($fp);//关闭文件
?>

复制

fgets()其实还有第二个参数，这个参数规定了每一行能读取的最大字节数（注意是字节数不是字符数）：

【注意】在UTF-8编码下汉字3字节，字母1字节

下面我修改上面的一行，代码，使获取的每一行最大字符数为3（也即字节数为9）

$line = fgets($fp,10);

复制

Demo:

【注意】：这里我fgets()里第二个参数为10，为什么是10呢？因为

1.这里的长度是按字节数算的

2.一个汉字占3个字节。fgets($fp,10)代表一次最多读取10 - 1 = 9字节

4.一次读完全部文件 ——fpassthru() or file()?

fpassthru()将读取文件并直接输出（无处理过程）

<?php
      $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT'];
      $fp = fopen("$DOCUMENT_ROOT/text.txt",'r');
      fpassthru($fp);
      fclose($fp);
?>

复制

运行结果：

【注意】这里需要注意一点的是，我们并没有从fpassthru($fp)获取到返回值然后echo到页面上去，也就是说这个方法是会强制输出获取的内容的，而并不是像之前例子的方法那样返回文本，允许我们保存到变量中才将其输出

将读取到的全部内容保存到一个数组中,每个数组元素为一行的内容——fille()

<?php
   $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT'];
   $file_array = file("$DOCUMENT_ROOT/text.txt");//取到文件数组
   foreach ($file_array as $value) {//输出数组元素
       echo $value."<br/>";
    }
?>

复制

【注意】：这里我们并不需要写fopen和fclose哦！也就是说file()方法已经帮我们做了这一步了

四．使用fclose方法关闭文件

fclose()将返回一个布尔值，成功关闭为true，关闭失败为false(失败的情况很少出现，可不考虑)

是否打开文件后一定要关闭？

1即使不手写fclose，在PHP脚本执行结束后，也会自动关闭文件的

2但在一个长时间执行的脚本中，如果不写关闭文件的fclose()，在文件加锁的情况下会造成操作的阻塞，所以，写fclose是个好习惯

五．文件指针的移动

我们上面调用的读取文件的函数，其实都是基于文件指针去打印的，每读取一段字节内容，文件指针就向后移动一段字节长度，直到被读取的文件最大字节长度为止

<?php
          $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT'];
          function print_file_pointer($fp){//定义一个打印文件指针位置的函数
              echo " <br/>//此时文件指针的位置：";
              echo ftell($fp)."<br/>";
          }
          $fp = fopen("$DOCUMENT_ROOT/text.txt",'r');
          echo fgetc($fp);//通过fgetc连续输出三个字节
          echo fgetc($fp);
          echo fgetc($fp);
          print_file_pointer($fp);//打印此刻文件指针的位置
          
          echo fread($fp,6);//通过fread一次输出6字节
          print_file_pointer($fp);//打印此刻文件指针的位置
          
          echo fgets($fp); //通过fgets输出一整行
          print_file_pointer($fp);//打印此刻文件指针的位置
          
          fpassthru($fp); //一次性输出全部内容
          print_file_pointer($fp);//打印此刻文件指针的位置
          
          fseek($fp, 33);//使文件指针移动到33字节位置
          print_file_pointer($fp);//打印此刻文件指针的位置
          
          rewind($fp);//使文件指针移动到0字节位置（初始位置）
          print_file_pointer($fp);//打印此刻文件指针的位置
$fclose($fp);
?>

复制

Demo:

所以我们需要正确理解fgets(),fpassthru()这些函数的作用：

fgets():从当前文件指针的位置到本行结束的数据，而不是一定输出一整行

fpassthru():从当前文件指针的位置到全部内容结束的数据，而不是一定输出所有的数据

但在这里你可能会有疑问：为什么输出“湖湾”后的指针位置会是17而不是15呢？按理说输出“我叫彭湖湾”这5个汉字一共占3*5 = 15个字节，多出来的17 - 15 =2字节是什么呢？

多出来的两个字节是windows下的回车换行符\n\r

\n是换行，占一字节，\r是回车，占一字节，在六中我将会介绍

六．Windows和UNIX下的回车和换行

<?php
      $DOCUMENT_ROOT = $_SERVER['DOCUMENT_ROOT'];
      $fp = fopen("$DOCUMENT_ROOT/text.txt",'r');
      while(!feof($fp)){
        echo fgets($fp);
        echo ftell($fp);
      }
      fclose($fp);
?>

复制

我们在windows下敲下回车键的时候，相当于键入了\n\r，所以“我叫彭湖湾”的15字节+“\n\r”的2字节 = 17字节