file_put_contents()函式—用法及示例

函式名：file_put_contents()

適用版本：PHP 4 >= 4.3.0, PHP 5, PHP 7

用法：file_put_contents(string $filename, mixed $data, int $flags = 0, resource $context = null): int|false

說明： file_put_contents() 函式將一個字串寫入檔案中。如果檔案不存在，則會建立檔案；如果檔案已存在，則會覆蓋原有內容。該函式是一個簡單且高效的替代方法，用於開啟、寫入並關閉檔案的過程。

引數：

• $filename：要寫入的檔案路徑。
• $data：要寫入檔案的資料。可以是一個字串、陣列或者是一個實現了 __toString() 方法的物件。
• $flags：可選引數，用於指定寫入檔案的方式。預設為 0，表示沒有特殊的寫入方式。可以使用以下常量進行設定：
  • FILE_USE_INCLUDE_PATH：如果設定了該常量，將在 include_path 目錄中搜尋檔案。
  • FILE_APPEND：如果檔案已經存在，將在檔案末尾追加內容，而不是覆蓋原有內容。
• $context：可選引數，用於指定上下文資源。通常不需要使用。

返回值：

• 成功：返回寫入到檔案中的位元組數。
• 失敗：返回 false。

示例：

1. 將字串寫入檔案：

$file = 'example.txt';
$data = 'Hello, World!';
file_put_contents($file, $data);

2. 將陣列轉換為 JSON 字串，並寫入檔案：

$file = 'example.json';
$data = ['name' => 'John', 'age' => 25];
$json = json_encode($data);
file_put_contents($file, $json);

3. 追加內容到已存在的檔案末尾：

$file = 'example.txt';
$data = 'More content';
file_put_contents($file, $data, FILE_APPEND);