HTTP_Client::attach() -- Adds a
Listener to the list of listeners that are notified of the
object's events
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
Note
This function can not be called
statically.