# PHP file_get_contents() 函數 ## 定義和用法 file_get_contents() 函數把整個文件讀入一個字符串中。 和 [file()](/php/func_filesystem_file.asp "PHP file() 函數") 一樣，不同的是 file_get_contents() 把文件讀入一個字符串。 file_get_contents() 函數是用于將文件的內容讀入到一個字符串中的首選方法。如果操作系統支持，還會使用內存映射技術來增強性能。 ### 語法 ``` file_get_contents(_path_,_include_path_,_context_,_start_,_max_length_) ``` | 參數 | 描述 | | --- | --- | | path | 必需。規定要讀取的文件。 | | include_path | 可選。如果也想在 include_path 中搜尋文件的話，可以將該參數設為 "1"。 | | context | 可選。規定文件句柄的環境。context 是一套可以修改流的行為的選項。若使用 null，則忽略。 | | start | 可選。規定在文件中開始讀取的位置。該參數是 PHP 5.1 新加的。 | | max_length | 可選。規定讀取的字節數。該參數是 PHP 5.1 新加的。 | ### 說明 對 _context_ 參數的支持是 PHP 5.0.0 添加的。 ## 提示和注釋 注釋：本函數可安全用于二進制對象。 ## 例子 ``` <?php echo file_get_contents("test.txt"); ?> ``` 輸出： ``` This is a test file with test text. ```