语法:
int file_put_contents ( string $filename , mixed $data [, int $flags = 0 [, resource $context ]] )
参数 | 描述 |
---|---|
filename |
必需。 要被写入数据的文件名。 规定要写入数据的文件。如果文件不存在,则创建一个新文件。 |
data |
必需。规定要写入文件的数据。可以是字符串、数组或数据流。 string,array 或者是 stream 资源 参数 |
flags |
可选。 规定如何打开/写入文件。
可能的值:
|
context |
可选。 一个 context 资源。 规定文件句柄的环境。context 是一套可以修改流的行为的选项。 |
提示和注释
注释:请使用 FILE_APPEND 避免删除文件中已存在的内容。
该函数访问文件时,遵循以下规则:
- 如果设置了 FILE_USE_INCLUDE_PATH,那么将检查 *filename* 副本的内置路径
- 如果文件不存在,将创建一个文件
- 打开文件
- 如果设置了 LOCK_EX,那么将锁定文件
- 如果设置了 FILE_APPEND,那么将移至文件末尾。否则,将会清除文件的内容
- 向文件中写入数据
- 关闭文件并对所有文件解锁
如果成功,该函数将返回写入文件中的字符数。如果失败,则返回 False。
Warning
此函数可能返回布尔值 FALSE
,但也可能返回等同于 FALSE
的非布尔值。请阅读 布尔类型章节以获取更多信息。应使用 === 运算符来测试此函数的返回值。
Note: 此函数可安全用于二进制对象。
例子:
<?php echo file_put_contents("test.txt","Hello World. Testing!"); ?>
上面的代码将输出:
21
Example #1 Simple usage example
<?php $file = ‘people.txt‘; // Open the file to get existing content $current = file_get_contents($file); // Append a new person to the file $current .= "John Smith\n"; // Write the contents back to the file file_put_contents($file, $current); ?>
Example #2 Using flags
<?php $file = ‘people.txt‘; // The new person to add to the file $person = "John Smith\n"; // Write the contents to the file, // using the FILE_APPEND flag to append the content to the end of the file // and the LOCK_EX flag to prevent anyone else writing to the file at the same time file_put_contents($file, $person, FILE_APPEND | LOCK_EX); ?>
http://php.net/manual/zh/function.file-put-contents.php
http://www.w3cschool.cn/php/func-filesystem-file-put-contents.html
时间: 2024-10-03 22:42:23