Final Class Yiisoft\ResponseDownload\ByteRangeStream

                public function __construct(
    private readonly StreamInterface $stream,
    private readonly int $start,
    int $end,
) {
    if ($start < 0 || $end < $start) {
        throw new RuntimeException('Invalid byte range.');
    }
    if (!$stream->isSeekable()) {
        throw new RuntimeException('Stream is not seekable.');
    }
    if (!$stream->isReadable()) {
        throw new RuntimeException('Stream is not readable.');
    }
    $this->size = $end - $start + 1;
    $this->stream->seek($start);
}

            

                public function __toString(): string
{
    try {
        $this->rewind();
        return $this->getContents();
    } catch (Throwable) {
        return '';
    }
}

            

                public function close(): void
{
    $this->stream->close();
}

            

                public function detach()
{
    return $this->stream->detach();
}

            

                public function eof(): bool
{
    return $this->position >= $this->size || $this->stream->eof();
}

            

                public function getContents(): string
{
    $contents = [];
    while (!$this->eof()) {
        $chunk = $this->read(8192);
        if ($chunk === '') {
            break;
        }
        $contents[] = $chunk;
    }
    return implode('', $contents);
}

            

                public function getMetadata(?string $key = null)
{
    return $this->stream->getMetadata($key);
}

            

                public function getSize(): ?int
{
    return $this->size;
}

            

                public function isReadable(): bool
{
    return true;
}

            

                public function isSeekable(): bool
{
    return true;
}

            

                public function isWritable(): bool
{
    return false;
}

            

                public function read(int $length): string
{
    if ($length < 0) {
        throw new RuntimeException('Length parameter cannot be negative.');
    }
    if ($length === 0 || $this->eof()) {
        return '';
    }
    $remaining = $this->size - $this->position;
    $contents = $this->stream->read(min($length, $remaining));
    $this->position += strlen($contents);
    return $contents;
}

            

                public function rewind(): void
{
    $this->seek(0);
}

            

                public function seek(int $offset, int $whence = SEEK_SET): void
{
    $position = match ($whence) {
        SEEK_SET => $offset,
        SEEK_CUR => $this->position + $offset,
        SEEK_END => $this->size + $offset,
        default => throw new RuntimeException('Invalid seek mode.'),
    };
    if ($position < 0 || $position > $this->size) {
        throw new RuntimeException('Invalid seek offset.');
    }
    $this->stream->seek($this->start + $position);
    $this->position = $position;
}

            

                public function tell(): int
{
    return $this->position;
}

            

                public function write(string $string): int
{
    throw new RuntimeException('Stream is not writable.');
}