PHP file_put_contents() 函數

PHP Filesystem 參考手冊 完整的 PHP Filesystem 參考手冊

定義和用法

file_put_contents() 函數把一個字串寫入檔中。

該函數訪問檔時，遵循以下規則：

  1. 如果設置了 FILE_USE_INCLUDE_PATH，那麼將檢查 *filename* 副本的內置路徑
  2. 如果檔不存在，將創建一個檔
  3. 打開檔
  4. 如果設置了 LOCK_EX，那麼將鎖定檔
  5. 如果設置了 FILE_APPEND，那麼將移至檔末尾。否則，將會清除檔的內容
  6. 向檔中寫入數據
  7. 關閉檔並對所有檔解鎖

如果成功，該函數將返回寫入檔中的字元數。如果失敗，則返回 False。

語法

int file_put_contents ( string $filename , mixed $data [, int $flags = 0 [, resource $context ]] )

參數 描述
file 必需。規定要寫入數據的檔。如果檔不存在，則創建一個新檔。
data 必需。規定要寫入檔的數據。可以是字串、數組或數據流。
mode 可選。規定如何打開/寫入檔。可能的值：
  • FILE_USE_INCLUDE_PATH
  • FILE_APPEND
  • LOCK_EX
context 可選。規定檔句柄的環境。context 是一套可以修改流的行為的選項。

提示和注釋

注釋：請使用 FILE_APPEND 避免刪除檔中已存在的內容。

實例

實例

<?php echo file_put_contents("sites.txt","zaixian"); ?>

以上實例執行輸出結果為：

6

接下來我們向檔 sites.txt 追加內容：

實例

<?php $file = 'sites.txt'; $site = "\nGoogle"; // 向檔追加寫入內容 // 使用 FILE_APPEND 標記，可以在檔末尾追加內容 // LOCK_EX 標記可以防止多人同時寫入 file_put_contents($file, $site, FILE_APPEND | LOCK_EX); ?>

執行成功後，打開 sites.txt 檔，內容為：

zaixian
Google

PHP Filesystem 參考手冊 完整的 PHP Filesystem 參考手冊