Debian Codegraph @

vendor/guzzlehttp/psr7/src/DroppingStream.php

raw
1 <?php
2
3 declare(strict_types=1);
4
5 namespace GuzzleHttp\Psr7;
6
7 use Psr\Http\Message\StreamInterface;
8
9 /**
10 * Stream decorator that begins dropping data once the size of the underlying
11 * stream becomes too full.
12 */
13 final class DroppingStream implements StreamInterface
14 {
15 use StreamDecoratorTrait;
16
17 /** @var int */
18 private $maxLength;
19
20 /** @var StreamInterface */
21 private $stream;
22
23 /**
24 * @param StreamInterface $stream Underlying stream to decorate.
25 * @param int $maxLength Maximum size before dropping data.
26 */
27 public function __construct(StreamInterface $stream, int $maxLength)
28 {
29 $this->stream = $stream;
30 $this->maxLength = $maxLength;
31 }
32
33 public function write($string): int
34 {
35 if (!\is_string($string)) {
36 \trigger_deprecation(
37 'guzzlehttp/psr7',
38 '2.11',
39 'Passing %s to StreamInterface::write() is deprecated; guzzlehttp/psr7 3.0 requires string for $string.',
40 \get_debug_type($string)
41 );
42 }
43
44 $diff = $this->maxLength - $this->stream->getSize();
45
46 // Begin returning 0 when the underlying stream is too large.
47 if ($diff <= 0) {
48 return 0;
49 }
50
51 // Write the stream or a subset of the stream if needed.
52 if (strlen($string) < $diff) {
53 return $this->stream->write($string);
54 }
55
56 return $this->stream->write(substr($string, 0, $diff));
57 }
58 }