PHP Doku:: Reads remainder of a stream into a string - function.stream-get-contents.html

Verlauf / Chronik / History: (1) anzeigen

Sie sind hier:
Doku-StartseitePHP-HandbuchFunktionsreferenzSonstige GrunderweiterungenStreamsStream Funktionenstream_get_contents

Ein Service von Reinhard Neidl - Webprogrammierung.

Stream Funktionen

<<stream_filter_remove

stream_get_filters>>

stream_get_contents

(PHP 5)

stream_get_contentsReads remainder of a stream into a string

Beschreibung

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

Identical to file_get_contents(), except that stream_get_contents() operates on an already open stream resource and returns the remaining contents in a string, up to maxlength bytes and starting at the specified offset.

Parameter-Liste

handle (resource)

A stream resource (e.g. returned from fopen())

maxlength (integer)

The maximum bytes to read. Defaults to -1 (read all the remaining buffer).

offset (integer)

Seek to the specified offset before reading. If this number is negative, no seeking will occur and reading will start from the current position.

Rückgabewerte

Returns a stringIm Fehlerfall wird FALSE zurückgegeben..

Changelog

Version Beschreibung
5.1.0 The offset was added.

Beispiele

Beispiel #1 stream_get_contents() example

<?php

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

    
fclose($stream);
}


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

    
fclose($stream);
}

?>

Anmerkungen

Hinweis: Diese Funktion ist binary safe.

Siehe auch

  • fgets() - Liest eine Zeile von der Position des Dateizeigers
  • fread() - Liest Binärdaten aus einer Datei
  • fpassthru() - Gibt alle verbleibenden Daten eines Dateizeigers direkt aus.


2 BenutzerBeiträge:
- Beiträge aktualisieren...
finalmau at gmail dot com
30.04.2008 1:28
some times this functions cause an max execution time time error, Why?

Simple, if you use it the function wait for have the specified byte  length into the resource or the end of file, but, several times this not happend, so we need implement an artificial flag like this:

$tmp = stream_get_contents($this->socket, 42);
while($tmp[42] != 'N'){

//Your code...

$tmp = stream_get_contents($this->socket, 42);
}
Jim Keller
28.08.2006 10:04
Per wez (at php.net), "the trick is to tell the recipient how big the packet is, so that it can read the correct length."

In my own experience, when using PHP streams to send data bursts, the "max length" parameter seems to act more as an exact length parameter, as the stream will block indefinitely until max length is reached or until the other side fcloses() the stream. The latter is ok unless you need to keep the stream open to continue communication, in which case you have to let the receiving end know how much data to expect, or it will block indefinitely if the max length of data is not sent. You need to pack() and prepend the length of the outgoing data stream in the first 4 bytes of the packet, as follows:

function send_pkt($stream, $my_data)
{

   $len = strlen($my_data);

   $send_data = pack('N', $len) . $my_data; //Pack the length in a network-friendly way, then prepend it to the data.

   $final_len = strlen($send_data);

   if ( fwrite($stream, $send_data) < $final_len ) {
                   //something went wrong, trigger error
   }
}

function recv_pkt($stream)
{

   $packed_len = stream_get_contents($stream, 4); //The first 4 bytes contain our N-packed length
   $hdr = unpack('Nlen', $packed_len);
   $len = $hdr['len'];
   $recvd_data = stream_get_contents($stream, $len);

   return $recvd_data;

}



PHP Powered Diese Seite bei php.net
The PHP manual text and comments are covered by the Creative Commons Attribution 3.0 License © the PHP Documentation Group - Impressum - mail("TO:Reinhard Neidl",...)