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