<h2>File Contents: /home/planet5/public_html/wp-includes/php-ai-client/third-party/Nyholm/Psr7/MessageTrait.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/public_html/wp-includes/php-ai-client/third-party/Nyholm/Psr7/MessageTrait.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php

declare (strict_types=1);
namespace WordPress\AiClientDependencies\Nyholm\Psr7;

use WordPress\AiClientDependencies\Psr\Http\Message\MessageInterface;
use WordPress\AiClientDependencies\Psr\Http\Message\StreamInterface;
/**
 * Trait implementing functionality common to requests and responses.
 *
 * @author Michael Dowling and contributors to guzzlehttp/psr7
 * @author Tobias Nyholm &lt;tobias.nyholm@gmail.com&gt;
 * @author Martijn van der Ven &lt;martijn@vanderven.se&gt;
 *
 * @internal should not be used outside of Nyholm/Psr7 as it does not fall under our BC promise
 */
trait MessageTrait
{
    /** @var array Map of all registered headers, as original name =&gt; array of values */
    private $headers = [];
    /** @var array Map of lowercase header name =&gt; original name at registration */
    private $headerNames = [];
    /** @var string */
    private $protocol = &#039;1.1&#039;;
    /** @var StreamInterface|null */
    private $stream;
    public function getProtocolVersion(): string
    {
        return $this-&gt;protocol;
    }
    /**
     * @return static
     */
    public function withProtocolVersion($version): MessageInterface
    {
        if (!\is_scalar($version)) {
            throw new \InvalidArgumentException(&#039;Protocol version must be a string&#039;);
        }
        if ($this-&gt;protocol === $version) {
            return $this;
        }
        $new = clone $this;
        $new-&gt;protocol = (string) $version;
        return $new;
    }
    public function getHeaders(): array
    {
        return $this-&gt;headers;
    }
    public function hasHeader($header): bool
    {
        return isset($this-&gt;headerNames[\strtr($header, &#039;ABCDEFGHIJKLMNOPQRSTUVWXYZ&#039;, &#039;abcdefghijklmnopqrstuvwxyz&#039;)]);
    }
    public function getHeader($header): array
    {
        if (!\is_string($header)) {
            throw new \InvalidArgumentException(&#039;Header name must be an RFC 7230 compatible string&#039;);
        }
        $header = \strtr($header, &#039;ABCDEFGHIJKLMNOPQRSTUVWXYZ&#039;, &#039;abcdefghijklmnopqrstuvwxyz&#039;);
        if (!isset($this-&gt;headerNames[$header])) {
            return [];
        }
        $header = $this-&gt;headerNames[$header];
        return $this-&gt;headers[$header];
    }
    public function getHeaderLine($header): string
    {
        return \implode(&#039;, &#039;, $this-&gt;getHeader($header));
    }
    /**
     * @return static
     */
    public function withHeader($header, $value): MessageInterface
    {
        $value = $this-&gt;validateAndTrimHeader($header, $value);
        $normalized = \strtr($header, &#039;ABCDEFGHIJKLMNOPQRSTUVWXYZ&#039;, &#039;abcdefghijklmnopqrstuvwxyz&#039;);
        $new = clone $this;
        if (isset($new-&gt;headerNames[$normalized])) {
            unset($new-&gt;headers[$new-&gt;headerNames[$normalized]]);
        }
        $new-&gt;headerNames[$normalized] = $header;
        $new-&gt;headers[$header] = $value;
        return $new;
    }
    /**
     * @return static
     */
    public function withAddedHeader($header, $value): MessageInterface
    {
        if (!\is_string($header) || &#039;&#039; === $header) {
            throw new \InvalidArgumentException(&#039;Header name must be an RFC 7230 compatible string&#039;);
        }
        $new = clone $this;
        $new-&gt;setHeaders([$header =&gt; $value]);
        return $new;
    }
    /**
     * @return static
     */
    public function withoutHeader($header): MessageInterface
    {
        if (!\is_string($header)) {
            throw new \InvalidArgumentException(&#039;Header name must be an RFC 7230 compatible string&#039;);
        }
        $normalized = \strtr($header, &#039;ABCDEFGHIJKLMNOPQRSTUVWXYZ&#039;, &#039;abcdefghijklmnopqrstuvwxyz&#039;);
        if (!isset($this-&gt;headerNames[$normalized])) {
            return $this;
        }
        $header = $this-&gt;headerNames[$normalized];
        $new = clone $this;
        unset($new-&gt;headers[$header], $new-&gt;headerNames[$normalized]);
        return $new;
    }
    public function getBody(): StreamInterface
    {
        if (null === $this-&gt;stream) {
            $this-&gt;stream = Stream::create(&#039;&#039;);
        }
        return $this-&gt;stream;
    }
    /**
     * @return static
     */
    public function withBody(StreamInterface $body): MessageInterface
    {
        if ($body === $this-&gt;stream) {
            return $this;
        }
        $new = clone $this;
        $new-&gt;stream = $body;
        return $new;
    }
    private function setHeaders(array $headers): void
    {
        foreach ($headers as $header =&gt; $value) {
            if (\is_int($header)) {
                // If a header name was set to a numeric string, PHP will cast the key to an int.
                // We must cast it back to a string in order to comply with validation.
                $header = (string) $header;
            }
            $value = $this-&gt;validateAndTrimHeader($header, $value);
            $normalized = \strtr($header, &#039;ABCDEFGHIJKLMNOPQRSTUVWXYZ&#039;, &#039;abcdefghijklmnopqrstuvwxyz&#039;);
            if (isset($this-&gt;headerNames[$normalized])) {
                $header = $this-&gt;headerNames[$normalized];
                $this-&gt;headers[$header] = \array_merge($this-&gt;headers[$header], $value);
            } else {
                $this-&gt;headerNames[$normalized] = $header;
                $this-&gt;headers[$header] = $value;
            }
        }
    }
    /**
     * Make sure the header complies with RFC 7230.
     *
     * Header names must be a non-empty string consisting of token characters.
     *
     * Header values must be strings consisting of visible characters with all optional
     * leading and trailing whitespace stripped. This method will always strip such
     * optional whitespace. Note that the method does not allow folding whitespace within
     * the values as this was deprecated for almost all instances by the RFC.
     *
     * header-field = field-name &quot;:&quot; OWS field-value OWS
     * field-name   = 1*( &quot;!&quot; / &quot;#&quot; / &quot;$&quot; / &quot;%&quot; / &quot;&amp;&quot; / &quot;&#039;&quot; / &quot;*&quot; / &quot;+&quot; / &quot;-&quot; / &quot;.&quot; / &quot;^&quot;
     *              / &quot;_&quot; / &quot;`&quot; / &quot;|&quot; / &quot;~&quot; / %x30-39 / ( %x41-5A / %x61-7A ) )
     * OWS          = *( SP / HTAB )
     * field-value  = *( ( %x21-7E / %x80-FF ) [ 1*( SP / HTAB ) ( %x21-7E / %x80-FF ) ] )
     *
     * @see https://tools.ietf.org/html/rfc7230#section-3.2.4
     */
    private function validateAndTrimHeader($header, $values): array
    {
        if (!\is_string($header) || 1 !== \preg_match(&quot;@^[!#\$%&amp;&#039;*+.^_`|~0-9A-Za-z-]+\$@D&quot;, $header)) {
            throw new \InvalidArgumentException(&#039;Header name must be an RFC 7230 compatible string&#039;);
        }
        if (!\is_array($values)) {
            // This is simple, just one value.
            if (!\is_numeric($values) &amp;&amp; !\is_string($values) || 1 !== \preg_match(&quot;@^[ \t!-~\x80-\xff]*\$@&quot;, (string) $values)) {
                throw new \InvalidArgumentException(&#039;Header values must be RFC 7230 compatible strings&#039;);
            }
            return [\trim((string) $values, &quot; \t&quot;)];
        }
        if (empty($values)) {
            throw new \InvalidArgumentException(&#039;Header values must be a string or an array of strings, empty array given&#039;);
        }
        // Assert Non empty array
        $returnValues = [];
        foreach ($values as $v) {
            if (!\is_numeric($v) &amp;&amp; !\is_string($v) || 1 !== \preg_match(&quot;@^[ \t!-~\x80-\xff]*\$@D&quot;, (string) $v)) {
                throw new \InvalidArgumentException(&#039;Header values must be RFC 7230 compatible strings&#039;);
            }
            $returnValues[] = \trim((string) $v, &quot; \t&quot;);
        }
        return $returnValues;
    }
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fpublic_html%2Fwp-includes%2Fphp-ai-client%2Fthird-party%2FNyholm%2FPsr7'>⬅ Back to Directory</a>