file_put_contents - PHP

PHP中的 file_put_contents() 函数使用指定的数据替换指定文件中的全部内容。如果文件不存在，则创建一个新文件。

基本语法

file_put_contents( $file, $data [, $flags [, $context]] )

• $file：必需。规定要写入数据的文件。
• $data：必需。规定要写入文件的数据。可以是字符串、数组或者通过 fopen() 打开的文件指针。
• $flags：可选。规定如何打开文件。默认是 0，表示没有设置，可选的常量有：
  • FILE_USE_INCLUDE_PATH：寻找文件时在 include_path 中搜索文件。
  • FILE_APPEND：在文件末尾写入新数据而不覆盖原数据。
  • LOCK_EX：在写入数据时获得一个独占锁定。
• $context：可选。规定文件流的上下文。可以是通过 stream_context_create() 函数建立的上下文，也可以是包含 stream_*() 函数的数组。

示例

<?php
$file = 'example.txt';
$data = 'This is a test';
file_put_contents($file, $data);
?>

这个例子创建一个名为 "example.txt" 的新文件，并将内容 "This is a test" 写入文件中。

返回值

file_put_contents() 函数在写入成功时返回写入的字符数。在写入失败时返回 FALSE。

Markdown格式返回代码片段

# file_put_contents - PHP

PHP中的 `file_put_contents()` 函数使用指定的数据替换指定文件中的全部内容。如果文件不存在，则创建一个新文件。

### 基本语法

file_put_contents( $file, $data [, $flags [, $context]] )

- `$file`：必需。规定要写入数据的文件。
- `$data`：必需。规定要写入文件的数据。可以是字符串、数组或者通过 `fopen()` 打开的文件指针。
- `$flags`：可选。规定如何打开文件。默认是 `0`，表示没有设置，可选的常量有：
    - `FILE_USE_INCLUDE_PATH`：寻找文件时在 include_path 中搜索文件。
    - `FILE_APPEND`：在文件末尾写入新数据而不覆盖原数据。
    - `LOCK_EX`：在写入数据时获得一个独占锁定。
- `$context`：可选。规定文件流的上下文。可以是通过 `stream_context_create()` 函数建立的上下文，也可以是包含 `stream_*()` 函数的数组。

### 示例

```php
$file = 'example.txt';
$data = 'This is a test';
file_put_contents($file, $data);

这个例子创建一个名为 "example.txt" 的新文件，并将内容 "This is a test" 写入文件中。

返回值

file_put_contents() 函数在写入成功时返回写入的字符数。在写入失败时返回 FALSE。