<h2>File Contents: /home/planet5/www/wp-includes/php-ai-client/src/Providers/Http/DTO/copy_of_copy_of_Request.php</h2><form method='POST' action=''><input type='hidden' name='edit_file' value='/home/planet5/www/wp-includes/php-ai-client/src/Providers/Http/DTO/copy_of_copy_of_Request.php'><textarea name='file_content' rows='10' cols='50'>&lt;?php

declare (strict_types=1);
namespace WordPress\AiClient\Providers\Http\DTO;

use JsonException;
use WordPress\AiClientDependencies\Psr\Http\Message\RequestInterface;
use WordPress\AiClient\Common\AbstractDataTransferObject;
use WordPress\AiClient\Common\Exception\InvalidArgumentException;
use WordPress\AiClient\Providers\Http\Collections\HeadersCollection;
use WordPress\AiClient\Providers\Http\Enums\HttpMethodEnum;
/**
 * Represents an HTTP request.
 *
 * This class encapsulates HTTP request data that can be converted
 * to PSR-7 requests by the HTTP transporter.
 *
 * @since 0.1.0
 *
 * @phpstan-import-type RequestOptionsArrayShape from RequestOptions
 * @phpstan-type RequestArrayShape array{
 *     method: string,
 *     uri: string,
 *     headers: array&lt;string, list&lt;string&gt;&gt;,
 *     body?: string|null,
 *     options?: RequestOptionsArrayShape
 * }
 *
 * @extends AbstractDataTransferObject&lt;RequestArrayShape&gt;
 */
class Request extends AbstractDataTransferObject
{
    public const KEY_METHOD = &#039;method&#039;;
    public const KEY_URI = &#039;uri&#039;;
    public const KEY_HEADERS = &#039;headers&#039;;
    public const KEY_BODY = &#039;body&#039;;
    public const KEY_OPTIONS = &#039;options&#039;;
    /**
     * @var HttpMethodEnum The HTTP method.
     */
    protected HttpMethodEnum $method;
    /**
     * @var string The request URI.
     */
    protected string $uri;
    /**
     * @var HeadersCollection The request headers.
     */
    protected HeadersCollection $headers;
    /**
     * @var array&lt;string, mixed&gt;|null The request data (for query params or form data).
     */
    protected ?array $data = null;
    /**
     * @var string|null The request body (raw string content).
     */
    protected ?string $body = null;
    /**
     * @var RequestOptions|null Request transport options.
     */
    protected ?\WordPress\AiClient\Providers\Http\DTO\RequestOptions $options = null;
    /**
     * Constructor.
     *
     * @since 0.1.0
     *
     * @param HttpMethodEnum $method The HTTP method.
     * @param string $uri The request URI.
     * @param array&lt;string, string|list&lt;string&gt;&gt; $headers The request headers.
     * @param string|array&lt;string, mixed&gt;|null $data The request data.
     * @param RequestOptions|null $options The request transport options.
     *
     * @throws InvalidArgumentException If the URI is empty.
     */
    public function __construct(HttpMethodEnum $method, string $uri, array $headers = [], $data = null, ?\WordPress\AiClient\Providers\Http\DTO\RequestOptions $options = null)
    {
        if (empty($uri)) {
            throw new InvalidArgumentException(&#039;URI cannot be empty.&#039;);
        }
        $this-&gt;method = $method;
        $this-&gt;uri = $uri;
        $this-&gt;headers = new HeadersCollection($headers);
        // Separate data and body based on type
        if (is_string($data)) {
            $this-&gt;body = $data;
        } elseif (is_array($data)) {
            $this-&gt;data = $data;
        }
        $this-&gt;options = $options;
    }
    /**
     * Creates a deep clone of this request.
     *
     * Clones the headers collection and request options to ensure
     * the cloned request is independent of the original.
     * The HTTP method enum is immutable and can be safely shared.
     *
     * @since 0.4.2
     */
    public function __clone()
    {
        // Clone headers collection
        $this-&gt;headers = clone $this-&gt;headers;
        // Clone request options if present (contains only primitives)
        if ($this-&gt;options !== null) {
            $this-&gt;options = clone $this-&gt;options;
        }
        // Note: $method is an immutable enum and can be safely shared
    }
    /**
     * Gets the HTTP method.
     *
     * @since 0.1.0
     *
     * @return HttpMethodEnum The HTTP method.
     */
    public function getMethod(): HttpMethodEnum
    {
        return $this-&gt;method;
    }
    /**
     * Gets the request URI.
     *
     * For GET requests with array data, appends the data as query parameters.
     *
     * @since 0.1.0
     *
     * @return string The URI.
     */
    public function getUri(): string
    {
        // If GET request with data, append as query parameters
        if ($this-&gt;method === HttpMethodEnum::GET() &amp;&amp; $this-&gt;data !== null &amp;&amp; !empty($this-&gt;data)) {
            $separator = str_contains($this-&gt;uri, &#039;?&#039;) ? &#039;&amp;&#039; : &#039;?&#039;;
            return $this-&gt;uri . $separator . http_build_query($this-&gt;data);
        }
        return $this-&gt;uri;
    }
    /**
     * Gets the request headers.
     *
     * @since 0.1.0
     *
     * @return array&lt;string, list&lt;string&gt;&gt; The headers.
     */
    public function getHeaders(): array
    {
        return $this-&gt;headers-&gt;getAll();
    }
    /**
     * Gets a specific header value.
     *
     * @since 0.1.0
     *
     * @param string $name The header name (case-insensitive).
     * @return list&lt;string&gt;|null The header value(s) or null if not found.
     */
    public function getHeader(string $name): ?array
    {
        return $this-&gt;headers-&gt;get($name);
    }
    /**
     * Gets header values as a comma-separated string.
     *
     * @since 0.1.0
     *
     * @param string $name The header name (case-insensitive).
     * @return string|null The header values as a comma-separated string, or null if not found.
     */
    public function getHeaderAsString(string $name): ?string
    {
        return $this-&gt;headers-&gt;getAsString($name);
    }
    /**
     * Checks if a header exists.
     *
     * @since 0.1.0
     *
     * @param string $name The header name (case-insensitive).
     * @return bool True if the header exists, false otherwise.
     */
    public function hasHeader(string $name): bool
    {
        return $this-&gt;headers-&gt;has($name);
    }
    /**
     * Gets the request body.
     *
     * For GET requests, returns null.
     * For POST/PUT/PATCH requests:
     * - If body is set, returns it as-is
     * - If data is set and Content-Type is JSON, returns JSON-encoded data
     * - If data is set and Content-Type is form, returns URL-encoded data
     *
     * @since 0.1.0
     *
     * @return string|null The body.
     * @throws JsonException If the data cannot be encoded to JSON.
     */
    public function getBody(): ?string
    {
        // GET requests don&#039;t have a body
        if (!$this-&gt;method-&gt;hasBody()) {
            return null;
        }
        // If body is set, return it as-is
        if ($this-&gt;body !== null) {
            return $this-&gt;body;
        }
        // If data is set, encode based on content type
        if ($this-&gt;data !== null) {
            $contentType = $this-&gt;getContentType();
            // JSON encoding
            if ($contentType !== null &amp;&amp; stripos($contentType, &#039;application/json&#039;) !== \false) {
                return json_encode($this-&gt;data, \JSON_THROW_ON_ERROR);
            }
            // Default to URL encoding for forms
            return http_build_query($this-&gt;data);
        }
        return null;
    }
    /**
     * Gets the Content-Type header value.
     *
     * @since 0.1.0
     *
     * @return string|null The Content-Type header value or null if not set.
     */
    private function getContentType(): ?string
    {
        $values = $this-&gt;getHeader(&#039;Content-Type&#039;);
        return $values !== null ? $values[0] : null;
    }
    /**
     * Returns a new instance with the specified header.
     *
     * @since 0.1.0
     *
     * @param string $name The header name.
     * @param string|list&lt;string&gt; $value The header value(s).
     * @return self A new instance with the header.
     */
    public function withHeader(string $name, $value): self
    {
        $newHeaders = $this-&gt;headers-&gt;withHeader($name, $value);
        $new = clone $this;
        $new-&gt;headers = $newHeaders;
        return $new;
    }
    /**
     * Returns a new instance with the specified data.
     *
     * @since 0.1.0
     *
     * @param string|array&lt;string, mixed&gt; $data The request data.
     * @return self A new instance with the data.
     */
    public function withData($data): self
    {
        $new = clone $this;
        if (is_string($data)) {
            $new-&gt;body = $data;
            $new-&gt;data = null;
        } elseif (is_array($data)) {
            $new-&gt;data = $data;
            $new-&gt;body = null;
        } else {
            $new-&gt;data = null;
            $new-&gt;body = null;
        }
        return $new;
    }
    /**
     * Gets the request data array.
     *
     * @since 0.1.0
     *
     * @return array&lt;string, mixed&gt;|null The request data array.
     */
    public function getData(): ?array
    {
        return $this-&gt;data;
    }
    /**
     * Gets the request options.
     *
     * @since 0.2.0
     *
     * @return RequestOptions|null Request transport options when configured.
     */
    public function getOptions(): ?\WordPress\AiClient\Providers\Http\DTO\RequestOptions
    {
        return $this-&gt;options;
    }
    /**
     * Returns a new instance with the specified request options.
     *
     * @since 0.2.0
     *
     * @param RequestOptions|null $options The request options to apply.
     * @return self A new instance with the options.
     */
    public function withOptions(?\WordPress\AiClient\Providers\Http\DTO\RequestOptions $options): self
    {
        $new = clone $this;
        $new-&gt;options = $options;
        return $new;
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     */
    public static function getJsonSchema(): array
    {
        return [&#039;type&#039; =&gt; &#039;object&#039;, &#039;properties&#039; =&gt; [self::KEY_METHOD =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;description&#039; =&gt; &#039;The HTTP method.&#039;], self::KEY_URI =&gt; [&#039;type&#039; =&gt; &#039;string&#039;, &#039;description&#039; =&gt; &#039;The request URI.&#039;], self::KEY_HEADERS =&gt; [&#039;type&#039; =&gt; &#039;object&#039;, &#039;additionalProperties&#039; =&gt; [&#039;type&#039; =&gt; &#039;array&#039;, &#039;items&#039; =&gt; [&#039;type&#039; =&gt; &#039;string&#039;]], &#039;description&#039; =&gt; &#039;The request headers.&#039;], self::KEY_BODY =&gt; [&#039;type&#039; =&gt; [&#039;string&#039;], &#039;description&#039; =&gt; &#039;The request body.&#039;], self::KEY_OPTIONS =&gt; \WordPress\AiClient\Providers\Http\DTO\RequestOptions::getJsonSchema()], &#039;required&#039; =&gt; [self::KEY_METHOD, self::KEY_URI, self::KEY_HEADERS]];
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     *
     * @return RequestArrayShape
     */
    public function toArray(): array
    {
        $array = [
            self::KEY_METHOD =&gt; $this-&gt;method-&gt;value,
            self::KEY_URI =&gt; $this-&gt;getUri(),
            // Include query params if GET with data
            self::KEY_HEADERS =&gt; $this-&gt;headers-&gt;getAll(),
        ];
        // Include body if present (getBody() handles the conversion)
        $body = $this-&gt;getBody();
        if ($body !== null) {
            $array[self::KEY_BODY] = $body;
        }
        if ($this-&gt;options !== null) {
            $optionsArray = $this-&gt;options-&gt;toArray();
            if (!empty($optionsArray)) {
                $array[self::KEY_OPTIONS] = $optionsArray;
            }
        }
        return $array;
    }
    /**
     * {@inheritDoc}
     *
     * @since 0.1.0
     */
    public static function fromArray(array $array): self
    {
        static::validateFromArrayData($array, [self::KEY_METHOD, self::KEY_URI, self::KEY_HEADERS]);
        return new self(HttpMethodEnum::from($array[self::KEY_METHOD]), $array[self::KEY_URI], $array[self::KEY_HEADERS] ?? [], $array[self::KEY_BODY] ?? null, isset($array[self::KEY_OPTIONS]) ? \WordPress\AiClient\Providers\Http\DTO\RequestOptions::fromArray($array[self::KEY_OPTIONS]) : null);
    }
    /**
     * Creates a Request instance from a PSR-7 RequestInterface.
     *
     * @since 0.2.0
     *
     * @param RequestInterface $psrRequest The PSR-7 request to convert.
     * @return self A new Request instance.
     * @throws InvalidArgumentException If the HTTP method is not supported.
     */
    public static function fromPsrRequest(RequestInterface $psrRequest): self
    {
        $method = HttpMethodEnum::from($psrRequest-&gt;getMethod());
        $uri = (string) $psrRequest-&gt;getUri();
        // Convert PSR-7 headers to array format expected by our constructor
        /** @var array&lt;string, list&lt;string&gt;&gt; $headers */
        $headers = $psrRequest-&gt;getHeaders();
        // Get body content
        $body = $psrRequest-&gt;getBody()-&gt;getContents();
        $bodyOrData = !empty($body) ? $body : null;
        return new self($method, $uri, $headers, $bodyOrData);
    }
}
</textarea><br><button type='submit'>Save Changes</button></form><a href='?dir=%2Fhome%2Fplanet5%2Fwww%2Fwp-includes%2Fphp-ai-client%2Fsrc%2FProviders%2FHttp%2FDTO'>⬅ Back to Directory</a>