HTTP Response (PSR-7)

    Phalcon\Http\Message\Stream is an implementation of the HTTP messaging interface as defined by PHP-FIG.

    This class describes a data stream. Typically, an instance will wrap a PHP stream; this interface provides a wrapper around the most common operations, including serialization of the entire stream to a string.

    Constructor

    2.     mixed $stream, 
    3.     string $mode = "rb"
    4. )

    The first parameter can be a string representing the location of the file on the file system or storage area. It can also be a resource, as returned by a method such as fopen. The second parameter is the open mode for the stream. The default mode is rb. For a list of available modes, you can check the documentation for .

    • stream - string or resource
    • mode - A string representing the mode the file is to be opened.If there is an error, a RuntimeException will be thrown.

    Getters

    Reads all data from the stream into a string, from the beginning to end. The method will first try to seek() to the beginning of the stream before reading the data and read the stream until the end is reached.

    1. <?php
    3. use Phalcon\Http\Message\Stream;
    5. $fileName = dataDir('assets/stream/mit.txt');
    7. $stream = new Stream($fileName, 'rb');
    9. echo (string) $stream; // 'The MIT License (MIT) ...'

    getContents()

    1. <?php
    3. use Phalcon\Http\Message\Stream;
    5. $fileName = dataDir('assets/stream/mit.txt');
    7. $stream = new Stream($fileName, 'rb');
    9. echo $stream->getContents(); // 'The MIT License (MIT) ...'

    Returns the stream metadata as an associative array. If the parameter $key is defined, the relevant string element will be returned. The method is a wrapper for PHP’s stream_get_meta_data() function. If the key is not found, the method will return null.

    1. <?php
    3. use Phalcon\Http\Message\Stream;
    5. $fileName = dataDir('assets/stream/mit.txt');
    7. $stream = new Stream($fileName, 'rb');
    9. var_dump(
    10.     $stream->getMetadata()
    11. );
    12. // [
    13. //     'timed_out'    => false,
    14. //     'blocked'      => true,
    15. //     'eof'          => false,
    16. //     'wrapper_type' => 'plainfile',
    17. //     'stream_type'  => 'STDIO',
    18. //     'mode'         => 'rb',
    19. //     'unread_bytes' => 0,
    20. //     'seekable'     => true,
    21. //     'uri'          => $fileName,
    22. // ];
    24. echo $stream->getMetadata('wrapper_type'); // 'plainfile'
    25. echo $stream->getMetadata('unknown');      // null

    getSize()

    Returns the size of the stream. If it is not known, null will be returned

    Is

    Returns if the stream is seekable, false otherwise.

    1. <?php
    3. use Phalcon\Http\Message\Stream;
    5. $fileName = dataDir('assets/stream/mit.txt');
    7. $stream = new Stream($fileName, 'rb');
    9. echo $stream->isSeekable(); // 'true'

    isReadable()

    Returns true if the stream is readable, false otherwise.

    1. <?php
    3. use Phalcon\Http\Message\Stream;
    5. $fileName = dataDir('assets/stream/mit.txt');
    7. $stream = new Stream($fileName, 'w');
    9. echo $stream->isReadable(); // 'false'

    Returns true if the stream is writable, false otherwise.

    1. <?php
    3. use Phalcon\Http\Message\Stream;
    5. $fileName = dataDir('assets/stream/mit.txt');
    7. $stream = new Stream($fileName, 'rb');
    9. echo $stream->isWritable(); // 'false'

    Closes the stream and any underlying resources.

    1. <?php
    3. use Phalcon\Http\Message\Stream;
    5. $fileName = dataDir('assets/stream/mit.txt');
    7. $stream = new Stream($fileName, 'rb');
    9. $stream->close();

    detach()

    eof()

    Returns true if the stream is at the end of the stream, false otherwise.

    1. <?php
    3. use Phalcon\Http\Message\Stream;
    6. $stream = new Stream($fileName, 'rb');
    8. echo $stream->eof(); // false
    10. $stream->seek(9999);

    read()

    Read data from the stream. The method accepts an integer specifying the number of bytes from the object and return them. The method could return less number of bytes than specified if the end of the stream is defined. If no more data is available an empty string will be returned. If an error occurs, a RuntimeException will be thrown.

    1. <?php
    3. use Phalcon\Http\Message\Stream;
    5. $fileName = dataDir('assets/stream/mit.txt');
    7. $stream = new Stream($fileName, 'rb');
    9. echo $stream->read(15); // 'The MIT License'

    Seek to the beginning of the stream. Uses calling seek(0) internally. If the stream is not seekable, a RuntimeException will be thrown.

    1. <?php
    3. use Phalcon\Http\Message\Stream;
    5. $fileName = dataDir('assets/stream/mit.txt');
    7. $stream = new Stream($fileName, 'rb');
    9. $stream->seek(8);
    10. echo $stream->read(7); // 'License'
    11. $stream->rewind();
    12. echo $stream->read(3); // 'The'

    seek()

    Seek to a position in the stream. Uses internally. It accepts:

    • offset - int The stream offset
    • whence - int Specifies how the cursor position will be calculated based on the seek offset. Valid values are identical to the built-in PHP $whence values for fseek().
      • SEEK_SET Set position equal to offset bytes
      • SEEK_CUR Set position to current location plus offset
      • SEEK_END Set position to end-of-stream plus offset.If an error occurs, a RuntimeException will be thrown.
    1. <?php
    3. use Phalcon\Http\Message\Stream;
    5. $fileName = dataDir('assets/stream/mit.txt');
    7. $stream = new Stream($fileName, 'rb');
    9. $stream->seek(8);
    10. echo $stream->read(7); // 'License'
    11. $stream->rewind();
    12. echo $stream->read(3); // 'The'

    tell()

    Returns the current position of the file read/write pointer as an integer. If an error occurs, a RuntimeException will be thrown.

    write()

    Write data to the stream. It accepts a string parameter as the contents to be written. The method returns the number of bytes written to the stream as an integer. If an error occurs, a RuntimeException will be thrown.

    1. <?php
    3. use Phalcon\Http\Message\Stream;
    5. $stream = new Stream('php://memory', 'wb');
    6. $source = 'The above copyright notice and this permission '
    7.         . 'notice shall be included in all copies or '
    8.         . 'substantial portions of the Software.';