# 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 可避免刪除文件中已有的內容。 注釋：本函數可安全用于二進制對象。 ## 例子 ``` <?php echo file_put_contents("test.txt","Hello World. Testing!"); ?> ``` 輸出： ``` 26 ```