| Methods |
final
public
|
__construct(
UriInterface|Stringable|string|null $uri = null,
Arrayable<string, string[]|string>|iterable<string, string[]|string>|null $headers = null,
string[] $sensitiveHeaders = Curler::HEADERS_SENSITIVE,
)
Parameters
| $uri |
Endpoint URI (cannot have query or fragment components)
|
| $headers |
Request headers
|
| $sensitiveHeaders |
Headers treated as sensitive
|
|
#
|
public
|
getUri(): UriInterface
Get the endpoint URI applied to the instance
Get the endpoint URI applied to the instance
Implements
|
#
|
public
|
getLastRequest(): ?RequestInterface
Get the last request sent to the endpoint or passed to middleware
Get the last request sent to the endpoint or passed to middleware
Implements
|
#
|
public
|
getLastResponse(): ?ResponseInterface
Get the last response received from the endpoint or returned by
middleware
Get the last response received from the endpoint or returned by
middleware
Implements
|
#
|
public
|
lastResponseIsJson(): bool
Check if the last response contains JSON-encoded data
Check if the last response contains JSON-encoded data
Implements
|
#
|
public
|
head(?array $query = null): HeadersInterface
Send a HEAD request to the endpoint
Send a HEAD request to the endpoint
Implements
|
#
|
public
|
get(?array $query = null)
Send a GET request to the endpoint and return the body of the response
Send a GET request to the endpoint and return the body of the response
Implements
|
#
|
public
|
post($data = null, ?array $query = null)
Send a POST request to the endpoint and return the body of the response
Send a POST request to the endpoint and return the body of the response
Implements
|
#
|
public
|
put($data = null, ?array $query = null)
Send a PUT request to the endpoint and return the body of the response
Send a PUT request to the endpoint and return the body of the response
Implements
|
#
|
public
|
patch($data = null, ?array $query = null)
Send a PATCH request to the endpoint and return the body of the response
Send a PATCH request to the endpoint and return the body of the response
Implements
|
#
|
public
|
delete($data = null, ?array $query = null)
Send a DELETE request to the endpoint and return the body of the response
Send a DELETE request to the endpoint and return the body of the response
Implements
|
#
|
public
|
getP(?array $query = null): iterable
Send a GET request to the endpoint and iterate over response pages
Send a GET request to the endpoint and iterate over response pages
Implements
|
#
|
public
|
postP($data = null, ?array $query = null): iterable
Send a POST request to the endpoint and iterate over response pages
Send a POST request to the endpoint and iterate over response pages
Implements
|
#
|
public
|
putP($data = null, ?array $query = null): iterable
Send a PUT request to the endpoint and iterate over response pages
Send a PUT request to the endpoint and iterate over response pages
Implements
|
#
|
public
|
patchP($data = null, ?array $query = null): iterable
Send a PATCH request to the endpoint and iterate over response pages
Send a PATCH request to the endpoint and iterate over response pages
Implements
|
#
|
public
|
deleteP($data = null, ?array $query = null): iterable
Send a DELETE request to the endpoint and iterate over response pages
Send a DELETE request to the endpoint and iterate over response pages
Implements
|
#
|
public
|
postR(string $data, string $mediaType, ?array $query = null)
Send raw data to the endpoint in a POST request and return the body of
the response
Send raw data to the endpoint in a POST request and return the body of
the response
Implements
|
#
|
public
|
putR(string $data, string $mediaType, ?array $query = null)
Send raw data to the endpoint in a PUT request and return the body of the
response
Send raw data to the endpoint in a PUT request and return the body of the
response
Implements
|
#
|
public
|
patchR(string $data, string $mediaType, ?array $query = null)
Send raw data to the endpoint in a PATCH request and return the body of
the response
Send raw data to the endpoint in a PATCH request and return the body of
the response
Implements
|
#
|
public
|
deleteR(string $data, string $mediaType, ?array $query = null)
Send raw data to the endpoint in a DELETE request and return the body of
the response
Send raw data to the endpoint in a DELETE request and return the body of
the response
Implements
|
#
|
public
|
flushCookies()
Invalidate cached cookies
Invalidate cached cookies
Calling this method has no effect if the instance does not handle
cookies.
Implements
|
#
|
public
|
replaceQuery($value, array $query)
Use the form data flags and date formatter applied to the instance to
replace the query string of a request or URI
Use the form data flags and date formatter applied to the instance to
replace the query string of a request or URI
Implements
|
#
|
public
|
getInnerHeaders(): HeadersInterface
Get inner headers
|
#
|
public
|
getPublicHeaders(): HeadersInterface
Get request headers that are not considered sensitive
Get request headers that are not considered sensitive
Implements
|
#
|
public
|
hasCredential(): bool
Check if the instance has a credential
Check if the instance has a credential
Implements
|
#
|
public
|
isSensitiveHeader(string $name): bool
Check if a header is considered sensitive
Check if a header is considered sensitive
Implements
|
#
|
public
|
getMediaType(): ?string
Get the media type applied to request headers
Get the media type applied to request headers
Implements
|
#
|
public
|
hasUserAgent(): bool
Check if the instance has a custom user agent string
Check if the instance has a custom user agent string
Implements
|
#
|
public
|
getUserAgent(): string
Get the user agent string applied to request headers
Get the user agent string applied to request headers
Returns the default user agent string if the instance doesn't have a
custom one.
Implements
|
#
|
public
|
expectsJson(): bool
Check if the instance explicitly accepts JSON-encoded responses and
assumes responses with no content type contain JSON
Check if the instance explicitly accepts JSON-encoded responses and
assumes responses with no content type contain JSON
Implements
|
#
|
public
|
postsJson(): bool
Check if the instance uses JSON to encode POST/PUT/PATCH/DELETE data
Check if the instance uses JSON to encode POST/PUT/PATCH/DELETE data
Implements
|
#
|
public
|
getDateFormatter(): ?DateFormatterInterface
Get the date formatter applied to the instance
Get the date formatter applied to the instance
Implements
|
#
|
public
|
getFormDataFlags(): int
Get form data flags applied to the instance
Get form data flags applied to the instance
Implements
|
#
|
public
|
getPager(): ?CurlerPagerInterface
Get the endpoint's pagination handler
Get the endpoint's pagination handler
Implements
|
#
|
public
|
alwaysPaginates(): bool
Check if the endpoint's pagination handler is used to process every
request
Check if the endpoint's pagination handler is used to process every
request
Implements
|
#
|
public
|
getCache(): ?CacheInterface
Get the endpoint's cache
|
#
|
public
|
hasCookies(): bool
Check if the instance handles cookies
Check if the instance handles cookies
Implements
|
#
|
public
|
hasResponseCache(): bool
Check if response caching is enabled
Check if response caching is enabled
Implements
|
#
|
public
|
hasPostResponseCache(): bool
Check if POST response caching is enabled
Check if POST response caching is enabled
Implements
|
#
|
public
|
getCacheLifetime(): int
Get the lifetime of cached responses, in seconds
Get the lifetime of cached responses, in seconds
Implements
|
#
|
public
|
refreshesCache(): bool
Check if the instance replaces cached responses even if they haven't
expired
Check if the instance replaces cached responses even if they haven't
expired
Implements
|
#
|
public
|
getTimeout(): ?int
Get the connection timeout applied to the instance, in seconds
Get the connection timeout applied to the instance, in seconds
Implements
|
#
|
public
|
followsRedirects(): bool
Check if the instance follows "Location" headers
Check if the instance follows "Location" headers
Implements
|
#
|
public
|
getMaxRedirects(): ?int
Get the maximum number of "Location" headers followed
Get the maximum number of "Location" headers followed
Implements
|
#
|
public
|
getRetryAfterTooManyRequests(): bool
Check if the instance retries throttled requests when the endpoint
returns a "Retry-After" header
Check if the instance retries throttled requests when the endpoint
returns a "Retry-After" header
Implements
|
#
|
public
|
getRetryAfterMaxSeconds(): int
Get the maximum delay between request attempts
Get the maximum delay between request attempts
Implements
|
#
|
public
|
throwsHttpErrors(): bool
Check if exceptions are thrown for HTTP errors
Check if exceptions are thrown for HTTP errors
Implements
|
#
|
public
|
withUri($uri)
Get an instance with the given endpoint URI
Get an instance with the given endpoint URI
Implements
|
#
|
public
|
withRequest(RequestInterface $request)
Apply the URI and headers of the given request to a copy of the instance
Apply the URI and headers of the given request to a copy of the instance
Implements
|
#
|
public
|
withCredential(?CredentialInterface $credential, string $headerName = Curler::HEADER_AUTHORIZATION)
Get an instance that applies a credential to request headers
Get an instance that applies a credential to request headers
Implements
|
#
|
public
|
withSensitiveHeader(string $name)
Get an instance that treats a header as sensitive
Get an instance that treats a header as sensitive
Headers in {@see CurlerInterface::HEADERS_SENSITIVE} are considered
sensitive by default.
Implements
|
#
|
public
|
withoutSensitiveHeader(string $name)
Get an instance that doesn't treat a header as sensitive
Get an instance that doesn't treat a header as sensitive
Implements
|
#
|
public
|
withMediaType(?string $type)
Get an instance that applies the given media type to request headers
Get an instance that applies the given media type to request headers
If $type is null (the default), Content-Type headers are
automatically applied to requests as needed.
Implements
|
#
|
public
|
withUserAgent(?string $userAgent)
Get an instance with the given user agent string
Get an instance with the given user agent string
Parameters
| $userAgent |
null (default): apply the default user
agent string to requests with no User-Agent header- empty string: do not apply
User-Agent headers to requests
- non-empty string: apply the given user agent string to requests,
replacing any existing
User-Agent headers
|
Implements
|
#
|
public
|
withExpectJson(bool $expectJson = true)
Get an instance that explicitly accepts JSON-encoded responses and
assumes responses with no content type contain JSON
Get an instance that explicitly accepts JSON-encoded responses and
assumes responses with no content type contain JSON
Implements
|
#
|
public
|
withPostJson(bool $postJson = true)
Get an instance that uses JSON to encode POST/PUT/PATCH/DELETE data
Get an instance that uses JSON to encode POST/PUT/PATCH/DELETE data
Implements
|
#
|
public
|
withDateFormatter(?DateFormatterInterface $formatter)
Get an instance that uses the given date formatter to format and parse
the endpoint's date and time values
Get an instance that uses the given date formatter to format and parse
the endpoint's date and time values
Implements
|
#
|
public
|
withFormDataFlags(int $flags)
Get an instance with the given form data flags
Get an instance with the given form data flags
Form data flags are used to encode data for query strings and message
bodies.
{@see CurlerInterface::DATA_PRESERVE_NUMERIC_KEYS} and
{@see CurlerInterface::DATA_PRESERVE_STRING_KEYS} are applied by default.
Implements
|
#
|
public
|
withJsonDecodeFlags(int $flags)
Get an instance with the given json_decode() flags
Get an instance with the given json_decode() flags
{@see \JSON_OBJECT_AS_ARRAY} is applied by default.
{@see \JSON_THROW_ON_ERROR} is always applied and cannot be disabled.
Implements
|
#
|
public
|
withMiddleware($middleware, ?string $name = null)
Get an instance with the given middleware applied to the request handler
stack
Get an instance with the given middleware applied to the request handler
stack
Implements
|
#
|
public
|
withoutMiddleware($middleware)
Get an instance where the given middleware is not applied to requests
Get an instance where the given middleware is not applied to requests
Implements
|
#
|
public
|
withPager(?CurlerPagerInterface $pager, bool $alwaysPaginate = false)
Get an instance with the given pagination handler
Get an instance with the given pagination handler
Parameters
| $alwaysPaginate |
If true, the pager is used to process
requests even if no pagination is required.
|
Implements
|
#
|
public
|
withCache(?CacheInterface $cache = null)
Get an instance with the given cache
Get an instance with the given cache
If no $cache is given, cookies and responses are stored in the global
cache as needed.
Implements
|
#
|
public
|
withCookies(?string $cacheKey = null)
Get an instance that handles cookies
Get an instance that handles cookies
Implements
|
#
|
public
|
withoutCookies()
Get an instance that does not handle cookies
Get an instance that does not handle cookies
Implements
|
#
|
public
|
withResponseCache(bool $cacheResponses = true)
Get an instance that caches responses to GET and HEAD requests
Get an instance that caches responses to GET and HEAD requests
HTTP caching headers are ignored. USE RESPONSIBLY.
Implements
|
#
|
public
|
withPostResponseCache(bool $cachePostResponses = true)
Get an instance that caches responses to repeatable POST requests
Get an instance that caches responses to repeatable POST requests
{@see withResponseCache()} must also be called to enable caching.
Implements
|
#
|
public
|
withCacheKeyCallback(?callable $callback)
Get an instance that uses a callback to generate response cache keys
Get an instance that uses a callback to generate response cache keys
The callback's return value is hashed and combined with request method
and URI to create a response cache key.
Implements
|
#
|
public
|
withCacheLifetime(int $seconds)
Get an instance where cached responses expire after the given number of
seconds
Get an instance where cached responses expire after the given number of
seconds
3600 is applied by default.
{@see withResponseCache()} must also be called to enable caching.
Parameters
| $seconds |
0: cache responses indefinitely-1: disable caching until the method is called again with $seconds
greater than or equal to 0
|
Implements
|
#
|
public
|
withRefreshCache(bool $refresh = true)
Get an instance that replaces cached responses even if they haven't
expired
Get an instance that replaces cached responses even if they haven't
expired
Implements
|
#
|
public
|
withTimeout(?int $seconds)
Get an instance with the given connection timeout
Get an instance with the given connection timeout
Parameters
| $seconds |
0: wait indefinitelynull (default): use the underlying client's default connection
timeout
|
Implements
|
#
|
public
|
withFollowRedirects(bool $follow = true)
Get an instance that follows "Location" headers
Get an instance that follows "Location" headers
Implements
|
#
|
public
|
withMaxRedirects(?int $redirects)
Get an instance that limits the number of "Location" headers followed
Get an instance that limits the number of "Location" headers followed
Parameters
| $redirects |
-1: allow unlimited redirects0: disable redirects (same effect as withFollowRedirects(false))null (default): use the underlying client's default redirect limit
|
Implements
|
#
|
public
|
withRetryAfterTooManyRequests(bool $retry = true)
Get an instance that retries throttled requests when the endpoint returns
a "Retry-After" header
Get an instance that retries throttled requests when the endpoint returns
a "Retry-After" header
Implements
|
#
|
public
|
withRetryAfterMaxSeconds(int $seconds)
Get an instance that limits the delay between request attempts
Get an instance that limits the delay between request attempts
300 is applied by default.
Parameters
| $seconds |
If 0, unlimited delays are allowed.
|
Implements
|
#
|
public
|
withThrowHttpErrors(bool $throw = true)
Get an instance that throws exceptions for HTTP errors
Get an instance that throws exceptions for HTTP errors
Implements
|
#
|
public
|
sendRequest(RequestInterface $request): ResponseInterface
Sends a PSR-7 request and returns a PSR-7 response.
Sends a PSR-7 request and returns a PSR-7 response.
Implements
|
#
|