PHP 手冊
後退前進


file_put_contents

(PHP 5)

file_put_contents -- 將一個字串寫入檔案

說明

int file_put_contents ( string filename, string data [, int flags [, resource context]] )

和依次呼叫 fopen()，fwrite() 以及 fclose() 功能一樣。

參數 data 可以是陣列（但不能為多維陣列），這就相當於 file_put_contents($filename, join('', $array))

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

參數

filename

要被寫入資料的檔案名。

data

要寫入的資料。類型可以是 string，array 或是是 stream 資源（如上面所說的那樣）。

flags

flags 可以是 FILE_USE_INCLUDE_PATH，FILE_APPEND 和／或 LOCK_EX（獲得一個獨佔鎖定），然而使用 FILE_USE_INCLUDE_PATH 時要特別謹慎。

context

一個 context 資源。

返回值

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

更新日誌

版本說明
5.1.0 增加了對 LOCK_EX 的支援和 data 參數處理 stream 資源的功能。

注解

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

注: 對 context 的支援是 PHP 5.0.0 增加的。有關 context 的說明見參考 CXLV, Stream Functions。

提示: 若果「fopen wrappers」已經被啟動，則在本函數中可以把 URL 作為檔案名來使用。請參閱 fopen() 函數來取得怎樣指定檔案名的詳細訊息以及支援 URL 封裝協定的清單：附錄 M。

參見

fopen()
fwrite()
file_get_contents()



後退起點前進
file_get_contents上一級file