stream_get_contents()函数—用法及示例

函数名称：stream_get_contents()

函数描述：stream_get_contents() 函数从资源流中读取指定长度的数据。

适用版本：PHP 4 >= 4.3.0, PHP 5, PHP 7

语法：stream_get_contents(resource $handle, int $length = -1, int $offset = -1) : string|false

参数：

• $handle：必需。一个有效的资源流句柄。
• $length：可选。要读取的最大字节数。默认为-1，表示读取到文件末尾。
• $offset：可选。从流的起始位置偏移的字节数。默认为-1，表示从当前位置开始读取。

返回值：

• 返回从资源流中读取的数据，如果读取失败则返回false。

示例：

// 创建一个文件资源流句柄
$handle = fopen('data.txt', 'r');

// 读取整个文件内容
$content = stream_get_contents($handle);
echo $content;

// 读取文件的前100个字节
$content = stream_get_contents($handle, 100);
echo $content;

// 从文件的第200个字节开始，读取100个字节的内容
$content = stream_get_contents($handle, 100, 200);
echo $content;

// 关闭资源流句柄
fclose($handle);

在上面的示例中，我们首先通过fopen()函数打开了一个文件资源流句柄。然后，我们使用stream_get_contents()函数来读取文件的内容。在第一个示例中，我们未指定长度和偏移量，因此函数会读取整个文件的内容。在第二个示例中，我们指定了长度为100，函数会读取文件的前100个字节。在第三个示例中，我们指定了长度为100和偏移量为200，函数会从文件的第200个字节开始读取100个字节的内容。最后，我们通过fclose()函数关闭了资源流句柄。

请注意，stream_get_contents()函数用于读取资源流的内容，并且可以用于读取文件、网络流等各种类型的资源。