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.