php file_put_contents 函數
file_put_contents
( PHP 5中)
file_put_contents -寫一個字符串到一個文件
描述
國際file_put_contents (字符串$文件名,混合$數據[摘要$國旗= 0 [ ,資源$背景] ] )
這一功能是相同的要求fopen ( )函數, fwrite ( )和fclose ( )先後將數據寫入一個文件。
如果文件不存在,該文件的創建。否則,現有的文件被覆蓋,除非FILE_APPEND旗幟設置。
參數
文件名
文件路徑在哪裡寫的數據。
數據
這些數據給我們寫信。可以是一個字符串,數組或流資源(上面解釋) 。
如果數據流的資源,剩下的緩沖區的流將被復制到指定的文件。這是類似使用stream_copy_to_stream ( ) 。
您還可以指定數據參數作為一個單一的層面陣列。這相當於file_put_contents ( $文件名,爆( '' , $陣列) ) 。
旗幟
國旗的價值可任意組合下列旗幟(與一些限制) ,加入的二進位或( | )操作符。
可懸掛國旗描述
FILE_USE_INCLUDE_PATH搜索文件名中包含目錄。見include_path中獲取更多信息。
FILE_APPEND如果檔案filename已經存在,附加數據的文件,而不是覆蓋它。
LOCK_EX獲得獨占鎖定的文件,同時著手寫作。
FILE_TEXT數據寫入的文字模式。如果已啟用的Unicode語義,默認字符編碼是UTF - 8 。您可以指定一個不同的編碼,建立一個自定義的范圍內或使用stream_default_encoding ( )來更改默認的。此標志不能用於FILE_BINARY 。此標志只適用於自PHP 6 。
FILE_BINARY數據將被寫入二進制模式。這是默認設置,並不能用於FILE_TEXT 。此標志只適用於自PHP 6 。
背景
資源的有效范圍內建立stream_context_create ( ) 。
返回值
該函數返回的字節數是寫入文件,或FALSE的失敗。
實例
例如# 1使用簡單的例子
$file = 'people.txt';
// Open the file to get existing content
$current = file_get_contents($file);
// Append a new person to the file
$current .= "John Smithn";
// Write the contents back to the file
file_put_contents($file, $current);
?>
$file = 'people.txt';
// The new person to add to the file
$person = "John Smithn";
// Write the contents to the file,
// using the FILE_APPEND flag to append the content to the end of the file
// and the LOCK_EX flag to prevent anyone else writing to the file at the same time
file_put_contents($file, $person, FILE_APPEND | LOCK_EX);
?>