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