利用file_get_contents函数读取整个文件

file_get_contents函数是 PHP 内置的函数之一，它能够读取整个文件并将其返回为字符串。它通常用在从文件读取数据的地方，而且在处理大量数据的方式上表现出色，适用于不仅限于读取文本文件，还包括读取二进制文件等。

file_get_contents函数常见的用法有两个参数，第一个参数是文件路径，第二个参数是读取模式。常见的读取模式包括'stream_context'，'use_include_path'和'offset'，其中最常用的是'file_get_contents($filename, $use_include_path= FALSE, $stream_context= NULL, $offset = -1, $maxlen = NULL)'

$file = file_get_contents('example.txt'); 

echo  $file; 

上面的代码允许我们打开 example.txt 文件，并将其内容读取到 $file 变量中。这个例子不涉及到第二个和第三个参数。下面我们来看看这些参数的具体意义。

1. $filename

这个参数表明要打开的文件名或文件的 URL。它可以是相对路径或绝对路径，也可以是一个 URL 地址。如果文件存在，PHP 将会读取文件的完整内容，否则将会返回一个错误。

如果文件是一个 URL 地址，这样读取文件可能需要使用其他协议来处理。例如：

$file = file_get_contents('http://www.example.com/');

这样做可以打开 www.example.com 上的网页，读取页面的 HTML 内容并将其以字符串的形式返回。

2. $use_include_path

该参数可选，默认为 FALSE。如果设置为 TRUE，则在 include_path 指定的路径中查找文件。如果还需要访问包含路径，该选项会很有用。如果你想从多个目录中查找文件并从中读取，这是一个很好的选择。

例如：

$file = file_get_contents( 'example.txt', true );

这是一种尝试在 include_path 中查找 example.txt 文件的方法。

3. $stream_context

该参数可选，指定了将要使用的上下文流。这个参数允许你对流的某些方面进行更全面的控制。通过设置这个参数，你可以更细致地控制打开一个 URL、文件或 socket 连接的不同的属性。

例如：

$ctx = stream_context_create(array(

   'http' => array(

       'timeout' => 10 // 超时时间为 10 秒

   )

));

$file = file_get_contents('http://www.example.com/', false, $ctx);

这种方法使用了 $ctx 参数，它指示代码在试图打开 URL 时，应该使用的上下文流。

4. $offset

可选参数，假如设置为非负整数，文件指针将会偏移该偏移量字节开始读取。如果想跳过文件中的前几个字节或者只想从一个文件的中途开始读取，这个参数会很有用。如果 $offset 大于文件大小或者小于 0，则会报错。

例如：

$file = file_get_contents( 'example.txt', false, NULL, 10 );

这种方法使用了 $offset 参数，它偏移 10 个字节从样本文件开始读取了内容。

5. $maxlen

可选参数，指定从文件中读入的最大字节数。默认情况下，文件的完整内容将被读取。指定 $maxlen 参数可以读取文件的部分内容，而不是完全读入。如果 $maxlen 值超过文件大小，则将返回整个文件。

例如：

$file = file_get_contents( 'example.txt', false, NULL, -1, 100 );

这种方法不仅使用了 $offset 参数，指定了在样本文件的第 10 个字节处读取其余内容， 还使用了 $maxlen 参数将读入的内容长度限制为 100 个字节以内。