(PHP 5, PHP 7, PHP 8)
stream_get_contents — 讀取資源流到一個字符串
$stream
, ?int $length
= null
, int $offset
= -1): string|false
與 file_get_contents() 一樣,但是
stream_get_contents() 是對一個已經(jīng)打開的資源流進(jìn)行操作,并將其內(nèi)容寫入一個字符串返回。
返回的內(nèi)容取決于 length
字節(jié)長度和 offset
指定的起始位置。
stream
(resource)一個資源流(例如 fopen() 操作之后返回的結(jié)果)
length
(int)
需要讀取的最大的字節(jié)數(shù)。默認(rèn)為 null
(讀取全部的緩沖數(shù)據(jù))。
offset
(int)在讀取數(shù)據(jù)之前先查找指定的偏移量。如果這個數(shù)字是負(fù)數(shù),就不進(jìn)行查找,直接從當(dāng)前位置開始讀取。
返回一個字符串 或者在失敗時(shí)返回 false
.
版本 | 說明 |
---|---|
8.0.0 |
現(xiàn)在 length 可以為 null。
|
示例 #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);
}
?>
注意: 此函數(shù)可安全用于二進(jìn)制對象。