PHP file_put_contents() 函數

定義和用法

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

與依次調用 fopen()，fwrite() 以及 fclose() 功能一樣。

文法

file_put_contents(file,data,mode,context)

參數	描述
file	必需。規定要寫入資料的檔案。如果檔案不存在，則建立一個新檔案。
data	可選。規定要寫入檔案的資料。可以是字串、數組或資料流。
mode	可選。規定如何開啟/寫入檔案。可能的值： FILE_USE_INCLUDE_PATH FILE_APPEND LOCK_EX
context	可選。規定檔案控制代碼的環境。 context 是一套可以修改流的行為的選項。若使用 null，則忽略。

說明

參數 data 可以是數組（但不能是多維陣列）。

自 PHP 5.1.0 起，data 參數也可以被指定為 stream 資源，stream 中所儲存的快取資料將被寫入到指定檔案中，這種用法就相似於使用 stream_copy_to_stream() 函數。

對 context 參數的支援是 PHP 5.0.0 添加的。

傳回值

該函數將返回寫入到檔案內資料的位元組數。

提示和注釋

提示：使用 FILE_APPEND 可避免刪除檔案中已有的內容。

注釋：本函數可安全用於二進位對象。

例子

<?phpecho file_put_contents("test.txt","Hello World. Testing!");?>

輸出：

26