Exception classes for HTTP response status codes.

Source files:

• wp-includes/Requests/src/Exception/Http.php
• wp-includes/Requests/src/Exception/Http/Status*.php
• wp-includes/Requests/src/Exception/Http/StatusUnknown.php

WpOrgRequestsExceptionHttp

Base class for HTTP status code exceptions.

Namespace: WpOrgRequestsException
Package: RequestsExceptions
Extends: WpOrgRequestsException

Properties

Methods

__construct()

public function __construct( string|null $reason = null, mixed $data = null )

If $reason is provided, overrides the default. Formats the parent message as "{code} {reason}" and sets the parent type to 'httpresponse'.

getReason()

public function getReason(): string

Returns the reason phrase.

get_class()

Get the appropriate exception class for an HTTP status code.

public static function get_class( int|bool $code ): string

Returns: Fully qualified class name. Returns StatusUnknown::class if $code is falsy or no matching Status{code} class exists.

WpOrgRequestsExceptionHttpStatusUnknown

Exception for unknown/unrecognized HTTP status codes.

Extends: WpOrgRequestsExceptionHttp
Modifier: final

__construct()

public function __construct( string|null $reason = null, mixed $data = null )

If $data is an instance of WpOrgRequestsResponse, sets $code from $data->status_code. Then calls the parent constructor.

HTTP Status Exception Classes

All classes below are final, extend WpOrgRequestsExceptionHttp, and override only $code and $reason. They inherit the constructor and all methods from the base class.

3xx Redirection

4xx Client Errors

5xx Server Errors

Special

Usage

// Get the right exception class for a status code
$class = WpOrgRequestsExceptionHttp::get_class(404);
// Returns 'WpOrgRequestsExceptionHttpStatus404'

// Throw with custom reason
throw new WpOrgRequestsExceptionHttpStatus404('Resource not found', $response);

// Unknown status codes
$class = WpOrgRequestsExceptionHttp::get_class(999);
// Returns 'WpOrgRequestsExceptionHttpStatusUnknown'