stream_get_contents

(PHP 5, PHP 7, PHP 8)

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

说明

stream_get_contents(resource $stream, ?int $length = null, int $offset = -1): string|false

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

参数

stream (resource): 一个资源流（例如 fopen() 操作之后返回的结果）
length (int): 需要读取的最大的字节数。默认为 null（读取全部的缓冲数据）。
offset (int): 在读取数据之前先查找指定的偏移量。如果这个数字是负数，就不进行查找，直接从当前位置开始读取。

返回值

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

更新日志

版本	说明
8.0.0	现在 `length` 可以为 null。

示例

示例 #1 stream_get_contents() 例子

<?php

if ($stream = fopen('http://www.example.com', 'r')) {
// 打印从开始的位置偏移 10 个字节后页面的所有内容
echo stream_get_contents($stream, -1, 10);

fclose($stream);
}


if ($stream = fopen('http://www.example.net', 'r')) {
// 打印前 5 个字节
echo stream_get_contents($stream, 5);

fclose($stream);
}

?>

注释

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

注意:
当指定一个非 null 的 length 值时，即使实际内容要短得多，该函数也会立即分配一个内部缓冲区，其大小为指定的长度。

参见

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

发现了问题？

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

用户贡献的备注 2 notes

down

clarck dot smith at gmail dot com ¶

13 years ago

In that case when stream_get_contents/fread/fgets or other stream reading functions block indefinitely your script because they don't reached the limit of bytes to read use the socket_get_meta_data function to figure out the number of the bytes to read. It returns an array that contains a key named 'unread_bytes' and then pass that number to your favourite stream reading functions second parameter to read from the stream.

Maybe a good workaround to use the stream_select function, and set the socket to non-blocking mode with the use of stream_set_blocking($stream, 0). In this case the socket reading functions work properly.

Cheers, Ervin

down

m rahman ¶

14 years ago

When omitting the parameter $maxlength, any received bytes are stacked up until the underlying stream is not readable anymore, the the function returns that stack in one piece.

＋添加备注

官方地址：https://www.php.net/manual/en/function.stream-get-contents.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言开发编程 Linux 科技 Elasticsearch HTML/CSS/XML 面试数据库网络 JAVA NoSQL C/C++ Golang 操作系统 Git 算法正则表达式 Redis 互联网 MySql 软件运维 JavaScript 国际架构设计 Mac OS Excel TCP/IP Windows Oracle Socket Vim VR MongoDB 运营 Python MemCache 商业硬件电子娱乐设计摄影 nginx WordPress 游戏 HTTP 团建数码电器 Docker

php7.3 使用 PDO_DM 扩展连接 DM8 中文乱码 PhpStorm中PHP注释的规范指南使用PHPWord将docx文件转换为html格式 docker-compose启动nginx与php-fpm laravel查看orm生成的sql PHPStorm ESC 会退出命令行 composer install参数 laravel orm中DB::insert方法导致内存泄漏的问题解决方法 php7 安装fileinfo扩展 adodb手册 ADORecordSet对象常用的php ADODB使用方法集锦 ADOConnection 公用函数利用php soap实现web service adodb连接mysql多个数据库的问题 mysql面试题 PHP注释规范 [PHP] inet_pton/inet_ntop IP地址转换函数 php上周一、本周一、下周一日期 PHP7添加redis扩展

略微加速

PHP官方手册 - 互联网笔记

stream_get_contents

说明

参数

返回值

更新日志

示例

注释

参见

发现了问题？

用户贡献的备注 2 notes