Creates a new Request_Client object, allows for dependency injection.

Sends the HTTP message Request to a remote server and processes the response.

Processes the request, executing the controller action that handles this request, determined by the Route.

1. Before the controller action is called, the Controller::before method will be called.
2. Next the controller action will be called.
3. After the controller action is called, the Controller::after method will be called.

By default, the output from the controller is captured and returned, and no headers are sent.

$request->execute();

Factory method to create a new Request_Client_External object based on the client name passed, or defaulting to Request_Client_External::$client by default.

Request_Client_External::$client can be set in the application bootstrap.

Set and get options for this request.

Assigns the properties of the current Request_Client to another Request_Client instance - used when setting up a subsequent request.

Getter and setter for the internal caching engine, used to cache responses if available and valid.

Getter/Setter for the callback depth property, which is used to track how many recursions have been executed within the current request execution.

Getter/Setter for the callback_params array, which allows additional application-specific parameters to be shared with callbacks.

As with other Kohana setter/getters, usage is:

// Set full array
$client->callback_params(array('foo'=>'bar'));

// Set single key
$client->callback_params('foo','bar');

// Get full array
$params = $client->callback_params();

// Get single key
$foo = $client->callback_params('foo');

Processes the request, executing the controller action that handles this request, determined by the Route.

1. Before the controller action is called, the Controller::before method will be called.
2. Next the controller action will be called.
3. After the controller action is called, the Controller::after method will be called.

By default, the output from the controller is captured and returned, and no headers are sent.

$request->execute();

Getter and setter for the follow redirects setting.

Getter and setter for the follow redirects headers array.

Getter and setter for the header callbacks array.

Accepts an array with HTTP response headers as keys and a PHP callback function as values. These callbacks will be triggered if a response contains the given header and can either issue a subsequent request or manipulate the response as required.

By default, the Request_Client::on_header_location callback is assigned to the Location header to support automatic redirect following.

$client->header_callbacks(array(
    'Location' => 'Request_Client::on_header_location',
    'WWW-Authenticate' => function($request, $response, $client) {return $new_response;},
);

Getter and setter for the maximum callback depth property.

This protects the main execution from recursive callback execution (eg following infinite redirects, conflicts between callbacks causing loops etc). Requests will only be allowed to nest to the level set by this param before execution is aborted with a Request_Client_Recursion_Exception.

The default handler for following redirects, triggered by the presence of a Location header in the response.

The client's follow property must be set TRUE and the HTTP response status one of 201, 301, 302, 303 or 307 for the redirect to be followed.

Getter and setter for the strict redirects setting

HTTP/1.1 specifies that a 302 redirect should be followed using the original request method. However, the vast majority of clients and servers get this wrong, with 302 widely used for 'POST - 302 redirect - GET' patterns. By default, Kohana's client is fully compliant with the HTTP spec. Some non-compliant third party sites may require that strict_redirect is set FALSE to force the client to switch to GET following a 302 response.