Handle Content-Encoding, e.g. gzip'ed data

[thekid]

Currently, the following is necessary in user code:

use io\streams\GzDecompressingInputStream;

$stream= match ($r->header('Content-Encoding')) {
  'gzip'  => new GzDecompressingInputStream($r->stream()),
  default => $r->stream(),
};

// Reading from $stream will yield original data

[thekid]

We might encounter the following:

Content-Encoding: gzip
Content-Encoding: compress
Content-Encoding: deflate
Content-Encoding: br

// Multiple, in the order in which they were applied
Content-Encoding: deflate, gzip

See https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Encoding

[thekid]

Brotli would be added with xp-framework/core#307

[thekid]

...or alternatively with https://github.com/xp-forge/compression, wich has the following API:

@FileSystemCL<./src/main/php>
@FileSystemCL<./src/test/php>
package io.streams.compress {
  package io.streams.compress.unittest

  public class io.streams.compress.BrotliInputStream
  public class io.streams.compress.BrotliOutputStream
  public class io.streams.compress.Bzip2InputStream
  public class io.streams.compress.Bzip2OutputStream
  public class io.streams.compress.GzipInputStream
  public class io.streams.compress.GzipOutputStream
}

[thekid]

The HTTP deflate encoding is not supported by Apache and seems not to be widely supported by other servers:

The gzip encoding is the only one supported to ensure complete compatibility with old browser implementations. The deflate encoding is not supported, please check the zlib's documentation for a complete explanation.

Something very similar goes for compress:

The value name was taken from the UNIX compress program, which implemented this algorithm. Like the compress program, which has disappeared from most UNIX distributions, this content-encoding is not used by many browsers today, partly because of a patent issue (it expired in 2003).

We would be fine off if we support:

Content-Encoding: gzip
Content-Encoding: br

[thekid]

https://github.com/xp-forge/compression/releases/tag/v0.2.0 should not support this sufficiently

[thekid]

https://github.com/xp-forge/compression/releases/tag/v1.0.0 has been released

[thekid]

• Released in https://github.com/xp-forge/rest-client/releases/tag/v5.0.0
• Documented at https://github.com/xp-forge/rest-client#compression