stream_get_contents

(PHP 5, PHP 7)

stream_get_contents — 读取资源流到一个字符串

说明

stream_get_contents ( resource $handle [, int $maxlength = -1 [, int $offset = -1 ]] ) : string

与 file_get_contents() 一样，但是 stream_get_contents() 是对一个已经打开的资源流进行操作，并将其内容写入一个字符串返回。 返回的内容取决于 maxlength 字节长度和 offset 指定的起始位置。

参数

handle ( resource)

一个资源流（例如 fopen() 操作之后返回的结果）

maxlength ( integer)

需要读取的最大的字节数。默认是-1（读取全部的缓冲数据）。

offset ( integer)

在读取数据之前先查找指定的偏移量。如果这个数字是负数，就不进行查找，直接从当前位置开始读取。

返回值

返回一个字符串 或者在失败时返回 FALSE.

更新日志

版本 说明
5.1.0 增加参数 offset 。

范例

Example #1 stream_get_contents() 例子

<?php

if ($stream = fopen('http://www.example.com', 'r')) {
    // print all the page starting at the offset 10
    echo stream_get_contents($stream, -1, 10);

    fclose($stream);
}


if ($stream = fopen('http://www.example.net', 'r')) {
    // print the first 5 bytes
    echo stream_get_contents($stream, 5);

    fclose($stream);
}

?>

注释

Note: 此函数可安全用于二进制对象。

参见

  • fgets() - 从文件指针中读取一行
  • fread() - 读取文件（可安全用于二进制文件）
  • fpassthru() - 输出文件指针处的所有剩余数据

相关文章
php 多字节字符串 函数 为 mime 头编码字符串php 多字节字符串 函数 获取 mbstring 的内部设置php 多字节字符串 函数 获取按指定宽度截断的字符串php 字符串 函数 将字符串解析成多个变量php 字符串 函数 输出格式化字符串php readline 函数 当一个行被接收时读取一个字符并且通知 readline 调用回调函数php 字符串 函数 return a formatted stringphp stream 函数 return a bucket object from the brigade for operating onphp stream 函数 创建资源流上下文php stream 函数 对资源流、数据包或者上下文设置参数php stream 函数 从资源流里移除某个过滤器php stream 函数 读取资源流到一个字符串php stream 函数 获取已注册的数据流过滤器列表php stream 函数 从资源流里读取一行直到给定的定界符php stream 函数 为资源流设置阻塞或者阻塞模式php stream 函数 设置资源流区块大小php stream 函数 接受由 stream socket server 创建的套接字连接php 字符串 函数 查找字符串首次出现的位置（不区分大小写）php 字符串 函数 查找字符串的首次出现php 多字节字符串 函数重载功能
关注编程学问公众号