file_put_contents的用法

本文介绍了 PHP 中 file_put_contents() 函数的基本用法,包括如何使用该函数进行文件写入操作、如何追加内容到现有文件中以及如何进行日志记录等。同时还提供了一个详细的示例代码。

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

file_put_contents()

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

语法:

int file_put_contents ( string filename, string data [, int flags [, resource context]] )
参数说明:
参数说明
filename要写入数据的文件名
data要写入的数据。类型可以是 string,array(但不能为多维数组),或者是 stream 资源
flags可选,规定如何打开/写入文件。可能的值:
  1. FILE_USE_INCLUDE_PATH:检查 filename 副本的内置路径
  2. FILE_APPEND:在文件末尾以追加的方式写入数据
  3. LOCK_EX:对文件上锁
context可选,Context是一组选项,可以通过它修改文本属性

例子:

<?php
echo file_put_contents("test.txt", "This is something.");
?>

运行该例子,浏览器输出:

18

而 test.txt 文件(与程序同目录下)内容则为:This is something.。

提示

  • 如果文件不存在,则创建文件,相当于fopen()函数行为。
  • 如果文件存在,默认将清空文件内的内容,可设置 flags 参数值为 FILE_APPEND 以避免(见下)。
  • 本函数可安全用于二进制对象。

以追加形式写入内容

当设置 flags 参数值为 FILE_APPEND 时,表示在已有文件内容后面追加内容的方式写入新数据:

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

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

file_put_contents() 的行为实际上等于依次调用 fopen(),fwrite() 以及 fclose() 功能一样。

 
    //日志记录
    private function logger($log_content)
    {
        if(isset($_SERVER['HTTP_APPNAME'])){   //SAE
            //sae_set_display_errors(false);
            //sae_debug($log_content);
            //sae_set_display_errors(true);
        }else if($_SERVER['REMOTE_ADDR'] == "127.0.0.1"){ //LOCAL本地
            $max_size = 1000000;
            $log_filename = "log.xml";
            if(file_exists($log_filename) and (abs(filesize($log_filename)) > $max_size)){unlink($log_filename);}
            file_put_contents($log_filename, date('Y-m-d H:i:s')." ".$log_content."\r\n", FILE_APPEND);
           
        }
    }


`file_put_contents` 是 PHP 中一个非常方便的函数,用于将字符串写入文件。与多次调用 `fwrite` 不同,该函数能够以一行代码完成文件的打开、写入和关闭操作,极大地简化了文件写入的流程[^1]。它适用于一次性写入少量数据的场景,例如日志记录、配置保存等。 ### 基本语法 ```php int file_put_contents ( string $filename , mixed $data [, int $flags = 0 [, resource $context ]] ) ``` - `$filename`:要写入的目标文件路径。 - `$data`:要写入的数据,可以是字符串、数组(会自动转换为字符串)等。 - `$flags`:可选参数,用于指定写入方式,例如追加内容、锁定文件等。 - `$context`:可选参数,用于指定上下文资源,通常用于流操作。 ### 返回值 返回写入的字节数,若失败则返回 `false`。 ### 使用示例 #### 示例 1:基本写入 ```php $data = "Hello, world!"; file_put_contents('example.txt', $data); ``` 此代码会将字符串 `"Hello, world!"` 写入 `example.txt` 文件中,若文件不存在则创建,若存在则覆盖原有内容。 #### 示例 2:追加写入 使用 `FILE_APPEND` 标志可以实现追加写入,避免覆盖已有内容。 ```php $data = "\nThis is a new line."; file_put_contents('example.txt', $data, FILE_APPEND); ``` 此时,新内容将追加在文件末尾。 #### 示例 3:锁定文件写入 使用 `LOCK_EX` 标志可以对文件进行独占锁定,防止并发写入冲突。 ```php $data = "Important data"; file_put_contents('log.txt', $data, LOCK_EX); ``` #### 示例 4:写入数组 如果 `$data` 是一个数组,`file_put_contents` 会自动将其转换为字符串。 ```php $data = ["Line 1\n", "Line 2\n", "Line 3\n"]; file_put_contents('lines.txt', $data); ``` 这将写入: ``` Line 1 Line 2 Line 3 ``` ### 注意事项 - `file_put_contents` 是一个原子操作,即整个写入过程在一个函数调用中完成,适用于一次性写入场景。 - 若需多次写入或处理大文件,建议使用 `fopen` + `fwrite` + `fclose` 的方式,以减少内存压力[^1]。 - 使用 `LOCK_EX` 可以提高并发环境下的数据一致性,但可能会影响性能。 ---
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值