[meeting] Migrate Meeting 2022-07-07 2100Z

/**
 * sink: (resource|string|StreamInterface) Where the data of the
 * response is written to. Defaults to a PHP temp stream. Providing a
 * string will write data to a file by the given name.
 */
const SINK = 'sink';

list($stream, $headers) = $this->checkDecode($options, $headers, $stream);
$stream = Psr7\stream_for($stream);
$sink = $stream;

if (strcasecmp('HEAD', $request->getMethod())) {
    $sink = $this->createSink($stream, $options);
}

$response = new Psr7\Response($status, $headers, $sink, $ver, $reason);

if (isset($options['on_headers'])) {
    try {
        $options['on_headers']($response);
    } catch (\Exception $e) {
        $msg = 'An error was encountered during the on_headers event';
        $ex = new RequestException($msg, $request, $response, $e);
        return \GuzzleHttp\Promise\rejection_for($ex);
    }
}

// Do not drain when the request is a HEAD request because they have
// no body.
if ($sink !== $stream) {
    $this->drain(
        $stream,
        $sink,
        $response->getHeaderLine('Content-Length')
    );
}

There’s the meat from StreamHandler::createResponse(), but the good stuff is in createSink()

private function createSink(StreamInterface $stream, array $options)
{
    if (!empty($options['stream'])) {
        return $stream;
    }

    $sink = isset($options['sink'])
        ? $options['sink']
        : fopen('php://temp', 'r+');

    return is_string($sink)
        ? new Psr7\LazyOpenStream($sink, 'w+')
        : Psr7\stream_for($sink);
}

/** * sink: (resource|string|StreamInterface) Where the data of the * response is written to. Defaults to a PHP temp stream. Providing a * string will write data to a file by the given name. */const SINK = 'sink';</td></tr>
<tr><td>mikelutz (he/him)</td><td>That’s the documentation for $options[‘sink’]

:              $stream = $response->getBody();              // Get the response body as a string. If the request is sent with
              // $options['sink'] set, then $stream is set to $options['sink'],
              // which may not be readable.

(edited)

              // Get the response body as a string. The response stream is set
              // to the sink, which defaults to a readable temp stream but can
              // be overridden by setting $options['sink'].