Request specific options override general options which were set in the client.
-> **Note:** Only options specified prior enqueueing a request are applied to the request.
+> ***NOTE:***
+> Only options specified prior enqueueing a request are applied to the request.
## Params:
Implements Countable. Retrieve the number of enqueued requests.
-> **Note:** The enqueued requests are counted without regard whether they are finished or not.
+> ***NOTE:***
+> The enqueued requests are counted without regard whether they are finished or not.
## Params:
Simply returns the http\Message chain representing the request/response history.
-> **Note:** The history is only recorded while http\Client::$recordHistory is true.
+> ***NOTE:***
+> The history is only recorded while http\Client::$recordHistory is true.
## Params:
Retrieve the corresponding reponse of an already finished request, or the last received response if $request is not set.
-> **Note:** If $request is NULL, then the response is removed from the internal storage (stack-like operation).
+> ***NOTE:***
+> If $request is NULL, then the response is removed from the internal storage (stack-like operation).
## Params:
Set client options.
See http\Client\Curl.
-> **Note:** Only options specified prior enqueueing a request are applied to the request.
+> ***NOTE:***
+> Only options specified prior enqueueing a request are applied to the request.
## Params:
Get the currently set expires attribute.
See http\Cookie::setExpires().
-> **Note:** A return value of -1 means that the attribute is not set.
+> ***NOTE:***
+> A return value of -1 means that the attribute is not set.
## Params:
Get the currently set max-age attribute of the cookie list.
See http\Cookie::setMaxAge().
-> **Note:** A return value of -1 means that the attribute is not set.
+> ***NOTE:***
+> A return value of -1 means that the attribute is not set.
## Params:
(Re)set a cookie.
See http\Cookie::addCookie() and http\Cookie::setCookies().
-> **Note:** The cookie will be deleted from the list if $cookie_value is NULL.
+> ***NOTE:***
+> The cookie will be deleted from the list if $cookie_value is NULL.
## Params:
(Re)set an extra attribute.
See http\Cookie::addExtra().
-> **Note:** The attribute will be removed from the extras list if $extra_value is NULL.
+> ***NOTE:***
+> The attribute will be removed from the extras list if $extra_value is NULL.
## Params:
Set a custom ETag.
-> **Note:** This will be used for caching and pre-condition checks.
+> ***NOTE:***
+> This will be used for caching and pre-condition checks.
## Params:
Set a custom last modified time stamp.
-> **Note:** This will be used for caching and pre-condition checks.
+> ***NOTE:***
+> This will be used for caching and pre-condition checks.
## Params:
Enable throttling.
Send $chunk_size bytes every $delay seconds.
-> **Note:** If you need throttling by regular means, check for other options in your stack, because this method blocks the executing process/thread until the response has completely been sent.
+> ***NOTE:***
+> If you need throttling by regular means, check for other options in your stack, because this method blocks the executing process/thread until the response has completely been sent.
## Params:
Generic negotiator. For specific client negotiation see http\Env::negotiateContentType() and related methods.
-> **Note:** The first elemement of $supported serves as a default if no operand matches.
+> ***NOTE:***
+> The first elemement of $supported serves as a default if no operand matches.
## Params:
Negotiate the client's preferred character set.
-> **Note:** The first elemement of $supported character sets serves as a default if no character set matches.
+> ***NOTE:***
+> The first elemement of $supported character sets serves as a default if no character set matches.
## Params:
Negotiate the client's preferred MIME content type.
-> **Note:** The first elemement of $supported content types serves as a default if no content-type matches.
+> ***NOTE:***
+> The first elemement of $supported content types serves as a default if no content-type matches.
## Params:
Negotiate the client's preferred encoding.
-> **Note:** The first elemement of $supported encodings serves as a default if no encoding matches.
+> ***NOTE:***
+> The first elemement of $supported encodings serves as a default if no encoding matches.
## Params:
Negotiate the client's preferred language.
-> **Note:** The first elemement of $supported languages serves as a default if no language matches.
+> ***NOTE:***
+> The first elemement of $supported languages serves as a default if no language matches.
## Params:
separator, and if the header is Accept-Language respectively, a hyphen is
used instead.
-> **Note:** The first elemement of $supported serves as a default if no operand matches.
+> ***NOTE:***
+> The first elemement of $supported serves as a default if no operand matches.
## Params:
The message body, represented as a PHP (temporary) stream.
-> **Note:** Currently, http\Message\Body::addForm() creates multipart/form-data bodies.
+> ***NOTE:***
+> Currently, http\Message\Body::addForm() creates multipart/form-data bodies.
## Constants:
Add form fields and files to the message body.
-> **Note:** Currently, http\Message\Body::addForm() creates "multipart/form-data" bodies.
+> ***NOTE:***
+> Currently, http\Message\Body::addForm() creates "multipart/form-data" bodies.
## Params:
Prepend message(s) $message to this message, or the top most message of this message chain.
-> **Note:** The message chains must not overlap.
+> ***NOTE:***
+> The message chains must not overlap.
## Params:
Reverse the message chain and return the former top-most message.
-> **Note:** Message chains are ordered in reverse-parsed order by default, i.e. the last parsed message is the message you'll receive from any call parsing HTTP messages.
+> ***NOTE:***
+> Message chains are ordered in reverse-parsed order by default, i.e. the last parsed message is the message you'll receive from any call parsing HTTP messages.
>
> This call re-orders the messages of the chain and returns the message that was parsed first with any later parsed messages re-parentized.
## Example:
-> **Note:** The request URL in a request message usually only consists of the path and the querystring.
+> ***NOTE:***
+> The request URL in a request message usually only consists of the path and the querystring.
<?php
$m = new http\Message;
Set the response status code.
See http\Message::getResponseCode() and http\Message::setResponseStatus().
-> **Note:** This method also resets the response status phrase to the default for that code.
+> ***NOTE:***
+> This method also resets the response status phrase to the default for that code.
## Params:
Set additional $params to a clone of this instance.
See http\QueryString::set().
-> **Note:** This method returns a clone (copy) of this instance.
+> ***NOTE:***
+> This method returns a clone (copy) of this instance.
## Params:
Translate character encodings of the querystring with ext/iconv.
-> **Note:** This method is only available when ext/iconv support was enabled at build time.
+> ***NOTE:***
+> This method is only available when ext/iconv support was enabled at build time.
## Params: