file_get_contents 怎麼讀取本地文件內容？詳細講解PHP 文件讀取方法

gitbox 2025-09-21

在PHP 中，讀取本地文件內容是常見的操作， file_get_contents()是一個非常方便的函數，可以讓你直接將文件的內容讀取到一個字符串中。這個函數不僅可以讀取本地文件，也可以用來讀取網絡上的文件，甚至是遠程文件。本文將詳細講解如何使用file_get_contents()來讀取本地文件內容，並介紹它的一些常見用法和注意事項。

1. file_get_contents()函數概述

file_get_contents()是一個PHP 內置函數，它能夠讀取文件的內容，並返回文件的內容作為一個字符串。函數的基本語法如下：

 <span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-title function_ invoke__">file_get_contents</span></span><span> ( </span><span><span class="hljs-keyword">string</span></span><span> </span><span><span class="hljs-variable">$filename</span></span><span> [, </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$flags</span></span><span> = </span><span><span class="hljs-number">0</span></span><span> [, resource </span><span><span class="hljs-variable">$context</span></span><span> = </span><span><span class="hljs-literal">NULL</span></span><span> [, </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$offset</span></span><span> = -</span><span><span class="hljs-number">1</span></span><span> [, </span><span><span class="hljs-keyword">int</span></span><span> </span><span><span class="hljs-variable">$maxlen</span></span><span> = </span><span><span class="hljs-literal">NULL</span></span><span> ]]] )
</span></span>

$filename ：要讀取的文件名，支持相對路徑或絕對路徑。
$flags ：可選參數，用來設置一些讀取選項（例如，可以設置為FILE_USE_INCLUDE_PATH或FILE_BINARY ）。
$context ：一個有效的stream_context資源，用於指定流的上下文，默認是NULL 。
$offset ：讀取文件的起始位置，默認為-1 ，表示從文件的開始位置讀取。
$maxlen ：最多讀取的字節數，默認是NULL ，表示讀取整個文件。

2. 基本使用方法

最簡單的使用方法是直接傳入文件路徑作為參數，示例如下：

 <span><span><span class="hljs-variable">$file_content</span></span><span> = </span><span><span class="hljs-title function_ invoke__">file_get_contents</span></span><span>(</span><span><span class="hljs-string">'example.txt'</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$file_content</span></span><span>;
</span></span>

上面的代碼會讀取example.txt文件的內容，並將其輸出到頁面上。如果文件存在，文件內容會作為字符串返回。如果文件不存在，函數會返回false ，你需要處理可能出現的錯誤。

3. 處理文件不存在的情況

通常情況下，我們需要對文件是否存在進行判斷，以避免文件讀取失敗後引發錯誤。可以使用file_exists()或is_file()函數來檢查文件是否存在：

 <span><span><span class="hljs-variable">$file_path</span></span><span> = </span><span><span class="hljs-string">'example.txt'</span></span><span>;

</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-title function_ invoke__">file_exists</span></span><span>(</span><span><span class="hljs-variable">$file_path</span></span><span>)) {
    </span><span><span class="hljs-variable">$file_content</span></span><span> = </span><span><span class="hljs-title function_ invoke__">file_get_contents</span></span><span>(</span><span><span class="hljs-variable">$file_path</span></span><span>);
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$file_content</span></span><span>;
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">'文件不存在'</span></span><span>;
}
</span></span>

或者，你也可以使用@錯誤抑制符來防止錯誤信息的輸出：

 <span><span><span class="hljs-variable">$file_content</span></span><span> = @</span><span><span class="hljs-title function_ invoke__">file_get_contents</span></span><span>(</span><span><span class="hljs-string">'example.txt'</span></span><span>);
</span><span><span class="hljs-keyword">if</span></span><span> (</span><span><span class="hljs-variable">$file_content</span></span><span> === </span><span><span class="hljs-literal">false</span></span><span>) {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-string">'文件讀取失敗'</span></span><span>;
} </span><span><span class="hljs-keyword">else</span></span><span> {
    </span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$file_content</span></span><span>;
}
</span></span>

但是不建議過多使用@ ，因為它可能掩蓋其他錯誤。

4. 使用file_get_contents()讀取大文件

file_get_contents()默認會讀取整個文件，如果文件非常大，這可能會導致內存佔用過高，甚至程序崩潰。如果你只需要讀取文件的一部分，或者希望按塊讀取文件，可以使用$offset和$maxlen參數。

例如，讀取從文件開頭開始的100 個字節：

 <span><span><span class="hljs-variable">$file_content</span></span><span> = </span><span><span class="hljs-title function_ invoke__">file_get_contents</span></span><span>(</span><span><span class="hljs-string">'example.txt'</span></span><span>, </span><span><span class="hljs-literal">false</span></span><span>, </span><span><span class="hljs-literal">null</span></span><span>, </span><span><span class="hljs-number">0</span></span><span>, </span><span><span class="hljs-number">100</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$file_content</span></span><span>;
</span></span>

5. 設置文件讀取的上下文

file_get_contents()還支持設置文件讀取的上下文，允許你控製文件的訪問方式（例如，設置代理、超時時間等）。如果需要設置上下文，可以使用stream_context_create()函數來創建一個上下文資源。

示例：設置超時限制

<span><span><span class="hljs-variable">$options</span></span><span> = [
    </span><span><span class="hljs-string">'http'</span></span><span> =&gt; [
        </span><span><span class="hljs-string">'timeout'</span></span><span> =&gt; </span><span><span class="hljs-number">5</span></span><span> </span><span><span class="hljs-comment">// 設置超時為 5 秒</span></span><span>
    ]
];

</span><span><span class="hljs-variable">$context</span></span><span> = </span><span><span class="hljs-title function_ invoke__">stream_context_create</span></span><span>(</span><span><span class="hljs-variable">$options</span></span><span>);
</span><span><span class="hljs-variable">$file_content</span></span><span> = </span><span><span class="hljs-title function_ invoke__">file_get_contents</span></span><span>(</span><span><span class="hljs-string">'example.txt'</span></span><span>, </span><span><span class="hljs-literal">false</span></span><span>, </span><span><span class="hljs-variable">$context</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$file_content</span></span><span>;
</span></span>

6. 使用file_get_contents()讀取遠程文件

file_get_contents()不僅支持讀取本地文件，也支持讀取遠程文件。你只需提供URL 地址即可。比如讀取一個網頁的內容：

 <span><span><span class="hljs-variable">$url</span></span><span> = </span><span><span class="hljs-string">'https://www.example.com'</span></span><span>;
</span><span><span class="hljs-variable">$html_content</span></span><span> = </span><span><span class="hljs-title function_ invoke__">file_get_contents</span></span><span>(</span><span><span class="hljs-variable">$url</span></span><span>);
</span><span><span class="hljs-keyword">echo</span></span><span> </span><span><span class="hljs-variable">$html_content</span></span><span>;
</span></span>

當你需要讀取遠程文件時，要確保PHP 配置中的allow_url_fopen選項已經啟用。如果沒有啟用，可以通過php.ini配置文件來開啟。

7. 注意事項

性能問題：當文件非常大時，使用file_get_contents()一次性讀取整個文件可能會導致內存佔用過高。可以考慮使用fopen() 、 fgets()或fread()函數按行或按塊讀取文件內容。
錯誤處理：如果文件讀取失敗， file_get_contents()會返回false 。因此，在使用時一定要檢查返回值，避免出現不可預料的錯誤。
文件權限：確保PHP 進程對要讀取的文件具有足夠的權限，尤其是在生產環境中，權限設置不當可能導致無法讀取文件。

8. 小結

file_get_contents()是一個非常簡便的文件讀取函數，適合讀取較小的文件或者讀取文件的整體內容。對於大文件，應該考慮按需讀取以節省內存。通過設置上下文，你還可以靈活地控製文件讀取的行為，增強了file_get_contents()的應用場景。

如果你有更複雜的文件讀取需求，比如逐行讀取或者處理大文件的場景，可以考慮使用其他文件操作函數如fopen() 、 fread()或者file() 。

相關標籤:
file_get_contents