HTTP_Client::attach()

HTTP_Client::attach() -- Adds a Listener to the list of listeners that are notified of the object's events

Synopsis

require_once 'HTTP/Client.php';

boolean HTTP_Client::attach (object HTTP_Request_Listener &$listener [, boolean $propagate = FALSE])

Description

The attached Listeners are notified of the following events:

'request'

sent before a HTTP request that is not a result of previous redirect.

'httpSuccess'

sent upon receiving a successfull 2xx response (or 3xx response, if it is not a redirect or if redirect processing is disabled).

'httpRedirect'

sent when a 3xx redirection response is received, before following a redirect

'httpError'

sent on 4xx, 5xx response

If $propagate is TRUE the Listener will be attached to the created HTTP_Request objects and will be notified of their events as well.

Parameter

object HTTP_Request_Listener &$listener

Listener instance to attach

boolean $propagate

Whether the listener should be attached to the created HTTP_Request objects

Return value

returns whether the listener was successfully attached

Throws

throws no exceptions thrown

See

see detach()

Note

This function can not be called statically.