PHP file_put_contents 将字符串写入或追加到文件

在php中文件file_put_contents函数是可以把我们字符串写入到文件中,这个与php fwrite文件有一点相同了,下面我来看看看file_put_contents用法与fwrite区别.

PHP file_put_contents() 函数是一次性向文件写入字符串或追加字符串内容的最合适选择.

file_put_contents()

file_put_contents() 函数用于把字符串写入文件,成功返回写入到文件内数据的字节数,失败则返回 FALSE.

例子代码如下:

1. <?php 
2. echo file_put_contents("test.txt", "This is something."); 
3. ?> 
4. //运行该例子，浏览器输出： 
5. //18 

而 test.txt 文件,与程序同目录下,内容则为：This is something.

提示:

如果文件不存在,则创建文件,相当于fopen()函数行为.

如果文件存在,默认将清空文件内的内容,可设置 flags 参数值为 FILE_APPEND 以避免,见下.

本函数可安全用于二进制对象,以追加形式写入内容,当设置 flags 参数值为 FILE_APPEND 时,表示在已有文件内容后面追加内容的方式写入新数据,代码如下:

1. <?php 
2. file_put_contents("test.txt", "This is another something.", FILE_APPEND); 
3. ?> 

执行程序后,test.txt 文件内容变为:This is something.This is another something.

file_put_contents() 的行为实际上等于依次调用 fopen(),fwrite() 以及 fclose() 功能一样,那么到底file_put_contents与fwrite区别在哪里,如下为file_put_contents的实例代码:

1. <?php 
2. $filename = 'file.txt'; 
3. $word = "你好!rnwebkaka";  //双引号会换行 单引号不换行 
4. file_put_contents($filename, $word); 
5. ?> 

同样的功能使用fwrite的实例代码,如下:

1. <?php 
2. $filename = 'file.txt'; 
3. $word = "你好!rnwebkaka";  //双引号会换行  单引号不换行 
4. $fh = fopen($filename, "w"); //w从开头写入 a追加写入 
5. echo fwrite($fh, $word); 
6. fclose($fh); 
7. ?> 

从以上两个例子看出，其实file_put_contents是fopen、fwrite、fclose三合一的简化写法,这对程序代码的优化是有好处的,一方面在代码量上有所减少,另一方面不会出现fclose漏写的不严密代码,在调试、维护上方便很多.

上述例子里,file_put_contents是从头写入,如果要追加写入,怎么办呢？在file_put_contents的语法里,有个参数FILE_APPEND,这是追加写入的声明,实例代码如下:

1. <?php 
2. echo file_put_contents('file.txt', "This is another something.", FILE_APPEND); 
3. ?> 

FILE_APPEND就是追加写入的声明,在追加写入时,为了避免其他人同时操作,往往需要锁定文件,这时需要加多一个LOCK_EX的声明,写法如下:

1. <?php 
2. echo file_put_contents('file.txt', "This is another something.", FILE_APPEND|LOCK_EX); 
3. ?> 

注意,以上代码中echo输出到显示器里的是写入文件字符串的长度.