3 <title>Function Summary of ext/http
</title>
7 font-family: sans-serif;
34 border:
1px solid #ccc;
71 <body><h1 id=
"http_functions.c">http_functions.c
</h1>
72 <h2 id=
"http_date">string http_date([int timestamp])
</h2>
73 <p>Compose a valid HTTP date regarding RFC
1123<br />
74 looking like:
"Wed, 22 Dec 2004 11:34:47 GMT"</p>
75 <p>Accepts an optional unix timestamp as parameter.
</p>
76 <p>Returns the HTTP date as string.
</p>
77 <h2 id=
"http_build_url">string http_build_url([mixed url[, mixed parts[, int flags = HTTP_URL_REPLACE[, array &new_url]]]])
</h2>
79 <p>Expexts (part(s) of) an URL as first parameter in form of a string or assoziative array
<br />
80 like parse_url() returns. Accepts an optional second parameter in the same way as the
<br />
81 first argument. Accepts an optional third integer parameter, which is a bitmask of
<br />
82 binary or'ed HTTP_URL_* constants. The optional fourth parameter will be filled
<br />
83 with the results as associative array like parse_url() would return.
</p>
84 <p>The parts of the second URL will be merged into the first according to the flags argument.
<br />
85 The following flags are recognized:
</p><pre> - HTTP_URL_REPLACE: (default) set parts of the second url will replace the parts in the first
<br />
86 - HTTP_URL_JOIN_PATH: the path of the second url will be merged into the one of the first
<br />
87 - HTTP_URL_JOIN_QUERY: the two querystrings will be merged recursively
<br />
88 - HTTP_URL_STRIP_USER: the user part will not appear in the result
<br />
89 - HTTP_URL_STRIP_PASS: the password part will not appear in the result
<br />
90 - HTTP_URL_STRIP_AUTH: neither the user nor the password part will appear in the result
<br />
91 - HTTP_URL_STRIP_PORT: no explicit port will be set in the result
<br />
92 - HTTP_URL_STRIP_PATH: the path part will not appear in the result
<br />
93 - HTTP_URL_STRIP_QUERY: no query string will be present in the result
<br />
94 - HTTP_URL_STRIP_FRAGMENT: no fragment will be present in the result
<br />
96 <p>Example:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
97 <span style=
"color: #0000BB"><?php
<br /> </span><span style=
"color: #FF8000">//
ftp://ftp.example.com/pub/files/current/?a=b
&a=c
<br /> </span><span style=
"color: #007700">echo
</span><span style=
"color: #0000BB">http_build_url
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">"http://user@www.example.com/pub/index.php?a=b#files"</span><span style=
"color: #007700">,
<br /> array(
<br /> </span><span style=
"color: #DD0000">"scheme" </span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">"ftp"</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">"host" </span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">"ftp.example.com"</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">"path" </span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">"files/current/"</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">"query" </span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">"a=c"<br /> </span><span style=
"color: #007700">),
<br /> </span><span style=
"color: #0000BB">HTTP_URL_STRIP_AUTH
</span><span style=
"color: #007700">|
</span><span style=
"color: #0000BB">HTTP_URL_JOIN_PATH
</span><span style=
"color: #007700">|
</span><span style=
"color: #0000BB">HTTP_URL_JOIN_QUERY
</span><span style=
"color: #007700">|
</span><span style=
"color: #0000BB">HTTP_URL_STRIP_FRAGMENT
<br /> </span><span style=
"color: #007700">);
<br /></span><span style=
"color: #0000BB">?
></span><br />
98 </span></code></blockquote></p>
100 Returns the new URL as string on success or FALSE on failure.
</p>
101 <h2 id=
"http_build_str">string http_build_str(array query [, string prefix[, string arg_separator]])
</h2>
102 <p>Opponent to parse_str().
</p>
103 <p>Expects an array as first argument which represents the parts of the query string to build.
<br />
104 Accepts a string as optional second parameter containing a top-level prefix to use.
<br />
105 The optional third parameter should specify an argument separator to use (by default the
<br />
106 INI setting arg_separator.output will be used, or
"&" if neither is set).
</p>
107 <p>Returns the built query as string on success or FALSE on failure.
</p>
108 <h2 id=
"http_negotiate_language">string http_negotiate_language(array supported[, array &result])
</h2>
109 <p>This function negotiates the clients preferred language based on its
<br />
110 Accept-Language HTTP header. The qualifier is recognized and languages
<br />
111 without qualifier are rated highest. The qualifier will be decreased by
<br />
112 10% for partial matches (i.e. matching primary language).
</p>
113 <p>Expects an array as parameter containing the supported languages as values.
<br />
114 If the optional second parameter is supplied, it will be filled with an
<br />
115 array containing the negotiation results.
</p>
116 <p>Returns the negotiated language or the default language (i.e. first array entry)
<br />
118 <p>Example:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
119 <span style=
"color: #0000BB"><?php
<br />$langs
</span><span style=
"color: #007700">=
array(
<br /> </span><span style=
"color: #DD0000">'en-US'
</span><span style=
"color: #007700">,
</span><span style=
"color: #FF8000">//
default
<br /> </span><span style=
"color: #DD0000">'fr'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'fr-FR'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'de'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'de-DE'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'de-AT'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'de-CH'
</span><span style=
"color: #007700">,
<br />);
<br /><br />include
</span><span style=
"color: #DD0000">'./langs/'
</span><span style=
"color: #007700">.
</span><span style=
"color: #0000BB">http_negotiate_language
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">$langs
</span><span style=
"color: #007700">,
</span><span style=
"color: #0000BB">$result
</span><span style=
"color: #007700">)
.
</span><span style=
"color: #DD0000">'.php'
</span><span style=
"color: #007700">;
<br /><br /></span><span style=
"color: #0000BB">print_r
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">$result
</span><span style=
"color: #007700">);
<br /></span><span style=
"color: #0000BB">?
></span><br />
120 </span></code></blockquote></p>
122 <h2 id=
"http_negotiate_charset">string http_negotiate_charset(array supported[, array &result])
</h2>
123 <p>This function negotiates the clients preferred charset based on its
<br />
124 Accept-Charset HTTP header. The qualifier is recognized and charsets
<br />
125 without qualifier are rated highest.
</p>
126 <p>Expects an array as parameter containing the supported charsets as values.
<br />
127 If the optional second parameter is supplied, it will be filled with an
<br />
128 array containing the negotiation results.
</p>
129 <p>Returns the negotiated charset or the default charset (i.e. first array entry)
<br />
131 <p>Example:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
132 <span style=
"color: #0000BB"><?php
<br />$charsets
</span><span style=
"color: #007700">=
array(
<br /> </span><span style=
"color: #DD0000">'iso-
8859-
1'
</span><span style=
"color: #007700">,
</span><span style=
"color: #FF8000">//
default
<br /> </span><span style=
"color: #DD0000">'iso-
8859-
2'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'iso-
8859-
15'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'utf-
8'
<br /></span><span style=
"color: #007700">);
<br /><br /></span><span style=
"color: #0000BB">$pref
</span><span style=
"color: #007700">=
</span><span style=
"color: #0000BB">http_negotiate_charset
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">$charsets
</span><span style=
"color: #007700">,
</span><span style=
"color: #0000BB">$result
</span><span style=
"color: #007700">);
<br /><br />if
(
</span><span style=
"color: #0000BB">strcmp
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">$pref
</span><span style=
"color: #007700">,
</span><span style=
"color: #DD0000">'iso-
8859-
1'
</span><span style=
"color: #007700">))
{
<br /> </span><span style=
"color: #0000BB">iconv_set_encoding
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">'internal_encoding'
</span><span style=
"color: #007700">,
</span><span style=
"color: #DD0000">'iso-
8859-
1'
</span><span style=
"color: #007700">);
<br /> </span><span style=
"color: #0000BB">iconv_set_encoding
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">'output_encoding'
</span><span style=
"color: #007700">,
</span><span style=
"color: #0000BB">$pref
</span><span style=
"color: #007700">);
<br /> </span><span style=
"color: #0000BB">ob_start
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">'ob_iconv_handler'
</span><span style=
"color: #007700">);
<br />}
<br /><br /></span><span style=
"color: #0000BB">print_r
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">$result
</span><span style=
"color: #007700">);
<br /></span><span style=
"color: #0000BB">?
></span><br />
133 </span></code></blockquote></p>
135 <h2 id=
"http_negotiate_content_type">string http_negotiate_ctype(array supported[, array &result])
</h2>
136 <p>This function negotiates the clients preferred content type based on its
<br />
137 Accept HTTP header. The qualifier is recognized and content types
<br />
138 without qualifier are rated highest.
</p>
139 <p>Expects an array as parameter containing the supported content types as values.
<br />
140 If the optional second parameter is supplied, it will be filled with an
<br />
141 array containing the negotiation results.
</p>
142 <p>Returns the negotiated content type or the default content type
<br />
143 (i.e. first array entry) if none match.
</p>
144 <p>Example:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
145 <span style=
"color: #0000BB"><?php
<br />$ctypes
</span><span style=
"color: #007700">=
array(
</span><span style=
"color: #DD0000">'application/xhtml+xml'
</span><span style=
"color: #007700">,
</span><span style=
"color: #DD0000">'text/html'
</span><span style=
"color: #007700">);
<br /></span><span style=
"color: #0000BB">http_send_content_type
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">http_negotiate_content_type
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">$ctypes
</span><span style=
"color: #007700">));
<br /></span><span style=
"color: #0000BB">?
></span><br />
146 </span></code></blockquote></p>
148 <h2 id=
"http_send_status">bool http_send_status(int status)
</h2>
149 <p>Send HTTP status code.
</p>
150 <p>Expects an HTTP status code as parameter.
</p>
151 <p>Returns TRUE on success or FALSE on failure.
</p>
152 <h2 id=
"http_send_last_modified">bool http_send_last_modified([int timestamp])
</h2>
153 <p>Send a
"Last-Modified" header with a valid HTTP date.
</p>
154 <p>Accepts a unix timestamp, converts it to a valid HTTP date and
<br />
155 sends it as
"Last-Modified" HTTP header. If timestamp is
<br />
156 omitted, the current time will be sent.
</p>
157 <p>Returns TRUE on success or FALSE on failure.
</p>
158 <h2 id=
"http_send_content_type">bool http_send_content_type([string content_type = 'application/x-octetstream'])
</h2>
159 <p>Send the Content-Type of the sent entity. This is particularly important
<br />
160 if you use the http_send() API.
</p>
161 <p>Accepts an optional string parameter containing the desired content type
<br />
162 (primary/secondary).
</p>
163 <p>Returns TRUE on success or FALSE on failure.
</p>
164 <h2 id=
"http_send_content_disposition">bool http_send_content_disposition(string filename[, bool inline = false])
</h2>
165 <p>Send the Content-Disposition. The Content-Disposition header is very useful
<br />
166 if the data actually sent came from a file or something similar, that should
<br />
167 be
"saved" by the client/user (i.e. by browsers
"Save as..." popup window).
</p>
168 <p>Expects a string parameter specifying the file name the
"Save as..." dialog
<br />
169 should display. Optionally accepts a bool parameter, which, if set to true
<br />
170 and the user agent knows how to handle the content type, will probably not
<br />
171 cause the popup window to be shown.
</p>
172 <p>Returns TRUE on success or FALSE on failure.
</p>
173 <h2 id=
"http_match_modified">bool http_match_modified([int timestamp[, bool for_range = false]])
</h2>
174 <p>Matches the given unix timestamp against the clients
"If-Modified-Since" <br />
175 resp.
"If-Unmodified-Since" HTTP headers.
</p>
176 <p>Accepts a unix timestamp which should be matched. Optionally accepts an
<br />
177 additional bool parameter, which if set to true will check the header
<br />
178 usually used to validate HTTP ranges. If timestamp is omitted, the
<br />
179 current time will be used.
</p>
180 <p>Returns TRUE if timestamp represents an earlier date than the header,
<br />
182 <h2 id=
"http_match_etag">bool http_match_etag(string etag[, bool for_range = false])
</h2>
183 <p>Matches the given ETag against the clients
"If-Match" resp.
<br />
184 "If-None-Match" HTTP headers.
</p>
185 <p>Expects a string parameter containing the ETag to compare. Optionally
<br />
186 accepts a bool parameter, which, if set to true, will check the header
<br />
187 usually used to validate HTTP ranges.
</p>
188 <p>Returns TRUE if ETag matches or the header contained the asterisk (
"*"),
<br />
190 <h2 id=
"http_cache_last_modified">bool http_cache_last_modified([int timestamp_or_expires]])
</h2>
191 <p>Attempts to cache the sent entity by its last modification date.
</p>
192 <p>Accepts a unix timestamp as parameter which is handled as follows:
</p>
193 <p>If timestamp_or_expires is greater than
0, it is handled as timestamp
<br />
194 and will be sent as date of last modification. If it is
0 or omitted,
<br />
195 the current time will be sent as Last-Modified date. If it's negative,
<br />
196 it is handled as expiration time in seconds, which means that if the
<br />
197 requested last modification date is not between the calculated timespan,
<br />
198 the Last-Modified header is updated and the actual body will be sent.
</p>
199 <p>Returns FALSE on failure, or *exits* with
"304 Not Modified" if the entity is cached.
</p>
200 <p>A log entry will be written to the cache log if the INI entry
<br />
201 http.log.cache is set and the cache attempt was successful.
</p>
202 <h2 id=
"http_cache_etag">bool http_cache_etag([string etag])
</h2>
203 <p>Attempts to cache the sent entity by its ETag, either supplied or generated
<br />
204 by the hash algorithm specified by the INI setting
"http.etag.mode".
</p>
205 <p>If the clients
"If-None-Match" header matches the supplied/calculated
<br />
206 ETag, the body is considered cached on the clients side and
<br />
207 a
"304 Not Modified" status code is issued.
</p>
208 <p>Returns FALSE on failure, or *exits* with
"304 Not Modified" if the entity is cached.
</p>
209 <p>A log entry is written to the cache log if the INI entry
<br />
210 "http.log.cache" is set and the cache attempt was successful.
</p>
211 <h2 id=
"ob_etaghandler">string ob_etaghandler(string data, int mode)
</h2>
212 <p>For use with ob_start(). Output buffer handler generating an ETag with
<br />
213 the hash algorithm specified with the INI setting
"http.etag.mode".
</p>
214 <h2 id=
"http_throttle">void http_throttle(double sec[, int bytes =
40960])
</h2>
215 <p>Sets the throttle delay and send buffer size for use with http_send() API.
<br />
216 Provides a basic throttling mechanism, which will yield the current process
<br />
217 resp. thread until the entity has been completely sent, though.
</p>
218 <p>Expects a double parameter specifying the seconds too sleep() after
<br />
219 each chunk sent. Additionally accepts an optional int parameter
<br />
220 representing the chunk size in bytes.
</p>
221 <p>Example:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
222 <span style=
"color: #0000BB"><?php
<br /></span><span style=
"color: #FF8000">//
~
20 kbyte/s
<br />#
http_throttle(
1,
20000);
<br />#
http_throttle(
0.5,
10000);
<br />#
http_throttle(
0.1,
2000);
<br /></span><span style=
"color: #0000BB">http_send_file
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">'document.pdf'
</span><span style=
"color: #007700">);
<br /></span><span style=
"color: #0000BB">?
></span><br />
223 </span></code></blockquote></p>
225 <h2 id=
"http_redirect">void http_redirect([string url[, array params[, bool session = false[, int status =
302]]]])
</h2>
226 <p>Redirect to the given url.
<br />
228 The supplied url will be expanded with http_build_url(), the params array will
<br />
229 be treated with http_build_query() and the session identification will be appended
<br />
230 if session is true.
</p>
231 <p>The HTTP response code will be set according to status.
<br />
232 You can use one of the following constants for convenience:
<br />
233 - HTTP_REDIRECT
302 Found for GET/HEAD, else
303 See Other
<br />
234 - HTTP_REDIRECT_PERM
301 Moved Permanently
<br />
235 - HTTP_REDIRECT_FOUND
302 Found
<br />
236 - HTTP_REDIRECT_POST
303 See Other
<br />
237 - HTTP_REDIRECT_PROXY
305 Use Proxy
<br />
238 - HTTP_REDIRECT_TEMP
307 Temporary Redirect
</p>
239 <p>Please see http://www.w3.org/Protocols/rfc2616/rfc2616-sec10.html#sec10.3
<br />
240 for which redirect response code to use in which situation.
</p>
241 <p>To be RFC compliant,
"Redirecting to <a>URL</a>." will be displayed,
<br />
242 if the client doesn't redirect immediately, and the request method was
<br />
243 another one than HEAD.
</p>
244 <p>Returns FALSE on failure, or *exits* on success.
</p>
245 <p>A log entry will be written to the redirect log, if the INI entry
<br />
246 "http.log.redirect" is set and the redirect attempt was successful.
</p>
247 <h2 id=
"http_send_data">bool http_send_data(string data)
</h2>
248 <p>Sends raw data with support for (multiple) range requests.
</p>
249 <p>Returns TRUE on success, or FALSE on failure.
</p>
250 <h2 id=
"http_send_file">bool http_send_file(string file)
</h2>
251 <p>Sends a file with support for (multiple) range requests.
</p>
252 <p>Expects a string parameter referencing the file to send.
</p>
253 <p>Returns TRUE on success, or FALSE on failure.
</p>
254 <h2 id=
"http_send_stream">bool http_send_stream(resource stream)
</h2>
255 <p>Sends an already opened stream with support for (multiple) range requests.
</p>
256 <p>Expects a resource parameter referencing the stream to read from.
</p>
257 <p>Returns TRUE on success, or FALSE on failure.
</p>
258 <h2 id=
"http_chunked_decode">string http_chunked_decode(string encoded)
</h2>
259 <p>Decodes a string that was HTTP-chunked encoded.
</p>
260 <p>Expects a chunked encoded string as parameter.
</p>
261 <p>Returns the decoded string on success or FALSE on failure.
</p>
262 <h2 id=
"http_parse_message">object http_parse_message(string message)
</h2>
263 <p>Parses (a) http_message(s) into a simple recursive object structure.
</p>
264 <p>Expects a string parameter containing a single HTTP message or
<br />
265 several consecutive HTTP messages.
</p>
266 <p>Returns an hierarchical object structure of the parsed messages.
</p>
267 <p>Example:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
268 <span style=
"color: #0000BB"><?php
<br />print_r
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">http_parse_message
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">http_get
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">URL
</span><span style=
"color: #007700">,
array(
</span><span style=
"color: #DD0000">'redirect'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">3</span><span style=
"color: #007700">)));
<br /><br /></span><span style=
"color: #0000BB">stdClass
object
<br /></span><span style=
"color: #007700">(
<br /> [
</span><span style=
"color: #0000BB">type
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">2<br /> </span><span style=
"color: #007700">[
</span><span style=
"color: #0000BB">httpVersion
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">1.1<br /> </span><span style=
"color: #007700">[
</span><span style=
"color: #0000BB">responseCode
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">200<br /> </span><span style=
"color: #007700">[
</span><span style=
"color: #0000BB">headers
</span><span style=
"color: #007700">]
=
> Array
<br /> (
<br /> [
</span><span style=
"color: #0000BB">Content
</span><span style=
"color: #007700">-
</span><span style=
"color: #0000BB">Length
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">3<br /> </span><span style=
"color: #007700">[
</span><span style=
"color: #0000BB">Server
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">Apache
<br /> </span><span style=
"color: #007700">)
<br /> [
</span><span style=
"color: #0000BB">body
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">Hi
</span><span style=
"color: #007700">!
<br /> [
</span><span style=
"color: #0000BB">parentMessage
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">stdClass
object
<br /> </span><span style=
"color: #007700">(
<br /> [
</span><span style=
"color: #0000BB">type
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">2<br /> </span><span style=
"color: #007700">[
</span><span style=
"color: #0000BB">httpVersion
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">1.1<br /> </span><span style=
"color: #007700">[
</span><span style=
"color: #0000BB">responseCode
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">302<br /> </span><span style=
"color: #007700">[
</span><span style=
"color: #0000BB">headers
</span><span style=
"color: #007700">]
=
> Array
<br /> (
<br /> [
</span><span style=
"color: #0000BB">Content
</span><span style=
"color: #007700">-
</span><span style=
"color: #0000BB">Length
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">0<br /> </span><span style=
"color: #007700">[
</span><span style=
"color: #0000BB">Location
</span><span style=
"color: #007700">]
=
> ...
<br /> )
<br /> [
</span><span style=
"color: #0000BB">body
</span><span style=
"color: #007700">]
=
> <br /> [
</span><span style=
"color: #0000BB">parentMessage
</span><span style=
"color: #007700">]
=
> ...
<br /> )
<br />)
<br /></span><span style=
"color: #0000BB">?
></span><br />
269 </span></code></blockquote></p>
271 <h2 id=
"http_parse_headers">array http_parse_headers(string header)
</h2>
272 <p>Parses HTTP headers into an associative array.
</p>
273 <p>Expects a string parameter containing HTTP headers.
</p>
274 <p>Returns an array on success, or FALSE on failure.
</p>
275 <p>Example:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
276 <span style=
"color: #0000BB"><?php
<br />$headers
</span><span style=
"color: #007700">=
</span><span style=
"color: #DD0000">"content-type: text/html; charset=UTF-8\r\n"</span><span style=
"color: #007700">.
<br /> </span><span style=
"color: #DD0000">"Server: Funky/1.0\r\n"</span><span style=
"color: #007700">.
<br /> </span><span style=
"color: #DD0000">"Set-Cookie: foo=bar\r\n"</span><span style=
"color: #007700">.
<br /> </span><span style=
"color: #DD0000">"Set-Cookie: baz=quux\r\n"</span><span style=
"color: #007700">.
<br /> </span><span style=
"color: #DD0000">"Folded: works\r\n\ttoo\r\n"</span><span style=
"color: #007700">;
<br /></span><span style=
"color: #0000BB">print_r
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">http_parse_headers
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">$headers
</span><span style=
"color: #007700">));
<br /><br />Array
<br />(
<br /> [
</span><span style=
"color: #0000BB">Content
</span><span style=
"color: #007700">-
</span><span style=
"color: #0000BB">Type
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">text
</span><span style=
"color: #007700">/
</span><span style=
"color: #0000BB">html
</span><span style=
"color: #007700">;
</span><span style=
"color: #0000BB">chatset
</span><span style=
"color: #007700">=
</span><span style=
"color: #0000BB">UTF
</span><span style=
"color: #007700">-
</span><span style=
"color: #0000BB">8<br /> </span><span style=
"color: #007700">[
</span><span style=
"color: #0000BB">Server
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">Funky
</span><span style=
"color: #007700">/
</span><span style=
"color: #0000BB">1.0<br /> </span><span style=
"color: #007700">[
</span><span style=
"color: #0000BB">Set
</span><span style=
"color: #007700">-
</span><span style=
"color: #0000BB">Cookie
</span><span style=
"color: #007700">]
=
> Array
<br /> (
<br /> [
</span><span style=
"color: #0000BB">0</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">foo
</span><span style=
"color: #007700">=
</span><span style=
"color: #0000BB">bar
<br /> </span><span style=
"color: #007700">[
</span><span style=
"color: #0000BB">1</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">baz
</span><span style=
"color: #007700">=
</span><span style=
"color: #0000BB">quux
<br /> </span><span style=
"color: #007700">)
<br /> [
</span><span style=
"color: #0000BB">Folded
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">works
<br /> too
<br /></span><span style=
"color: #007700">)
<br /></span><span style=
"color: #0000BB">?
></span><br />
277 </span></code></blockquote></p>
279 <h2 id=
"http_parse_cookie">object http_parse_cookie(string cookie[, int flags[, array allowed_extras]])
</h2>
280 <p>Parses HTTP cookies like sent in a response into a struct.
</p>
281 <p>Expects a string as parameter containing the value of a Set-Cookie response header.
</p>
282 <p>Returns an stdClass olike shown in the example on success or FALSE on failure.
</p>
283 <p>Example:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
284 <span style=
"color: #0000BB"><?php
<br />print_r
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">http_parse_cookie
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">"foo=bar; bar=baz; path=/; domain=example.com; comment=; secure"</span><span style=
"color: #007700">,
</span><span style=
"color: #0000BB">0</span><span style=
"color: #007700">,
array(
</span><span style=
"color: #DD0000">"comment"</span><span style=
"color: #007700">)));
<br /><br /></span><span style=
"color: #0000BB">stdClass
Object
<br /></span><span style=
"color: #007700">(
<br /> [
</span><span style=
"color: #0000BB">cookies
</span><span style=
"color: #007700">]
=
> Array
<br /> (
<br /> [
</span><span style=
"color: #0000BB">foo
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">bar
<br /> </span><span style=
"color: #007700">[
</span><span style=
"color: #0000BB">bar
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">baz
<br /> </span><span style=
"color: #007700">)
<br /><br /> [
</span><span style=
"color: #0000BB">extras
</span><span style=
"color: #007700">]
=
> Array
<br /> (
<br /> [
</span><span style=
"color: #0000BB">comment
</span><span style=
"color: #007700">]
=
><br /> )
<br /><br /> [
</span><span style=
"color: #0000BB">flags
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">16<br /> </span><span style=
"color: #007700">[
</span><span style=
"color: #0000BB">expires
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">0<br /> </span><span style=
"color: #007700">[
</span><span style=
"color: #0000BB">path
</span><span style=
"color: #007700">]
=
> /
<br /> [
</span><span style=
"color: #0000BB">domain
</span><span style=
"color: #007700">]
=
> </span><span style=
"color: #0000BB">example
</span><span style=
"color: #007700">.
</span><span style=
"color: #0000BB">com
<br /></span><span style=
"color: #007700">)
<br /></span><span style=
"color: #0000BB">?
></span><br />
285 </span></code></blockquote></p>
287 <h2 id=
"http_parse_params">object http_parse_params(string param[, int flags = HTTP_PARAMS_DEFAULT])
</h2>
288 <p>Parse parameter list.
</p>
289 <h2 id=
"http_get_request_headers">array http_get_request_headers(void)
</h2>
290 <p>Get a list of incoming HTTP headers.
</p>
291 <p>Returns an associative array of incoming request headers.
</p>
292 <h2 id=
"http_get_request_body">string http_get_request_body(void)
</h2>
293 <p>Get the raw request body (e.g. POST or PUT data).
</p>
294 <p>This function can not be used after http_get_request_body_stream()
<br />
295 if the request method was another than POST.
</p>
296 <p>Returns the raw request body as string on success or NULL on failure.
</p>
297 <h2 id=
"http_get_request_body_stream">resource http_get_request_body_stream(void)
</h2>
298 <p>Create a stream to read the raw request body (e.g. POST or PUT data).
</p>
299 <p>This function can only be used once if the request method was another than POST.
</p>
300 <p>Returns the raw request body as stream on success or NULL on failure.
</p>
301 <h2 id=
"http_match_request_header">bool http_match_request_header(string header, string value[, bool match_case = false])
</h2>
302 <p>Match an incoming HTTP header.
</p>
303 <p>Expects two string parameters representing the header name (case-insensitive)
<br />
304 and the header value that should be compared. The case sensitivity of the
<br />
305 header value depends on the additional optional bool parameter accepted.
</p>
306 <p>Returns TRUE if header value matches, else FALSE.
</p>
307 <h2 id=
"http_get">string http_get(string url[, array options[, array &info]])
</h2>
308 <p>Performs an HTTP GET request on the supplied url.
</p>
309 <p>The second parameter, if set, is expected to be an associative
<br />
310 array where the following keys will be recognized:
</p><pre> - redirect: int, whether and how many redirects to follow
<br />
311 - unrestrictedauth: bool, whether to continue sending credentials on
<br />
312 redirects to a different host
<br />
313 - proxyhost: string, proxy host in
"host[:port]" format
<br />
314 - proxyport: int, use another proxy port as specified in proxyhost
<br />
315 - proxytype: int, HTTP_PROXY_HTTP, SOCKS4 or SOCKS5
<br />
316 - proxyauth: string, proxy credentials in
"user:pass" format
<br />
317 - proxyauthtype: int, HTTP_AUTH_BASIC and/or HTTP_AUTH_NTLM
<br />
318 - httpauth: string, http credentials in
"user:pass" format
<br />
319 - httpauthtype: int, HTTP_AUTH_BASIC, DIGEST and/or NTLM
<br />
320 - compress: bool, whether to allow gzip/deflate content encoding
<br />
321 - port: int, use another port as specified in the url
<br />
322 - referer: string, the referer to send
<br />
323 - useragent: string, the user agent to send
<br />
324 (defaults to PECL::HTTP/version (PHP/version)))
<br />
325 - headers: array, list of custom headers as associative array
<br />
326 like array(
"header" =
> "value")
<br />
327 - cookies: array, list of cookies as associative array
<br />
328 like array(
"cookie" =
> "value")
<br />
329 - encodecookies: bool, whether to urlencode the cookies (default: true)
<br />
330 - cookiestore: string, path to a file where cookies are/will be stored
<br />
331 - cookiesession: bool, don't load session cookies from cookiestore if TRUE
<br />
332 - resume: int, byte offset to start the download from;
<br />
333 if the server supports ranges
<br />
334 - range: array, array of arrays, each containing two integers,
<br />
335 specifying the ranges to download if server support is
<br />
336 given; only recognized if the resume option is empty
<br />
337 - maxfilesize: int, maximum file size that should be downloaded;
<br />
338 has no effect, if the size of the requested entity is not known
<br />
339 - lastmodified: int, timestamp for If-(Un)Modified-Since header
<br />
340 - etag: string, quoted etag for If-(None-)Match header
<br />
341 - timeout: int, seconds the request may take
<br />
342 - connecttimeout: int, seconds the connect may take
<br />
343 - onprogress: mixed, progress callback
<br />
344 - interface: string, outgoing network interface (ifname, ip or hostname)
<br />
345 - portrange: array,
2 integers specifying outgoing portrange to try
<br />
346 - ssl: array, with the following options:
<br />
347 cert: string, path to certificate
<br />
348 certtype: string, type of certificate
<br />
349 certpasswd: string, password for certificate
<br />
350 key: string, path to key
<br />
351 keytype: string, type of key
<br />
352 keypasswd: string, pasword for key
<br />
353 engine: string, ssl engine to use
<br />
354 version: int, ssl version to use
<br />
355 verifypeer: bool, whether to verify the peer
<br />
356 verifyhost: bool whether to verify the host
<br />
357 cipher_list: string, list of allowed ciphers
<br />
360 random_file: string
<br />
361 egdsocket: string
<br />
363 <p>The optional third parameter will be filled with some additional information
<br />
364 in form of an associative array, if supplied, like the following example:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
365 <span style=
"color: #0000BB"><?php
<br /></span><span style=
"color: #007700">array
(
<br /> </span><span style=
"color: #DD0000">'effective_url'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">'http://www.example.com/'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'response_code'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">302</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'connect_code'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">0</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'filetime'
</span><span style=
"color: #007700">=
> -
</span><span style=
"color: #0000BB">1</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'total_time'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">0.212348</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'namelookup_time'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">0.038296</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'connect_time'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">0.104144</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'pretransfer_time'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">0.104307</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'starttransfer_time'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">0.212077</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'redirect_time'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">0</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'redirect_count'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">0</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'size_upload'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">0</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'size_download'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">218</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'speed_download'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">1026</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'speed_upload'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">0</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'header_size'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">307</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'request_size'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">103</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'ssl_verifyresult'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">0</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'ssl_engines'
</span><span style=
"color: #007700">=
><br /> array
(
<br /> </span><span style=
"color: #0000BB">0 </span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">'dynamic'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #0000BB">1 </span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">'cswift'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #0000BB">2 </span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">'chil'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #0000BB">3 </span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">'atalla'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #0000BB">4 </span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">'nuron'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #0000BB">5 </span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">'ubsec'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #0000BB">6 </span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">'aep'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #0000BB">7 </span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">'sureware'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #0000BB">8 </span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">'
4758cca'
</span><span style=
"color: #007700">,
<br /> ),
<br /> </span><span style=
"color: #DD0000">'content_length_download'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">218</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'content_length_upload'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">0</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'content_type'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">'text/html'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'httpauth_avail'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">0</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'proxyauth_avail'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">0</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'num_connects'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">1</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'os_errno'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">0</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #DD0000">'error'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">''
</span><span style=
"color: #007700">,
<br /> )
<br /></span><span style=
"color: #0000BB">?
></span><br />
366 </span></code></blockquote></p>
368 <p>Returns the HTTP response(s) as string on success, or FALSE on failure.
</p>
369 <h2 id=
"http_head">string http_head(string url[, array options[, array &info]])
</h2>
370 <p>Performs an HTTP HEAD request on the supplied url.
</p>
371 <p>See http_get() for a full list of available parameters and options.
</p>
372 <p>Returns the HTTP response as string on success, or FALSE on failure.
</p>
373 <h2 id=
"http_post_data">string http_post_data(string url, string data[, array options[, array &info]])
</h2>
374 <p>Performs an HTTP POST request on the supplied url.
</p>
375 <p>Expects a string as second parameter containing the pre-encoded post data.
<br />
376 See http_get() for a full list of available parameters and options.
<br />
378 Returns the HTTP response(s) as string on success, or FALSE on failure.
</p>
379 <h2 id=
"http_post_fields">string http_post_fields(string url, array data[, array files[, array options[, array &info]]])
</h2>
380 <p>Performs an HTTP POST request on the supplied url.
</p>
381 <p>Expects an associative array as second parameter, which will be
<br />
382 www-form-urlencoded. See http_get() for a full list of available options.
</p>
383 <p>Returns the HTTP response(s) as string on success, or FALSE on failure.
</p>
384 <h2 id=
"http_put_file">string http_put_file(string url, string file[, array options[, array &info]])
</h2>
385 <p>Performs an HTTP PUT request on the supplied url.
</p>
386 <p>Expects the second parameter to be a string referencing the file to upload.
<br />
387 See http_get() for a full list of available options.
</p>
388 <p>Returns the HTTP response(s) as string on success, or FALSE on failure.
</p>
389 <h2 id=
"http_put_stream">string http_put_stream(string url, resource stream[, array options[, array &info]])
</h2>
390 <p>Performs an HTTP PUT request on the supplied url.
</p>
391 <p>Expects the second parameter to be a resource referencing an already
<br />
392 opened stream, from which the data to upload should be read.
<br />
393 See http_get() for a full list of available options.
</p>
394 <p>Returns the HTTP response(s) as string on success, or FALSE on failure.
</p>
395 <h2 id=
"http_put_data">string http_put_data(string url, string data[, array options[, array &info]])
</h2>
396 <p>Performs an HTTP PUT request on the supplied url.
</p>
397 <p>Expects the second parameter to be a string containing the data to upload.
<br />
398 See http_get() for a full list of available options.
</p>
399 <p>Returns the HTTP response(s) as string on success, or FALSE on failure.
</p>
400 <h2 id=
"http_request">string http_request(int method, string url[, string body[, array options[, array &info]]])
</h2>
401 <p>Performs a custom HTTP request on the supplied url.
</p>
402 <p>Expects the first parameter to be an integer specifying the request method to use.
<br />
403 Accepts an optional third string parameter containing the raw request body.
<br />
404 See http_get() for a full list of available options.
</p>
405 <p>Returns the HTTP response(s) as string on success, or FALSE on failure.
</p>
406 <h2 id=
"http_request_body_encode">string http_request_body_encode(array fields, array files)
</h2>
407 <p>Generate x-www-form-urlencoded resp. form-data encoded request body.
</p>
408 <p>Returns encoded string on success, or FALSE on failure.
</p>
409 <h2 id=
"http_request_method_register">int http_request_method_register(string method)
</h2>
410 <p>Register a custom request method.
</p>
411 <p>Expects a string parameter containing the request method name to register.
</p>
412 <p>Returns the ID of the request method on success, or FALSE on failure.
</p>
413 <h2 id=
"http_request_method_unregister">bool http_request_method_unregister(mixed method)
</h2>
414 <p>Unregister a previously registered custom request method.
</p>
415 <p>Expects either the request method name or ID.
</p>
416 <p>Returns TRUE on success, or FALSE on failure.
</p>
417 <h2 id=
"http_request_method_exists">int http_request_method_exists(mixed method)
</h2>
418 <p>Check if a request method is registered (or available by default).
</p>
419 <p>Expects either the request method name or ID as parameter.
</p>
420 <p>Returns TRUE if the request method is known, else FALSE.
</p>
421 <h2 id=
"http_request_method_name">string http_request_method_name(int method)
</h2>
422 <p>Get the literal string representation of a standard or registered request method.
</p>
423 <p>Expects the request method ID as parameter.
</p>
424 <p>Returns the request method name as string on success, or FALSE on failure.
</p>
425 <h2 id=
"http_deflate">string http_deflate(string data[, int flags =
0])
</h2>
426 <p>Compress data with gzip, zlib AKA deflate or raw deflate encoding.
</p>
427 <p>Expects the first parameter to be a string containing the data that should
<br />
429 <p>Returns the encoded string on success, or NULL on failure.
</p>
430 <h2 id=
"http_inflate">string http_inflate(string data)
</h2>
431 <p>Decompress data compressed with either gzip, deflate AKA zlib or raw
<br />
432 deflate encoding.
</p>
433 <p>Expects a string as parameter containing the compressed data.
</p>
434 <p>Returns the decoded string on success, or NULL on failure.
</p>
435 <h2 id=
"ob_deflatehandler">string ob_deflatehandler(string data, int mode)
</h2>
436 <p>For use with ob_start(). The deflate output buffer handler can only be used once.
<br />
437 It conflicts with ob_gzhandler and zlib.output_compression as well and should
<br />
438 not be used after ext/mbstrings mb_output_handler and ext/sessions URL-Rewriter (AKA
<br />
439 session.use_trans_sid).
</p>
440 <h2 id=
"ob_inflatehandler">string ob_inflatehandler(string data, int mode)
</h2>
441 <p>For use with ob_start(). Same restrictions as with ob_deflatehandler apply.
</p>
442 <h2 id=
"http_support">int http_support([int feature =
0])
</h2>
443 <p>Check for feature that require external libraries.
</p>
444 <p>Accepts an optional in parameter specifying which feature to probe for.
<br />
445 If the parameter is
0 or omitted, the return value contains a bitmask of
<br />
446 all supported features that depend on external libraries.
</p>
447 <p>Available features to probe for are:
<br />
449 <li> HTTP_SUPPORT: always set
<br />
450 <li> HTTP_SUPPORT_REQUESTS: whether ext/http was linked against libcurl,
<br />
451 and HTTP requests can be issued
<br />
452 <li> HTTP_SUPPORT_SSLREQUESTS: whether libcurl was linked against openssl,
<br />
453 and SSL requests can be issued
<br />
454 <li> HTTP_SUPPORT_ENCODINGS: whether ext/http was linked against zlib,
<br />
455 and compressed HTTP responses can be decoded
<br />
456 <li> HTTP_SUPPORT_MAGICMIME: whether ext/http was linked against libmagic,
<br />
457 and the HttpResponse::guessContentType() method is usable
<br />
459 <p>Returns int, whether requested feature is supported, or a bitmask with
<br />
460 all supported features.
</p>
462 <h1 id=
"http_deflatestream_object.c">http_deflatestream_object.c
</h1>
463 <h2 id=
"HttpDeflateStream" class=
"o">HttpDeflateStream
</h2>
464 <h3 id=
"HttpDeflateStream___construct">void HttpDeflateStream::__construct([int flags =
0])
</h3>
465 <p>Creates a new HttpDeflateStream object instance.
</p>
466 <p>Accepts an optional int parameter specifying how to initialize the deflate stream.
</p>
467 <h3 id=
"HttpDeflateStream_update">string HttpDeflateStream::update(string data)
</h3>
468 <p>Passes more data through the deflate stream.
</p>
469 <p>Expects a string parameter containing (a part of) the data to deflate.
</p>
470 <p>Returns deflated data on success or FALSE on failure.
</p>
471 <h3 id=
"HttpDeflateStream_flush">string HttpDeflateStream::flush([string data])
</h3>
472 <p>Flushes the deflate stream.
</p>
473 <p>Returns some deflated data as string on success or FALSE on failure.
</p>
474 <h3 id=
"HttpDeflateStream_finish">string HttpDeflateStream::finish([string data])
</h3>
475 <p>Finalizes the deflate stream. The deflate stream can be reused after finalizing.
</p>
476 <p>Returns the final part of deflated data.
</p>
478 <h1 id=
"http_inflatestream_object.c">http_inflatestream_object.c
</h1>
479 <h2 id=
"HttpInflateStream" class=
"o">HttpInflateStream
</h2>
480 <h3 id=
"HttpInflateStream___construct">void HttpInflateStream::__construct([int flags =
0])
</h3>
481 <p>Creates a new HttpInflateStream object instance.
</p>
482 <p>Accepts an optional int parameter specifying how to initialize the inflate stream.
</p>
483 <h3 id=
"HttpInflateStream_update">string HttpInflateStream::update(string data)
</h3>
484 <p>Passes more data through the inflate stream.
</p>
485 <p>Expects a string parameter containing (a part of) the data to inflate.
</p>
486 <p>Returns inflated data on success or FALSE on failure.
</p>
487 <h3 id=
"HttpInflateStream_flush">string HttpInflateStream::flush([string data])
</h3>
488 <p>Flush the inflate stream.
</p>
489 <p>Returns some inflated data as string on success or FALSE on failure.
</p>
490 <h3 id=
"HttpInflateStream_finish">string HttpInflateStream::finish([string data])
</h3>
491 <p>Finalizes the inflate stream. The inflate stream can be reused after finalizing.
</p>
492 <p>Returns the final part of inflated data.
</p>
494 <h1 id=
"http_message_object.c">http_message_object.c
</h1>
495 <h2 id=
"HttpMessage" class=
"o">HttpMessage
</h2>
496 <h3 id=
"HttpMessage___construct">void HttpMessage::__construct([string message])
</h3>
497 <p>Instantiate a new HttpMessage object.
</p>
498 <p>Accepts an optional string parameter containing a single or several
<br />
499 consecutive HTTP messages. The constructed object will actually
<br />
500 represent the *last* message of the passed string. If there were
<br />
501 prior messages, those can be accessed by HttpMessage::getParentMessage().
</p>
502 <p>Throws HttpMalformedHeaderException.
</p>
503 <h3 id=
"HttpMessage_fromString">static HttpMessage HttpMessage::fromString(string raw_message[, string class_name =
"HttpMessage"])
</h3>
504 <p>Create an HttpMessage object from a string. Kind of a static constructor.
</p>
505 <p>Expects a string parameter containing a single or several consecutive
<br />
506 HTTP messages. Accepts an optional string parameter specifying the class to use.
</p>
507 <p>Returns an HttpMessage object on success or NULL on failure.
</p>
508 <p>Throws HttpMalformedHeadersException.
</p>
509 <h3 id=
"HttpMessage_getBody">string HttpMessage::getBody()
</h3>
510 <p>Get the body of the parsed HttpMessage.
</p>
511 <p>Returns the message body as string.
</p>
512 <h3 id=
"HttpMessage_setBody">void HttpMessage::setBody(string body)
</h3>
513 <p>Set the body of the HttpMessage.
<br />
514 NOTE: Don't forget to update any headers accordingly.
</p>
515 <p>Expects a string parameter containing the new body of the message.
</p>
516 <h3 id=
"HttpMessage_getHeader">string HttpMessage::getHeader(string header)
</h3>
517 <p>Get message header.
</p>
518 <p>Returns the header value on success or NULL if the header does not exist.
</p>
519 <h3 id=
"HttpMessage_getHeaders">array HttpMessage::getHeaders()
</h3>
520 <p>Get Message Headers.
</p>
521 <p>Returns an associative array containing the messages HTTP headers.
</p>
522 <h3 id=
"HttpMessage_setHeaders">void HttpMessage::setHeaders(array headers)
</h3>
523 <p>Sets new headers.
</p>
524 <p>Expects an associative array as parameter containing the new HTTP headers,
<br />
525 which will replace *all* previous HTTP headers of the message.
</p>
526 <h3 id=
"HttpMessage_addHeaders">void HttpMessage::addHeaders(array headers[, bool append = false])
</h3>
527 <p>Add headers. If append is true, headers with the same name will be separated, else overwritten.
</p>
528 <p>Expects an associative array as parameter containing the additional HTTP headers
<br />
529 to add to the messages existing headers. If the optional bool parameter is true,
<br />
530 and a header with the same name of one to add exists already, this respective
<br />
531 header will be converted to an array containing both header values, otherwise
<br />
532 it will be overwritten with the new header value.
</p>
533 <h3 id=
"HttpMessage_getType">int HttpMessage::getType()
</h3>
534 <p>Get Message Type. (HTTP_MSG_NONE|HTTP_MSG_REQUEST|HTTP_MSG_RESPONSE)
</p>
535 <p>Returns the HttpMessage::TYPE.
</p>
536 <h3 id=
"HttpMessage_setType">void HttpMessage::setType(int type)
</h3>
537 <p>Set Message Type. (HTTP_MSG_NONE|HTTP_MSG_REQUEST|HTTP_MSG_RESPONSE)
</p>
538 <p>Expects an int parameter, the HttpMessage::TYPE.
</p>
539 <h3 id=
"HttpMessage_getResponseCode">int HttpMessage::getResponseCode()
</h3>
540 <p>Get the Response Code of the Message.
</p>
541 <p>Returns the HTTP response code if the message is of type
<br />
542 HttpMessage::TYPE_RESPONSE, else FALSE.
</p>
543 <h3 id=
"HttpMessage_setResponseCode">bool HttpMessage::setResponseCode(int code)
</h3>
544 <p>Set the response code of an HTTP Response Message.
</p>
545 <p>Expects an int parameter with the HTTP response code.
</p>
546 <p>Returns TRUE on success, or FALSE if the message is not of type
<br />
547 HttpMessage::TYPE_RESPONSE or the response code is out of range (
100-
510).
</p>
548 <h3 id=
"HttpMessage_getResponseStatus">string HttpMessage::getResponseStatus()
</h3>
549 <p>Get the Response Status of the message (i.e. the string following the response code).
</p>
550 <p>Returns the HTTP response status string if the message is of type
<br />
551 HttpMessage::TYPE_RESPONSE, else FALSE.
</p>
552 <h3 id=
"HttpMessage_setResponseStatus">bool HttpMessage::setResponseStatus(string status)
</h3>
553 <p>Set the Response Status of the HTTP message (i.e. the string following the response code).
</p>
554 <p>Expects a string parameter containing the response status text.
</p>
555 <p>Returns TRUE on success or FALSE if the message is not of type
<br />
556 HttpMessage::TYPE_RESPONSE.
</p>
557 <h3 id=
"HttpMessage_getRequestMethod">string HttpMessage::getRequestMethod()
</h3>
558 <p>Get the Request Method of the Message.
</p>
559 <p>Returns the request method name on success, or FALSE if the message is
<br />
560 not of type HttpMessage::TYPE_REQUEST.
</p>
561 <h3 id=
"HttpMessage_setRequestMethod">bool HttpMessage::setRequestMethod(string method)
</h3>
562 <p>Set the Request Method of the HTTP Message.
</p>
563 <p>Expects a string parameter containing the request method name.
</p>
564 <p>Returns TRUE on success, or FALSE if the message is not of type
<br />
565 HttpMessage::TYPE_REQUEST or an invalid request method was supplied.
</p>
566 <h3 id=
"HttpMessage_getRequestUrl">string HttpMessage::getRequestUrl()
</h3>
567 <p>Get the Request URL of the Message.
</p>
568 <p>Returns the request url as string on success, or FALSE if the message
<br />
569 is not of type HttpMessage::TYPE_REQUEST.
</p>
570 <h3 id=
"HttpMessage_setRequestUrl">bool HttpMessage::setRequestUrl(string url)
</h3>
571 <p>Set the Request URL of the HTTP Message.
</p>
572 <p>Expects a string parameters containing the request url.
</p>
573 <p>Returns TRUE on success, or FALSE if the message is not of type
<br />
574 HttpMessage::TYPE_REQUEST or supplied URL was empty.
</p>
575 <h3 id=
"HttpMessage_getHttpVersion">string HttpMessage::getHttpVersion()
</h3>
576 <p>Get the HTTP Protocol Version of the Message.
</p>
577 <p>Returns the HTTP protocol version as string.
</p>
578 <h3 id=
"HttpMessage_setHttpVersion">bool HttpMessage::setHttpVersion(string version)
</h3>
579 <p>Set the HTTP Protocol version of the Message.
</p>
580 <p>Expects a string parameter containing the HTTP protocol version.
</p>
581 <p>Returns TRUE on success, or FALSE if supplied version is out of range (
1.0/
1.1).
</p>
582 <h3 id=
"HttpMessage_guessContentType">string HttpMessage::guessContentType(string magic_file[, int magic_mode = MAGIC_MIME])
</h3>
583 <p>Attempts to guess the content type of supplied payload through libmagic.
</p>
584 <p>Expects a string parameter specifying the magic.mime database to use.
<br />
585 Additionally accepts an optional int parameter, being flags for libmagic.
</p>
586 <p>Returns the guessed content type on success, or FALSE on failure.
</p>
587 <p>Throws HttpRuntimeException, HttpInvalidParamException
<br />
588 if http.only_exceptions is TRUE.
</p>
589 <h3 id=
"HttpMessage_getParentMessage">HttpMessage HttpMessage::getParentMessage()
</h3>
590 <p>Get parent Message.
</p>
591 <p>Returns the parent HttpMessage on success, or NULL if there's none.
</p>
592 <p>Throws HttpRuntimeException.
</p>
593 <h3 id=
"HttpMessage_send">bool HttpMessage::send()
</h3>
594 <p>Send the Message according to its type as Response or Request.
<br />
595 This provides limited functionality compared to HttpRequest and HttpResponse.
</p>
596 <p>Returns TRUE on success, or FALSE on failure.
</p>
597 <h3 id=
"HttpMessage_toString">string HttpMessage::toString([bool include_parent = false])
</h3>
598 <p>Get the string representation of the Message.
</p>
599 <p>Accepts a bool parameter which specifies whether the returned string
<br />
600 should also contain any parent messages.
</p>
601 <p>Returns the full message as string.
</p>
602 <h3 id=
"HttpMessage_toMessageTypeObject">HttpRequest|HttpResponse HttpMessage::toMessageTypeObject(void)
</h3>
603 <p>Creates an object regarding to the type of the message.
</p>
604 <p>Returns either an HttpRequest or HttpResponse object on success, or NULL on failure.
</p>
605 <p>Throws HttpRuntimeException, HttpMessageTypeException, HttpHeaderException.
</p>
606 <h3 id=
"HttpMessage_count">int HttpMessage::count()
</h3>
607 <p>Implements Countable.
</p>
608 <p>Returns the number of parent messages +
1.
</p>
609 <h3 id=
"HttpMessage_serialize">string HttpMessage::serialize()
</h3>
610 <p>Implements Serializable.
</p>
611 <p>Returns the serialized representation of the HttpMessage.
</p>
612 <h3 id=
"HttpMessage_unserialize">void HttpMessage::unserialize(string serialized)
</h3>
613 <p>Implements Serializable.
</p>
614 <p>Re-constructs the HttpMessage based upon the serialized string.
</p>
615 <h3 id=
"HttpMessage_detach">HttpMessage HttpMessage::detach(void)
</h3>
616 <p>Returns a clone of an HttpMessage object detached from any parent messages.
</p>
617 <h3 id=
"HttpMessage_prepend">void HttpMessage::prepend(HttpMessage message[, bool top = true])
</h3>
618 <p>Prepends message(s) to the HTTP message.
</p>
619 <p>Expects an HttpMessage object as parameter.
</p>
620 <p>Throws HttpInvalidParamException if the message is located within the same message chain.
</p>
621 <h3 id=
"HttpMessage_reverse">HttpMessage HttpMessage::reverse()
</h3>
622 <p>Reorders the message chain in reverse order.
</p>
623 <p>Returns the most parent HttpMessage object.
</p>
624 <h3 id=
"HttpMessage_rewind">void HttpMessage::rewind(void)
</h3>
625 <p>Implements Iterator.
</p>
626 <h3 id=
"HttpMessage_valid">bool HttpMessage::valid(void)
</h3>
627 <p>Implements Iterator.
</p>
628 <h3 id=
"HttpMessage_next">void HttpMessage::next(void)
</h3>
629 <p>Implements Iterator.
</p>
630 <h3 id=
"HttpMessage_key">int HttpMessage::key(void)
</h3>
631 <p>Implements Iterator.
</p>
632 <h3 id=
"HttpMessage_current">HttpMessage HttpMessage::current(void)
</h3>
633 <p>Implements Iterator.
</p>
635 <h1 id=
"http_querystring_object.c">http_querystring_object.c
</h1>
636 <h2 id=
"HttpQueryString" class=
"o">HttpQueryString
</h2>
637 <h3 id=
"HttpQueryString___construct">final void HttpQueryString::__construct([bool global = true[, mixed add])
</h3>
638 <p>Creates a new HttpQueryString object instance.
<br />
639 Operates on and modifies $_GET and $_SERVER['QUERY_STRING'] if global is TRUE.
</p>
640 <h3 id=
"HttpQueryString_toString">string HttpQueryString::toString()
</h3>
641 <p>Returns the string representation.
</p>
642 <h3 id=
"HttpQueryString_toArray">array HttpQueryString::toArray()
</h3>
643 <p>Returns the array representation.
</p>
644 <h3 id=
"HttpQueryString_get">mixed HttpQueryString::get([string key[, mixed type =
0[, mixed defval = NULL[, bool delete = false]]]])
</h3>
645 <p>Get (part of) the query string.
</p>
646 <p>The type parameter is either one of the HttpQueryString::TYPE_* constants or a type abbreviation like
<br />
647 "b" for bool,
"i" for int,
"f" for float,
"s" for string,
"a" for array and
"o" for a stdClass object.
</p>
648 <h3 id=
"HttpQueryString_set">string HttpQueryString::set(mixed params)
</h3>
649 <p>Set query string entry/entries. NULL values will unset the variable.
</p>
650 <h3 id=
"HttpQueryString_mod">HttpQueryString HttpQueryString::mod(mixed params)
</h3>
651 <p>Copies the query string object and sets provided params at the clone.
<br />
652 This is basically shorthand for:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
653 <span style=
"color: #0000BB"><?php
<br />$newQS
</span><span style=
"color: #007700">=
new
</span><span style=
"color: #0000BB">HttpQueryString
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">false
</span><span style=
"color: #007700">,
</span><span style=
"color: #0000BB">$oldQS
</span><span style=
"color: #007700">);
<br /></span><span style=
"color: #0000BB">$newQS
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">set
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">$other_params
</span><span style=
"color: #007700">);
<br /></span><span style=
"color: #0000BB">?
></span><br />
654 </span></code></blockquote></p>
656 <h3 id=
"HttpQueryString_singleton">static HttpQueryString HttpQueryString::singleton([bool global = true])
</h3>
657 <p>Get a single instance (differentiates between the global setting).
</p>
658 <h3 id=
"HttpQueryString_xlate">bool HttpQueryString::xlate(string ie, string oe)
</h3>
659 <p>Converts the query string from the source encoding ie to the target encoding oe.
<br />
660 WARNING: Don't use any character set that can contain NUL bytes like UTF-
16.
</p>
661 <p>Returns TRUE on success or FALSE on failure.
</p>
662 <h3 id=
"HttpQueryString_serialize">string HttpQueryString::serialize()
</h3>
663 <p>Implements Serializable.
</p>
664 <h3 id=
"HttpQueryString_unserialize">void HttpQueryString::unserialize(string serialized)
</h3>
665 <p>Implements Serializable.
</p>
666 <h3 id=
"HttpQueryString_offsetGet">mixed HttpQueryString::offsetGet(string offset)
</h3>
667 <p>Implements ArrayAccess.
</p>
668 <h3 id=
"HttpQueryString_offsetSet">void HttpQueryString::offsetSet(string offset, mixed value)
</h3>
669 <p>Implements ArrayAccess.
</p>
670 <h3 id=
"HttpQueryString_offsetExists">bool HttpQueryString::offsetExists(string offset)
</h3>
671 <p>Implements ArrayAccess.
</p>
672 <h3 id=
"HttpQueryString_offsetUnset">void HttpQueryString::offsetUnset(string offset)
</h3>
673 <p>Implements ArrayAccess.
</p>
675 <h1 id=
"http_request_object.c">http_request_object.c
</h1>
676 <h2 id=
"HttpRequest" class=
"o">HttpRequest
</h2>
677 <h3 id=
"HttpRequest___construct">void HttpRequest::__construct([string url[, int request_method = HTTP_METH_GET[, array options]]])
</h3>
678 <p>Instantiate a new HttpRequest object.
</p>
679 <p>Accepts a string as optional parameter containing the target request url.
<br />
680 Additionally accepts an optional int parameter specifying the request method
<br />
681 to use and an associative array as optional third parameter which will be
<br />
682 passed to HttpRequest::setOptions().
</p>
683 <p>Throws HttpException.
</p>
684 <h3 id=
"HttpRequest_setOptions">bool HttpRequest::setOptions([array options])
</h3>
685 <p>Set the request options to use. See http_get() for a full list of available options.
</p>
686 <p>Accepts an array as optional parameters, which values will overwrite the
<br />
687 currently set request options. If the parameter is empty or omitted,
<br />
688 the options of the HttpRequest object will be reset.
</p>
689 <p>Returns TRUE on success, or FALSE on failure.
</p>
690 <h3 id=
"HttpRequest_getOptions">array HttpRequest::getOptions()
</h3>
691 <p>Get currently set options.
</p>
692 <p>Returns an associative array containing currently set options.
</p>
693 <h3 id=
"HttpRequest_setSslOptions">bool HttpRequest::setSslOptions([array options])
</h3>
694 <p>Set SSL options.
</p>
695 <p>Accepts an associative array as parameter containing any SSL specific options.
<br />
696 If the parameter is empty or omitted, the SSL options will be reset.
</p>
697 <p>Returns TRUE on success, or FALSE on failure.
</p>
698 <h3 id=
"HttpRequest_addSslOptions">bool HttpRequest::addSslOptions(array options)
</h3>
699 <p>Set additional SSL options.
</p>
700 <p>Expects an associative array as parameter containing additional SSL specific options.
</p>
701 <p>Returns TRUE on success, or FALSE on failure.
</p>
702 <h3 id=
"HttpRequest_getSslOptions">array HttpRequest::getSslOtpions()
</h3>
703 <p>Get previously set SSL options.
</p>
704 <p>Returns an associative array containing any previously set SSL options.
</p>
705 <h3 id=
"HttpRequest_addHeaders">bool HttpRequest::addHeaders(array headers)
</h3>
706 <p>Add request header name/value pairs.
</p>
707 <p>Expects an associative array as parameter containing additional header
<br />
708 name/value pairs.
</p>
709 <p>Returns TRUE on success, or FALSE on failure.
</p>
710 <h3 id=
"HttpRequest_setHeaders">bool HttpRequest::setHeaders([array headers])
</h3>
711 <p>Set request header name/value pairs.
</p>
712 <p>Accepts an associative array as parameter containing header name/value pairs.
<br />
713 If the parameter is empty or omitted, all previously set headers will be unset.
</p>
714 <p>Returns TRUE on success, or FALSE on failure.
</p>
715 <h3 id=
"HttpRequest_getHeaders">array HttpRequest::getHeaders()
</h3>
716 <p>Get previously set request headers.
</p>
717 <p>Returns an associative array containing all currently set headers.
</p>
718 <h3 id=
"HttpRequest_setCookies">bool HttpRequest::setCookies([array cookies])
</h3>
720 <p>Accepts an associative array as parameter containing cookie name/value pairs.
<br />
721 If the parameter is empty or omitted, all previously set cookies will be unset.
</p>
722 <p>Returns TRUE on success, or FALSE on failure.
</p>
723 <h3 id=
"HttpRequest_addCookies">bool HttpRequest::addCookies(array cookies)
</h3>
725 <p>Expects an associative array as parameter containing any cookie name/value
<br />
727 <p>Returns TRUE on success, or FALSE on failure.
</p>
728 <h3 id=
"HttpRequest_getCookies">array HttpRequest::getCookies()
</h3>
729 <p>Get previously set cookies.
</p>
730 <p>Returns an associative array containing any previously set cookies.
</p>
731 <h3 id=
"HttpRequest_enableCookies">bool HttpRequest::enableCookies()
</h3>
732 <p>Enable automatic sending of received cookies.
<br />
733 Note that cuutomly set cookies will be sent anyway.
</p>
734 <h3 id=
"HttpRequest_resetCookies">bool HttpRequest::resetCookies([bool session_only = FALSE])
</h3>
735 <p>Reset all automatically received/sent cookies.
<br />
736 Note that customly set cookies are not affected.
</p>
737 <p>Accepts an optional bool parameter specifying
<br />
738 whether only session cookies should be reset
<br />
739 (needs libcurl
>= v7.15
.4, else libcurl
>= v7.14
.1).
</p>
740 <p>Returns TRUE on success, or FALSE on failure.
</p>
741 <h3 id=
"HttpRequest_setUrl">bool HttpRequest::setUrl(string url)
</h3>
742 <p>Set the request URL.
</p>
743 <p>Expects a string as parameter specifying the request url.
</p>
744 <p>Returns TRUE on success, or FALSE on failure.
</p>
745 <h3 id=
"HttpRequest_getUrl">string HttpRequest::getUrl()
</h3>
746 <p>Get the previously set request URL.
</p>
747 <p>Returns the currently set request url as string.
</p>
748 <h3 id=
"HttpRequest_setMethod">bool HttpRequest::setMethod(int request_method)
</h3>
749 <p>Set the request method.
</p>
750 <p>Expects an int as parameter specifying the request method to use.
<br />
751 In PHP
5.1+ HttpRequest::METH_*, otherwise the HTTP_METH_* constants can be used.
</p>
752 <p>Returns TRUE on success, or FALSE on failure.
</p>
753 <h3 id=
"HttpRequest_getMethod">int HttpRequest::getMethod()
</h3>
754 <p>Get the previously set request method.
</p>
755 <p>Returns the currently set request method.
</p>
756 <h3 id=
"HttpRequest_setContentType">bool HttpRequest::setContentType(string content_type)
</h3>
757 <p>Set the content type the post request should have.
</p>
758 <p>Expects a string as parameters containing the content type of the request
<br />
759 (primary/secondary).
</p>
760 <p>Returns TRUE on success, or FALSE if the content type does not seem to
<br />
761 contain a primary and a secondary part.
</p>
762 <h3 id=
"HttpRequest_getContentType">string HttpRequest::getContentType()
</h3>
763 <p>Get the previously content type.
</p>
764 <p>Returns the previously set content type as string.
</p>
765 <h3 id=
"HttpRequest_setQueryData">bool HttpRequest::setQueryData([mixed query_data])
</h3>
766 <p>Set the URL query parameters to use, overwriting previously set query parameters.
<br />
767 Affects any request types.
</p>
768 <p>Accepts a string or associative array parameter containing the pre-encoded
<br />
769 query string or to be encoded query fields. If the parameter is empty or
<br />
770 omitted, the query data will be unset.
</p>
771 <p>Returns TRUE on success, or FALSE on failure.
</p>
772 <h3 id=
"HttpRequest_getQueryData">string HttpRequest::getQueryData()
</h3>
773 <p>Get the current query data in form of an urlencoded query string.
</p>
774 <p>Returns a string containing the urlencoded query.
</p>
775 <h3 id=
"HttpRequest_addQueryData">bool HttpRequest::addQueryData(array query_params)
</h3>
776 <p>Add parameters to the query parameter list, leaving previously set unchanged.
<br />
777 Affects any request type.
</p>
778 <p>Expects an associative array as parameter containing the query fields to add.
</p>
779 <p>Returns TRUE on success, or FALSE on failure.
</p>
780 <h3 id=
"HttpRequest_addPostFields">bool HttpRequest::addPostFields(array post_data)
</h3>
781 <p>Adds POST data entries, leaving previously set unchanged, unless a
<br />
782 post entry with the same name already exists.
<br />
783 Affects only POST and custom requests.
</p>
784 <p>Expects an associative array as parameter containing the post fields.
</p>
785 <p>Returns TRUE on success, or FALSE on failure.
</p>
786 <h3 id=
"HttpRequest_setPostFields">bool HttpRequest::setPostFields([array post_data])
</h3>
787 <p>Set the POST data entries, overwriting previously set POST data.
<br />
788 Affects only POST and custom requests.
</p>
789 <p>Accepts an associative array as parameter containing the post fields.
<br />
790 If the parameter is empty or omitted, the post data will be unset.
</p>
791 <p>Returns TRUE on success, or FALSE on failure.
</p>
792 <h3 id=
"HttpRequest_getPostFields">array HttpRequest::getPostFields()
</h3>
793 <p>Get previously set POST data.
</p>
794 <p>Returns the currently set post fields as associative array.
</p>
795 <h3 id=
"HttpRequest_setRawPostData">bool HttpRequest::setRawPostData([string raw_post_data])
</h3>
796 <p>Set raw post data to send, overwriting previously set raw post data. Don't
<br />
797 forget to specify a content type. Affects only POST and custom requests.
<br />
798 Only either post fields or raw post data can be used for each request.
<br />
799 Raw post data has higher precedence and will be used even if post fields
<br />
801 <p>Accepts a string as parameter containing the *raw* post data.
</p>
802 <p>Returns TRUE on success, or FALSE on failure.
</p>
803 <h3 id=
"HttpRequest_addRawPostData">bool HttpRequest::addRawPostData(string raw_post_data)
</h3>
804 <p>Add raw post data, leaving previously set raw post data unchanged.
<br />
805 Affects only POST and custom requests.
</p>
806 <p>Expects a string as parameter containing the raw post data to concatenate.
</p>
807 <p>Returns TRUE on success, or FALSE on failure.
</p>
808 <h3 id=
"HttpRequest_getRawPostData">string HttpRequest::getRawPostData()
</h3>
809 <p>Get previously set raw post data.
</p>
810 <p>Returns a string containing the currently set raw post data.
</p>
811 <h3 id=
"HttpRequest_addPostFile">bool HttpRequest::addPostFile(string name, string file[, string content_type =
"application/x-octetstream"])
</h3>
812 <p>Add a file to the POST request, leaving previously set files unchanged.
<br />
813 Affects only POST and custom requests. Cannot be used with raw post data.
</p>
814 <p>Expects a string parameter containing the form element name, and a string
<br />
815 paremeter containing the path to the file which should be uploaded.
<br />
816 Additionally accepts an optional string parameter which should contain
<br />
817 the content type of the file.
</p>
818 <p>Returns TRUE on success, or FALSE if the content type seems not to contain a
<br />
819 primary and a secondary content type part.
</p>
820 <h3 id=
"HttpRequest_setPostFiles">bool HttpRequest::setPostFiles([array post_files])
</h3>
821 <p>Set files to post, overwriting previously set post files.
<br />
822 Affects only POST and requests. Cannot be used with raw post data.
</p>
823 <p>Accepts an array containing the files to post. Each entry should be an
<br />
824 associative array with
"name",
"file" and
"type" keys. If the parameter
<br />
825 is empty or omitted the post files will be unset.
</p>
826 <p>Returns TRUE on success, or FALSE on failure.
</p>
827 <h3 id=
"HttpRequest_getPostFiles">array HttpRequest::getPostFiles()
</h3>
828 <p>Get all previously added POST files.
</p>
829 <p>Returns an array containing currently set post files.
</p>
830 <h3 id=
"HttpRequest_setPutFile">bool HttpRequest::setPutFile([string file])
</h3>
831 <p>Set file to put. Affects only PUT requests.
</p>
832 <p>Accepts a string as parameter referencing the path to file.
<br />
833 If the parameter is empty or omitted the put file will be unset.
</p>
834 <p>Returns TRUE on success, or FALSE on failure.
</p>
835 <h3 id=
"HttpRequest_getPutFile">string HttpRequest::getPutFile()
</h3>
836 <p>Get previously set put file.
</p>
837 <p>Returns a string containing the path to the currently set put file.
</p>
838 <h3 id=
"HttpRequest_setPutData">bool HttpRequest::setPutData([string put_data])
</h3>
839 <p>Set PUT data to send, overwriting previously set PUT data.
<br />
840 Affects only PUT requests.
<br />
841 Only either PUT data or PUT file can be used for each request.
<br />
842 PUT data has higher precedence and will be used even if a PUT
<br />
844 <p>Accepts a string as parameter containing the data to upload.
</p>
845 <p>Returns TRUE on success, or FALSE on failure.
</p>
846 <h3 id=
"HttpRequest_addPutData">bool HttpRequest::addPutData(string put_data)
</h3>
847 <p>Add PUT data, leaving previously set PUT data unchanged.
<br />
848 Affects only PUT requests.
</p>
849 <p>Expects a string as parameter containing the data to concatenate.
</p>
850 <p>Returns TRUE on success, or FALSE on failure.
</p>
851 <h3 id=
"HttpRequest_getPutData">string HttpRequest::getPutData()
</h3>
852 <p>Get previously set PUT data.
</p>
853 <p>Returns a string containing the currently set raw post data.
</p>
854 <h3 id=
"HttpRequest_getResponseData">array HttpRequest::getResponseData()
</h3>
855 <p>Get all response data after the request has been sent.
</p>
856 <p>Returns an associative array with the key
"headers" containing an associative
<br />
857 array holding all response headers, as well as the key
"body" containing a
<br />
858 string with the response body.
</p>
859 <p>If redirects were allowed and several responses were received, the data
<br />
860 references the last received response.
</p>
861 <h3 id=
"HttpRequest_getResponseHeader">mixed HttpRequest::getResponseHeader([string name])
</h3>
862 <p>Get response header(s) after the request has been sent.
</p>
863 <p>Accepts an string as optional parameter specifying a certain header to read.
<br />
864 If the parameter is empty or omitted all response headers will be returned.
</p>
865 <p>Returns either a string with the value of the header matching name if requested,
<br />
866 FALSE on failure, or an associative array containing all response headers.
</p>
867 <p>If redirects were allowed and several responses were received, the data
<br />
868 references the last received response.
</p>
869 <h3 id=
"HttpRequest_getResponseCookies">array HttpRequest::getResponseCookies([int flags[, array allowed_extras]])
</h3>
870 <p>Get response cookie(s) after the request has been sent.
</p>
871 <p>Returns an array of stdClass objects like http_parse_cookie would return.
</p>
872 <p>If redirects were allowed and several responses were received, the data
<br />
873 references the last received response.
</p>
874 <h3 id=
"HttpRequest_getResponseBody">string HttpRequest::getResponseBody()
</h3>
875 <p>Get the response body after the request has been sent.
</p>
876 <p>Returns a string containing the response body.
</p>
877 <p>If redirects were allowed and several responses were received, the data
<br />
878 references the last received response.
</p>
879 <h3 id=
"HttpRequest_getResponseCode">int HttpRequest::getResponseCode()
</h3>
880 <p>Get the response code after the request has been sent.
</p>
881 <p>Returns an int representing the response code.
</p>
882 <p>If redirects were allowed and several responses were received, the data
<br />
883 references the last received response.
</p>
884 <h3 id=
"HttpRequest_getResponseStatus">string HttpRequest::getResponseStatus()
</h3>
885 <p>Get the response status (i.e. the string after the response code) after the message has been sent.
</p>
886 <p>Returns a string containing the response status text.
</p>
887 <h3 id=
"HttpRequest_getResponseInfo">mixed HttpRequest::getResponseInfo([string name])
</h3>
888 <p>Get response info after the request has been sent.
<br />
889 See http_get() for a full list of returned info.
</p>
890 <p>Accepts a string as optional parameter specifying the info to read.
<br />
891 If the parameter is empty or omitted, an associative array containing
<br />
892 all available info will be returned.
</p>
893 <p>Returns either a scalar containing the value of the info matching name if
<br />
894 requested, FALSE on failure, or an associative array containing all
<br />
896 <p>If redirects were allowed and several responses were received, the data
<br />
897 references the last received response.
</p>
898 <h3 id=
"HttpRequest_getResponseMessage">HttpMessage HttpRequest::getResponseMessage()
</h3>
899 <p>Get the full response as HttpMessage object after the request has been sent.
</p>
900 <p>Returns an HttpMessage object of the response.
</p>
901 <p>If redirects were allowed and several responses were received, the data
<br />
902 references the last received response. Use HttpMessage::getParentMessage()
<br />
903 to access the data of previously received responses within this request
<br />
905 <p>Throws HttpException, HttpRuntimeException.
</p>
906 <h3 id=
"HttpRequest_getRequestMessage">HttpMessage HttpRequest::getRequestMessage()
</h3>
907 <p>Get sent HTTP message.
</p>
908 <p>Returns an HttpMessage object representing the sent request.
</p>
909 <p>If redirects were allowed and several responses were received, the data
<br />
910 references the last received response. Use HttpMessage::getParentMessage()
<br />
911 to access the data of previously sent requests within this request
<br />
913 <p>Note that the internal request message is immutable, that means that the
<br />
914 request message received through HttpRequest::getRequestMessage() will
<br />
915 always look the same for the same request, regardless of any changes you
<br />
916 may have made to the returned object.
</p>
917 <p>Throws HttpMalformedHeadersException, HttpEncodingException.
</p>
918 <h3 id=
"HttpRequest_getRawRequestMessage">string HttpRequest::getRawRequestMessage()
</h3>
919 <p>Get sent HTTP message.
</p>
920 <p>Returns an HttpMessage in a form of a string
</p>
921 <h3 id=
"HttpRequest_getRawResponseMessage">string HttpRequest::getRawResponseMessage()
</h3>
922 <p>Get the entire HTTP response.
</p>
923 <p>Returns the complete web server response, including the headers in a form of a string.
</p>
924 <h3 id=
"HttpRequest_getHistory">HttpMessage HttpRequest::getHistory()
</h3>
925 <p>Get all sent requests and received responses as an HttpMessage object.
</p>
926 <p>If you want to record history, set the instance variable
<br />
927 HttpRequest::$recordHistory to TRUE.
</p>
928 <p>Returns an HttpMessage object representing the complete request/response
<br />
930 <p>The object references the last received response, use HttpMessage::getParentMessage()
<br />
931 to access the data of previously sent requests and received responses.
</p>
932 <p>Throws HttpRuntimeException.
</p>
933 <h3 id=
"HttpRequest_clearHistory">void HttpRequest::clearHistory()
</h3>
934 <p>Clear the history.
</p>
935 <h3 id=
"HttpRequest_send">HttpMessage HttpRequest::send()
</h3>
936 <p>Send the HTTP request.
</p>
937 <p>Returns the received response as HttpMessage object.
</p>
938 <p>NOTE: While an exception may be thrown, the transfer could have succeeded
<br />
939 at least partially, so you might want to check the return values of various
<br />
940 HttpRequest::getResponse*() methods.
</p>
941 <p>Throws HttpRuntimeException, HttpRequestException,
<br />
942 HttpMalformedHeaderException, HttpEncodingException.
</p>
943 <p>GET example:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
944 <span style=
"color: #0000BB"><?php
<br />$r
</span><span style=
"color: #007700">=
new
</span><span style=
"color: #0000BB">HttpRequest
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">'http://example.com/feed.rss'
</span><span style=
"color: #007700">,
</span><span style=
"color: #0000BB">HttpRequest
</span><span style=
"color: #007700">::
</span><span style=
"color: #0000BB">METH_GET
</span><span style=
"color: #007700">);
<br /></span><span style=
"color: #0000BB">$r
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">setOptions
</span><span style=
"color: #007700">(array(
</span><span style=
"color: #DD0000">'lastmodified'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">filemtime
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">'local.rss'
</span><span style=
"color: #007700">)));
<br /></span><span style=
"color: #0000BB">$r
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">addQueryData
</span><span style=
"color: #007700">(array(
</span><span style=
"color: #DD0000">'category'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #0000BB">3</span><span style=
"color: #007700">));
<br />try
{
<br /> </span><span style=
"color: #0000BB">$r
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">send
</span><span style=
"color: #007700">();
<br /> if
(
</span><span style=
"color: #0000BB">$r
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">getResponseCode
</span><span style=
"color: #007700">()
==
</span><span style=
"color: #0000BB">200</span><span style=
"color: #007700">)
{
<br /> </span><span style=
"color: #0000BB">file_put_contents
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">'local.rss'
</span><span style=
"color: #007700">,
</span><span style=
"color: #0000BB">$r
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">getResponseBody
</span><span style=
"color: #007700">());
<br /> }
<br />}
catch
(
</span><span style=
"color: #0000BB">HttpException
$ex
</span><span style=
"color: #007700">)
{
<br /> echo
</span><span style=
"color: #0000BB">$ex
</span><span style=
"color: #007700">;
<br />}
<br /></span><span style=
"color: #0000BB">?
></span><br />
945 </span></code></blockquote></p>
947 <p>POST example:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
948 <span style=
"color: #0000BB"><?php
<br />$r
</span><span style=
"color: #007700">=
new
</span><span style=
"color: #0000BB">HttpRequest
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">'http://example.com/form.php'
</span><span style=
"color: #007700">,
</span><span style=
"color: #0000BB">HttpRequest
</span><span style=
"color: #007700">::
</span><span style=
"color: #0000BB">METH_POST
</span><span style=
"color: #007700">);
<br /></span><span style=
"color: #0000BB">$r
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">setOptions
</span><span style=
"color: #007700">(array(
</span><span style=
"color: #DD0000">'cookies'
</span><span style=
"color: #007700">=
> array(
</span><span style=
"color: #DD0000">'lang'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">'de'
</span><span style=
"color: #007700">)));
<br /></span><span style=
"color: #0000BB">$r
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">addPostFields
</span><span style=
"color: #007700">(array(
</span><span style=
"color: #DD0000">'user'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">'mike'
</span><span style=
"color: #007700">,
</span><span style=
"color: #DD0000">'pass'
</span><span style=
"color: #007700">=
> </span><span style=
"color: #DD0000">'s3c|r3t'
</span><span style=
"color: #007700">));
<br /></span><span style=
"color: #0000BB">$r
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">addPostFile
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">'image'
</span><span style=
"color: #007700">,
</span><span style=
"color: #DD0000">'profile.jpg'
</span><span style=
"color: #007700">,
</span><span style=
"color: #DD0000">'image/jpeg'
</span><span style=
"color: #007700">);
<br />try
{
<br /> echo
</span><span style=
"color: #0000BB">$r
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">send
</span><span style=
"color: #007700">()-
></span><span style=
"color: #0000BB">getBody
</span><span style=
"color: #007700">();
<br />}
catch
(
</span><span style=
"color: #0000BB">HttpException
$ex
</span><span style=
"color: #007700">)
{
<br /> echo
</span><span style=
"color: #0000BB">$ex
</span><span style=
"color: #007700">;
<br />}
<br /></span><span style=
"color: #0000BB">?
></span><br />
949 </span></code></blockquote></p>
952 <h1 id=
"http_requestpool_object.c">http_requestpool_object.c
</h1>
953 <h2 id=
"HttpRequestPool" class=
"o">HttpRequestPool
</h2>
954 <h3 id=
"HttpRequestPool___construct">void HttpRequestPool::__construct([HttpRequest request[, ...]])
</h3>
955 <p>Instantiate a new HttpRequestPool object. An HttpRequestPool is
<br />
956 able to send several HttpRequests in parallel.
</p>
957 <p>WARNING: Don't attach/detach HttpRequest objects to the HttpRequestPool
<br />
958 object while you're using the implemented Iterator interface.
</p>
959 <p>Accepts virtual infinite optional parameters each referencing an
<br />
960 HttpRequest object.
</p>
961 <p>Throws HttpRequestPoolException (HttpRequestException, HttpInvalidParamException).
</p>
962 <p>Example:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
963 <span style=
"color: #0000BB"><?php
<br /></span><span style=
"color: #007700">try
{
<br /> </span><span style=
"color: #0000BB">$pool
</span><span style=
"color: #007700">=
new
</span><span style=
"color: #0000BB">HttpRequestPool
</span><span style=
"color: #007700">(
<br /> new
</span><span style=
"color: #0000BB">HttpRequest
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">'http://www.google.com/'
</span><span style=
"color: #007700">,
</span><span style=
"color: #0000BB">HttpRequest
</span><span style=
"color: #007700">::
</span><span style=
"color: #0000BB">METH_HEAD
</span><span style=
"color: #007700">),
<br /> new
</span><span style=
"color: #0000BB">HttpRequest
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">'http://www.php.net/'
</span><span style=
"color: #007700">,
</span><span style=
"color: #0000BB">HttpRequest
</span><span style=
"color: #007700">::
</span><span style=
"color: #0000BB">METH_HEAD
</span><span style=
"color: #007700">)
<br /> );
<br /> </span><span style=
"color: #0000BB">$pool
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">send
</span><span style=
"color: #007700">();
<br /> foreach(
</span><span style=
"color: #0000BB">$pool
</span><span style=
"color: #007700">as
</span><span style=
"color: #0000BB">$request
</span><span style=
"color: #007700">)
{
<br /> </span><span style=
"color: #0000BB">printf
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">"%s is %s (%d)\n"</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #0000BB">$request
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">getUrl
</span><span style=
"color: #007700">(),
<br /> </span><span style=
"color: #0000BB">$request
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">getResponseCode
</span><span style=
"color: #007700">()
?
</span><span style=
"color: #DD0000">'alive'
</span><span style=
"color: #007700">:
</span><span style=
"color: #DD0000">'not
alive'
</span><span style=
"color: #007700">,
<br /> </span><span style=
"color: #0000BB">$request
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">getResponseCode
</span><span style=
"color: #007700">()
<br /> );
<br /> }
<br />}
catch
(
</span><span style=
"color: #0000BB">HttpException
$e
</span><span style=
"color: #007700">)
{
<br /> echo
</span><span style=
"color: #0000BB">$e
</span><span style=
"color: #007700">;
<br />}
<br /></span><span style=
"color: #0000BB">?
></span><br />
964 </span></code></blockquote></p>
966 <h3 id=
"HttpRequestPool___destruct">void HttpRequestPool::__destruct()
</h3>
967 <p>Clean up HttpRequestPool object.
</p>
968 <h3 id=
"HttpRequestPool_reset">void HttpRequestPool::reset()
</h3>
969 <p>Detach all attached HttpRequest objects.
</p>
970 <h3 id=
"HttpRequestPool_attach">bool HttpRequestPool::attach(HttpRequest request)
</h3>
971 <p>Attach an HttpRequest object to this HttpRequestPool.
<br />
972 WARNING: set all options prior attaching!
</p>
973 <p>Expects the parameter to be an HttpRequest object not already attached to
<br />
974 antother HttpRequestPool object.
</p>
975 <p>Returns TRUE on success, or FALSE on failure.
</p>
976 <p>Throws HttpInvalidParamException, HttpRequestException,
<br />
977 HttpRequestPoolException, HttpEncodingException.
</p>
978 <h3 id=
"HttpRequestPool_detach">bool HttpRequestPool::detach(HttpRequest request)
</h3>
979 <p>Detach an HttpRequest object from this HttpRequestPool.
</p>
980 <p>Expects the parameter to be an HttpRequest object attached to this
<br />
981 HttpRequestPool object.
</p>
982 <p>Returns TRUE on success, or FALSE on failure.
</p>
983 <p>Throws HttpInvalidParamException, HttpRequestPoolException.
</p>
984 <h3 id=
"HttpRequestPool_send">bool HttpRequestPool::send()
</h3>
985 <p>Send all attached HttpRequest objects in parallel.
</p>
986 <p>Returns TRUE on success, or FALSE on failure.
</p>
987 <p>Throws HttpRequestPoolException (HttpSocketException, HttpRequestException, HttpMalformedHeaderException).
</p>
988 <h3 id=
"HttpRequestPool_socketPerform">protected bool HttpRequestPool::socketPerform()
</h3>
989 <p>Returns TRUE until each request has finished its transaction.
</p>
990 <p>Usage:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
991 <span style=
"color: #0000BB"><?php
<br /></span><span style=
"color: #007700">class
</span><span style=
"color: #0000BB">MyPool
</span><span style=
"color: #007700">extends
</span><span style=
"color: #0000BB">HttpRequestPool
<br /></span><span style=
"color: #007700">{
<br /> public
function
</span><span style=
"color: #0000BB">send
</span><span style=
"color: #007700">()
<br /> {
<br /> while
(
</span><span style=
"color: #0000BB">$this
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">socketPerform
</span><span style=
"color: #007700">())
{
<br /> if
(!
</span><span style=
"color: #0000BB">$this
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">socketSelect
</span><span style=
"color: #007700">())
{
<br /> throw
new
</span><span style=
"color: #0000BB">HttpSocketExcpetion
</span><span style=
"color: #007700">;
<br /> }
<br /> }
<br /> }
<br /> <br /> protected
final
function
</span><span style=
"color: #0000BB">socketPerform
</span><span style=
"color: #007700">()
<br /> {
<br /> </span><span style=
"color: #0000BB">$result
</span><span style=
"color: #007700">=
</span><span style=
"color: #0000BB">parent
</span><span style=
"color: #007700">::
</span><span style=
"color: #0000BB">socketPerform
</span><span style=
"color: #007700">();
<br /> foreach
(
</span><span style=
"color: #0000BB">$this
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">getFinishedRequests
</span><span style=
"color: #007700">()
as
</span><span style=
"color: #0000BB">$r
</span><span style=
"color: #007700">)
{
<br /> </span><span style=
"color: #0000BB">$this
</span><span style=
"color: #007700">-
></span><span style=
"color: #0000BB">detach
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">$r
</span><span style=
"color: #007700">);
<br /> </span><span style=
"color: #FF8000">//
handle
response
of
finished
request
<br /> </span><span style=
"color: #007700">}
<br /> return
</span><span style=
"color: #0000BB">$result
</span><span style=
"color: #007700">;
<br /> }
<br />}
<br /></span><span style=
"color: #0000BB">?
></span><br />
992 </span></code></blockquote></p>
994 <h3 id=
"HttpRequestPool_socketSelect">protected bool HttpRequestPool::socketSelect()
</h3>
995 <p>See HttpRequestPool::socketPerform().
</p>
996 <p>Returns TRUE on success, or FALSE on failure.
</p>
997 <h3 id=
"HttpRequestPool_valid">bool HttpRequestPool::valid()
</h3>
998 <p>Implements Iterator::valid().
</p>
999 <h3 id=
"HttpRequestPool_current">HttpRequest HttpRequestPool::current()
</h3>
1000 <p>Implements Iterator::current().
</p>
1001 <h3 id=
"HttpRequestPool_key">int HttpRequestPool::key()
</h3>
1002 <p>Implements Iterator::key().
</p>
1003 <h3 id=
"HttpRequestPool_next">void HttpRequestPool::next()
</h3>
1004 <p>Implements Iterator::next().
</p>
1005 <h3 id=
"HttpRequestPool_rewind">void HttpRequestPool::rewind()
</h3>
1006 <p>Implements Iterator::rewind().
</p>
1007 <h3 id=
"HttpRequestPool_count">int HttpRequestPool::count()
</h3>
1008 <p>Implements Countable.
</p>
1009 <p>Returns the number of attached HttpRequest objects.
</p>
1010 <h3 id=
"HttpRequestPool_getAttachedRequests">array HttpRequestPool::getAttachedRequests()
</h3>
1011 <p>Get attached HttpRequest objects.
</p>
1012 <p>Returns an array containing all currently attached HttpRequest objects.
</p>
1013 <h3 id=
"HttpRequestPool_getFinishedRequests">array HttpRequestPool::getFinishedRequests()
</h3>
1014 <p>Get attached HttpRequest objects that already have finished their work.
</p>
1015 <p>Returns an array containing all attached HttpRequest objects that
<br />
1016 already have finished their work.
</p>
1018 <h1 id=
"http_response_object.c">http_response_object.c
</h1>
1019 <h2 id=
"HttpResponse" class=
"o">HttpResponse
</h2>
1020 <h3 id=
"HttpResponse_setHeader">static bool HttpResponse::setHeader(string name, mixed value[, bool replace = true])
</h3>
1021 <p>Send an HTTP header.
</p>
1022 <p>Expects a string parameter containing the name of the header and a mixed
<br />
1023 parameter containing the value of the header, which will be converted to
<br />
1024 a string. Additionally accepts an optional boolean parameter, which
<br />
1025 specifies whether an existing header should be replaced. If the second
<br />
1026 parameter is unset no header with this name will be sent.
</p>
1027 <p>Returns TRUE on success, or FALSE on failure.
</p>
1028 <p>Throws HttpHeaderException if http.only_exceptions is TRUE.
</p>
1029 <h3 id=
"HttpResponse_getHeader">static mixed HttpResponse::getHeader([string name])
</h3>
1030 <p>Get header(s) about to be sent.
</p>
1031 <p>Accepts a string as optional parameter which specifies the name of the
<br />
1032 header to read. If the parameter is empty or omitted, an associative array
<br />
1033 with all headers will be returned.
</p>
1034 <p>NOTE: In Apache2 this only works for PHP-
5.1.3 and greater.
</p>
1035 <p>Returns either a string containing the value of the header matching name,
<br />
1036 FALSE on failure, or an associative array with all headers.
</p>
1037 <h3 id=
"HttpResponse_setCache">static bool HttpResponse::setCache(bool cache)
</h3>
1038 <p>Whether it should be attempted to cache the entity.
<br />
1039 This will result in necessary caching headers and checks of clients
<br />
1040 "If-Modified-Since" and
"If-None-Match" headers. If one of those headers
<br />
1041 matches a
"304 Not Modified" status code will be issued.
</p>
1042 <p>NOTE: If you're using sessions, be sure that you set session.cache_limiter
<br />
1043 to something more appropriate than
"no-cache"!
</p>
1044 <p>Expects a boolean as parameter specifying whether caching should be attempted.
</p>
1045 <p>Returns TRUE on success, or FALSE on failure.
</p>
1046 <h3 id=
"HttpResponse_getCache">static bool HttpResponse::getCache()
</h3>
1047 <p>Get current caching setting.
</p>
1048 <p>Returns TRUE if caching should be attempted, else FALSE.
</p>
1049 <h3 id=
"HttpResponse_setGzip">static bool HttpResponse::setGzip(bool gzip)
</h3>
1050 <p>Enable on-thy-fly gzipping of the sent entity.
</p>
1051 <p>Expects a boolean as parameter indicating if GZip compression should be enabled.
</p>
1052 <p>Returns TRUE on success, or FALSE on failure.
</p>
1053 <h3 id=
"HttpResponse_getGzip">static bool HttpResponse::getGzip()
</h3>
1054 <p>Get current gzipping setting.
</p>
1055 <p>Returns TRUE if GZip compression is enabled, else FALSE.
</p>
1056 <h3 id=
"HttpResponse_setCacheControl">static bool HttpResponse::setCacheControl(string control[, int max_age =
0[, bool must_revalidate = true]])
</h3>
1057 <p>Set a custom cache-control header, usually being
"private" or
"public";
<br />
1058 The max_age parameter controls how long the cache entry is valid on the client side.
</p>
1059 <p>Expects a string parameter containing the primary cache control setting.
<br />
1060 Additionally accepts an int parameter specifying the max-age setting.
<br />
1061 Accepts an optional third bool parameter indicating whether the cache
<br />
1062 must be revalidated every request.
</p>
1063 <p>Returns TRUE on success, or FALSE if control does not match one of
<br />
1064 "public" ,
"private" or
"no-cache".
</p>
1065 <p>Throws HttpInvalidParamException if http.only_exceptions is TRUE.
</p>
1066 <h3 id=
"HttpResponse_getCacheControl">static string HttpResponse::getCacheControl()
</h3>
1067 <p>Get current Cache-Control header setting.
</p>
1068 <p>Returns the current cache control setting as a string like sent in a header.
</p>
1069 <h3 id=
"HttpResponse_setContentType">static bool HttpResponse::setContentType(string content_type)
</h3>
1070 <p>Set the content-type of the sent entity.
</p>
1071 <p>Expects a string as parameter specifying the content type of the sent entity.
</p>
1072 <p>Returns TRUE on success, or FALSE if the content type does not seem to
<br />
1073 contain a primary and secondary content type part.
</p>
1074 <p>Throws HttpInvalidParamException if http.only_exceptions is TRUE.
</p>
1075 <h3 id=
"HttpResponse_getContentType">static string HttpResponse::getContentType()
</h3>
1076 <p>Get current Content-Type header setting.
</p>
1077 <p>Returns the currently set content type as string.
</p>
1078 <h3 id=
"HttpResponse_guessContentType">static string HttpResponse::guessContentType(string magic_file[, int magic_mode = MAGIC_MIME])
</h3>
1079 <p>Attempts to guess the content type of supplied payload through libmagic.
<br />
1080 If the attempt is successful, the guessed content type will automatically
<br />
1081 be set as response content type.
</p>
1082 <p>Expects a string parameter specifying the magic.mime database to use.
<br />
1083 Additionally accepts an optional int parameter, being flags for libmagic.
</p>
1084 <p>Returns the guessed content type on success, or FALSE on failure.
</p>
1085 <p>Throws HttpRuntimeException, HttpInvalidParamException
<br />
1086 if http.only_exceptions is TRUE.
</p>
1087 <h3 id=
"HttpResponse_setContentDisposition">static bool HttpResponse::setContentDisposition(string filename[, bool inline = false])
</h3>
1088 <p>Set the Content-Disposition. The Content-Disposition header is very useful
<br />
1089 if the data actually sent came from a file or something similar, that should
<br />
1090 be
"saved" by the client/user (i.e. by browsers
"Save as..." popup window).
</p>
1091 <p>Expects a string parameter specifying the file name the
"Save as..." dialog
<br />
1092 should display. Optionally accepts a bool parameter, which, if set to true
<br />
1093 and the user agent knows how to handle the content type, will probably not
<br />
1094 cause the popup window to be shown.
</p>
1095 <p>Returns TRUE on success or FALSE on failure.
</p>
1096 <h3 id=
"HttpResponse_getContentDisposition">static string HttpResponse::getContentDisposition()
</h3>
1097 <p>Get current Content-Disposition setting.
</p>
1098 <p>Returns the current content disposition as string like sent in a header.
</p>
1099 <h3 id=
"HttpResponse_setETag">static bool HttpResponse::setETag(string etag)
</h3>
1100 <p>Set a custom ETag. Use this only if you know what you're doing.
</p>
1101 <p>Expects an unquoted string as parameter containing the ETag.
</p>
1102 <p>Returns TRUE on success, or FALSE on failure.
</p>
1103 <h3 id=
"HttpResponse_getETag">static string HttpResponse::getETag()
</h3>
1104 <p>Get calculated or previously set custom ETag.
</p>
1105 <p>Returns the calculated or previously set ETag as unquoted string.
</p>
1106 <h3 id=
"HttpResponse_setLastModified">static bool HttpResponse::setLastModified(int timestamp)
</h3>
1107 <p>Set a custom Last-Modified date.
</p>
1108 <p>Expects an unix timestamp as parameter representing the last modification
<br />
1109 time of the sent entity.
</p>
1110 <p>Returns TRUE on success, or FALSE on failure.
</p>
1111 <h3 id=
"HttpResponse_getLastModified">static int HttpResponse::getLastModified()
</h3>
1112 <p>Get calculated or previously set custom Last-Modified date.
</p>
1113 <p>Returns the calculated or previously set unix timestamp.
</p>
1114 <h3 id=
"HttpResponse_setThrottleDelay">static bool HttpResponse::setThrottleDelay(double seconds)
</h3>
1115 <p>Sets the throttle delay for use with HttpResponse::setBufferSize().
</p>
1116 <p>Provides a basic throttling mechanism, which will yield the current process
<br />
1117 resp. thread until the entity has been completely sent, though.
</p>
1118 <p>Note: This doesn't really work with the FastCGI SAPI.
</p>
1119 <p>Expects a double parameter specifying the seconds too sleep() after
<br />
1120 each chunk sent.
</p>
1121 <p>Returns TRUE on success, or FALSE on failure.
</p>
1122 <h3 id=
"HttpResponse_getThrottleDelay">static double HttpResponse::getThrottleDelay()
</h3>
1123 <p>Get the current throttle delay.
</p>
1124 <p>Returns a double representing the throttle delay in seconds.
</p>
1125 <h3 id=
"HttpResponse_setBufferSize">static bool HttpResponse::setBufferSize(int bytes)
</h3>
1126 <p>Sets the send buffer size for use with HttpResponse::setThrottleDelay().
</p>
1127 <p>Provides a basic throttling mechanism, which will yield the current process
<br />
1128 resp. thread until the entity has been completely sent, though.
</p>
1129 <p>Note: This doesn't really work with the FastCGI SAPI.
</p>
1130 <p>Expects an int parameter representing the chunk size in bytes.
</p>
1131 <p>Returns TRUE on success, or FALSE on failure.
</p>
1132 <h3 id=
"HttpResponse_getBufferSize">static int HttpResponse::getBufferSize()
</h3>
1133 <p>Get current buffer size.
</p>
1134 <p>Returns an int representing the current buffer size in bytes.
</p>
1135 <h3 id=
"HttpResponse_setData">static bool HttpResponse::setData(mixed data)
</h3>
1136 <p>Set the data to be sent.
</p>
1137 <p>Expects one parameter, which will be converted to a string and contains
<br />
1138 the data to send.
</p>
1139 <p>Returns TRUE on success, or FALSE on failure.
</p>
1140 <h3 id=
"HttpResponse_getData">static string HttpResponse::getData()
</h3>
1141 <p>Get the previously set data to be sent.
</p>
1142 <p>Returns a string containing the previously set data to send.
</p>
1143 <h3 id=
"HttpResponse_setStream">static bool HttpResponse::setStream(resource stream)
</h3>
1144 <p>Set the resource to be sent.
</p>
1145 <p>Expects a resource parameter referencing an already opened stream from
<br />
1146 which the data to send will be read.
</p>
1147 <p>Returns TRUE on success, or FALSE on failure.
</p>
1148 <h3 id=
"HttpResponse_getStream">static resource HttpResponse::getStream()
</h3>
1149 <p>Get the previously set resource to be sent.
</p>
1150 <p>Returns the previously set resource.
</p>
1151 <h3 id=
"HttpResponse_setFile">static bool HttpResponse::setFile(string file)
</h3>
1152 <p>Set the file to be sent.
</p>
1153 <p>Expects a string as parameter, specifying the path to the file to send.
</p>
1154 <p>Returns TRUE on success, or FALSE on failure.
</p>
1155 <h3 id=
"HttpResponse_getFile">static string HttpResponse::getFile()
</h3>
1156 <p>Get the previously set file to be sent.
</p>
1157 <p>Returns the previously set path to the file to send as string.
</p>
1158 <h3 id=
"HttpResponse_send">static bool HttpResponse::send([bool clean_ob = true])
</h3>
1159 <p>Finally send the entity.
</p>
1160 <p>Accepts an optional boolean parameter, specifying whether the output
<br />
1161 buffers should be discarded prior sending. A successful caching attempt
<br />
1162 will cause a script termination, and write a log entry if the INI setting
<br />
1163 http.cache_log is set.
</p>
1164 <p>Returns TRUE on success, or FALSE on failure.
</p>
1165 <p>Throws HttpHeaderException, HttpResponseException if http.only_exceptions is TRUE.
</p>
1166 <p>Example:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
1167 <span style=
"color: #0000BB"><?php
<br />HttpResponse
</span><span style=
"color: #007700">::
</span><span style=
"color: #0000BB">setCache
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">true
</span><span style=
"color: #007700">);
<br /></span><span style=
"color: #0000BB">HttpResponse
</span><span style=
"color: #007700">::
</span><span style=
"color: #0000BB">setContentType
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">'application/pdf'
</span><span style=
"color: #007700">);
<br /></span><span style=
"color: #0000BB">HttpResponse
</span><span style=
"color: #007700">::
</span><span style=
"color: #0000BB">setContentDisposition
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">"$user.pdf"</span><span style=
"color: #007700">,
</span><span style=
"color: #0000BB">false
</span><span style=
"color: #007700">);
<br /></span><span style=
"color: #0000BB">HttpResponse
</span><span style=
"color: #007700">::
</span><span style=
"color: #0000BB">setFile
</span><span style=
"color: #007700">(
</span><span style=
"color: #DD0000">'sheet.pdf'
</span><span style=
"color: #007700">);
<br /></span><span style=
"color: #0000BB">HttpResponse
</span><span style=
"color: #007700">::
</span><span style=
"color: #0000BB">send
</span><span style=
"color: #007700">();
<br /></span><span style=
"color: #0000BB">?
></span><br />
1168 </span></code></blockquote></p>
1170 <h3 id=
"HttpResponse_capture">static void HttpResponse::capture()
</h3>
1171 <p>Capture script output.
</p>
1172 <p>Example:
</p><pre><blockquote><code><span style=
"color: #000000"><br />
1173 <span style=
"color: #0000BB"><?php
<br />HttpResponse
</span><span style=
"color: #007700">::
</span><span style=
"color: #0000BB">setCache
</span><span style=
"color: #007700">(
</span><span style=
"color: #0000BB">true
</span><span style=
"color: #007700">);
<br /></span><span style=
"color: #0000BB">HttpResponse
</span><span style=
"color: #007700">::
</span><span style=
"color: #0000BB">capture
</span><span style=
"color: #007700">();
<br /></span><span style=
"color: #FF8000">//
script
follows
<br /></span><span style=
"color: #0000BB">?
></span><br />
1174 </span></code></blockquote></p>
1177 <div class=
"toc"><strong>Table of Contents
</strong>
1179 <li><a class=
"tocfile" href=
"#http_functions.c">http_functions.c
</a>
1181 <li><a href=
"#http_date">http_date
</a>
1183 <li><a href=
"#http_build_url">http_build_url
</a>
1185 <li><a href=
"#http_build_str">http_build_str
</a>
1187 <li><a href=
"#http_negotiate_language">http_negotiate_language
</a>
1189 <li><a href=
"#http_negotiate_charset">http_negotiate_charset
</a>
1191 <li><a href=
"#http_negotiate_content_type">http_negotiate_content_type
</a>
1193 <li><a href=
"#http_send_status">http_send_status
</a>
1195 <li><a href=
"#http_send_last_modified">http_send_last_modified
</a>
1197 <li><a href=
"#http_send_content_type">http_send_content_type
</a>
1199 <li><a href=
"#http_send_content_disposition">http_send_content_disposition
</a>
1201 <li><a href=
"#http_match_modified">http_match_modified
</a>
1203 <li><a href=
"#http_match_etag">http_match_etag
</a>
1205 <li><a href=
"#http_cache_last_modified">http_cache_last_modified
</a>
1207 <li><a href=
"#http_cache_etag">http_cache_etag
</a>
1209 <li><a href=
"#ob_etaghandler">ob_etaghandler
</a>
1211 <li><a href=
"#http_throttle">http_throttle
</a>
1213 <li><a href=
"#http_redirect">http_redirect
</a>
1215 <li><a href=
"#http_send_data">http_send_data
</a>
1217 <li><a href=
"#http_send_file">http_send_file
</a>
1219 <li><a href=
"#http_send_stream">http_send_stream
</a>
1221 <li><a href=
"#http_chunked_decode">http_chunked_decode
</a>
1223 <li><a href=
"#http_parse_message">http_parse_message
</a>
1225 <li><a href=
"#http_parse_headers">http_parse_headers
</a>
1227 <li><a href=
"#http_parse_cookie">http_parse_cookie
</a>
1229 <li><a href=
"#http_parse_params">http_parse_params
</a>
1231 <li><a href=
"#http_get_request_headers">http_get_request_headers
</a>
1233 <li><a href=
"#http_get_request_body">http_get_request_body
</a>
1235 <li><a href=
"#http_get_request_body_stream">http_get_request_body_stream
</a>
1237 <li><a href=
"#http_match_request_header">http_match_request_header
</a>
1239 <li><a href=
"#http_get">http_get
</a>
1241 <li><a href=
"#http_head">http_head
</a>
1243 <li><a href=
"#http_post_data">http_post_data
</a>
1245 <li><a href=
"#http_post_fields">http_post_fields
</a>
1247 <li><a href=
"#http_put_file">http_put_file
</a>
1249 <li><a href=
"#http_put_stream">http_put_stream
</a>
1251 <li><a href=
"#http_put_data">http_put_data
</a>
1253 <li><a href=
"#http_request">http_request
</a>
1255 <li><a href=
"#http_request_body_encode">http_request_body_encode
</a>
1257 <li><a href=
"#http_request_method_register">http_request_method_register
</a>
1259 <li><a href=
"#http_request_method_unregister">http_request_method_unregister
</a>
1261 <li><a href=
"#http_request_method_exists">http_request_method_exists
</a>
1263 <li><a href=
"#http_request_method_name">http_request_method_name
</a>
1265 <li><a href=
"#http_deflate">http_deflate
</a>
1267 <li><a href=
"#http_inflate">http_inflate
</a>
1269 <li><a href=
"#ob_deflatehandler">ob_deflatehandler
</a>
1271 <li><a href=
"#ob_inflatehandler">ob_inflatehandler
</a>
1273 <li><a href=
"#http_support">http_support
</a>
1277 <li><a class=
"tocfile" href=
"#http_deflatestream_object.c">http_deflatestream_object.c
</a>
1279 <li><a href=
"#HttpDeflateStream___construct">HttpDeflateStream::__construct()
</a></li>
1280 <li><a href=
"#HttpDeflateStream_update">HttpDeflateStream::update()
</a></li>
1281 <li><a href=
"#HttpDeflateStream_flush">HttpDeflateStream::flush()
</a></li>
1282 <li><a href=
"#HttpDeflateStream_finish">HttpDeflateStream::finish()
</a></li>
1286 <li><a class=
"tocfile" href=
"#http_inflatestream_object.c">http_inflatestream_object.c
</a>
1288 <li><a href=
"#HttpInflateStream___construct">HttpInflateStream::__construct()
</a></li>
1289 <li><a href=
"#HttpInflateStream_update">HttpInflateStream::update()
</a></li>
1290 <li><a href=
"#HttpInflateStream_flush">HttpInflateStream::flush()
</a></li>
1291 <li><a href=
"#HttpInflateStream_finish">HttpInflateStream::finish()
</a></li>
1295 <li><a class=
"tocfile" href=
"#http_message_object.c">http_message_object.c
</a>
1297 <li><a href=
"#HttpMessage___construct">HttpMessage::__construct()
</a></li>
1298 <li><a href=
"#HttpMessage_fromString">HttpMessage::fromString()
</a></li>
1299 <li><a href=
"#HttpMessage_getBody">HttpMessage::getBody()
</a></li>
1300 <li><a href=
"#HttpMessage_setBody">HttpMessage::setBody()
</a></li>
1301 <li><a href=
"#HttpMessage_getHeader">HttpMessage::getHeader()
</a></li>
1302 <li><a href=
"#HttpMessage_getHeaders">HttpMessage::getHeaders()
</a></li>
1303 <li><a href=
"#HttpMessage_setHeaders">HttpMessage::setHeaders()
</a></li>
1304 <li><a href=
"#HttpMessage_addHeaders">HttpMessage::addHeaders()
</a></li>
1305 <li><a href=
"#HttpMessage_getType">HttpMessage::getType()
</a></li>
1306 <li><a href=
"#HttpMessage_setType">HttpMessage::setType()
</a></li>
1307 <li><a href=
"#HttpMessage_getResponseCode">HttpMessage::getResponseCode()
</a></li>
1308 <li><a href=
"#HttpMessage_setResponseCode">HttpMessage::setResponseCode()
</a></li>
1309 <li><a href=
"#HttpMessage_getResponseStatus">HttpMessage::getResponseStatus()
</a></li>
1310 <li><a href=
"#HttpMessage_setResponseStatus">HttpMessage::setResponseStatus()
</a></li>
1311 <li><a href=
"#HttpMessage_getRequestMethod">HttpMessage::getRequestMethod()
</a></li>
1312 <li><a href=
"#HttpMessage_setRequestMethod">HttpMessage::setRequestMethod()
</a></li>
1313 <li><a href=
"#HttpMessage_getRequestUrl">HttpMessage::getRequestUrl()
</a></li>
1314 <li><a href=
"#HttpMessage_setRequestUrl">HttpMessage::setRequestUrl()
</a></li>
1315 <li><a href=
"#HttpMessage_getHttpVersion">HttpMessage::getHttpVersion()
</a></li>
1316 <li><a href=
"#HttpMessage_setHttpVersion">HttpMessage::setHttpVersion()
</a></li>
1317 <li><a href=
"#HttpMessage_guessContentType">HttpMessage::guessContentType()
</a></li>
1318 <li><a href=
"#HttpMessage_getParentMessage">HttpMessage::getParentMessage()
</a></li>
1319 <li><a href=
"#HttpMessage_send">HttpMessage::send()
</a></li>
1320 <li><a href=
"#HttpMessage_toString">HttpMessage::toString()
</a></li>
1321 <li><a href=
"#HttpMessage_toMessageTypeObject">HttpMessage::toMessageTypeObject()
</a></li>
1322 <li><a href=
"#HttpMessage_count">HttpMessage::count()
</a></li>
1323 <li><a href=
"#HttpMessage_serialize">HttpMessage::serialize()
</a></li>
1324 <li><a href=
"#HttpMessage_unserialize">HttpMessage::unserialize()
</a></li>
1325 <li><a href=
"#HttpMessage_detach">HttpMessage::detach()
</a></li>
1326 <li><a href=
"#HttpMessage_prepend">HttpMessage::prepend()
</a></li>
1327 <li><a href=
"#HttpMessage_reverse">HttpMessage::reverse()
</a></li>
1328 <li><a href=
"#HttpMessage_rewind">HttpMessage::rewind()
</a></li>
1329 <li><a href=
"#HttpMessage_valid">HttpMessage::valid()
</a></li>
1330 <li><a href=
"#HttpMessage_next">HttpMessage::next()
</a></li>
1331 <li><a href=
"#HttpMessage_key">HttpMessage::key()
</a></li>
1332 <li><a href=
"#HttpMessage_current">HttpMessage::current()
</a></li>
1336 <li><a class=
"tocfile" href=
"#http_querystring_object.c">http_querystring_object.c
</a>
1338 <li><a href=
"#HttpQueryString___construct">HttpQueryString::__construct()
</a></li>
1339 <li><a href=
"#HttpQueryString_toString">HttpQueryString::toString()
</a></li>
1340 <li><a href=
"#HttpQueryString_toArray">HttpQueryString::toArray()
</a></li>
1341 <li><a href=
"#HttpQueryString_get">HttpQueryString::get()
</a></li>
1342 <li><a href=
"#HttpQueryString_set">HttpQueryString::set()
</a></li>
1343 <li><a href=
"#HttpQueryString_mod">HttpQueryString::mod()
</a></li>
1344 <li><a href=
"#HttpQueryString_singleton">HttpQueryString::singleton()
</a></li>
1345 <li><a href=
"#HttpQueryString_xlate">HttpQueryString::xlate()
</a></li>
1346 <li><a href=
"#HttpQueryString_serialize">HttpQueryString::serialize()
</a></li>
1347 <li><a href=
"#HttpQueryString_unserialize">HttpQueryString::unserialize()
</a></li>
1348 <li><a href=
"#HttpQueryString_offsetGet">HttpQueryString::offsetGet()
</a></li>
1349 <li><a href=
"#HttpQueryString_offsetSet">HttpQueryString::offsetSet()
</a></li>
1350 <li><a href=
"#HttpQueryString_offsetExists">HttpQueryString::offsetExists()
</a></li>
1351 <li><a href=
"#HttpQueryString_offsetUnset">HttpQueryString::offsetUnset()
</a></li>
1355 <li><a class=
"tocfile" href=
"#http_request_object.c">http_request_object.c
</a>
1357 <li><a href=
"#HttpRequest___construct">HttpRequest::__construct()
</a></li>
1358 <li><a href=
"#HttpRequest_setOptions">HttpRequest::setOptions()
</a></li>
1359 <li><a href=
"#HttpRequest_getOptions">HttpRequest::getOptions()
</a></li>
1360 <li><a href=
"#HttpRequest_setSslOptions">HttpRequest::setSslOptions()
</a></li>
1361 <li><a href=
"#HttpRequest_addSslOptions">HttpRequest::addSslOptions()
</a></li>
1362 <li><a href=
"#HttpRequest_getSslOptions">HttpRequest::getSslOptions()
</a></li>
1363 <li><a href=
"#HttpRequest_addHeaders">HttpRequest::addHeaders()
</a></li>
1364 <li><a href=
"#HttpRequest_setHeaders">HttpRequest::setHeaders()
</a></li>
1365 <li><a href=
"#HttpRequest_getHeaders">HttpRequest::getHeaders()
</a></li>
1366 <li><a href=
"#HttpRequest_setCookies">HttpRequest::setCookies()
</a></li>
1367 <li><a href=
"#HttpRequest_addCookies">HttpRequest::addCookies()
</a></li>
1368 <li><a href=
"#HttpRequest_getCookies">HttpRequest::getCookies()
</a></li>
1369 <li><a href=
"#HttpRequest_enableCookies">HttpRequest::enableCookies()
</a></li>
1370 <li><a href=
"#HttpRequest_resetCookies">HttpRequest::resetCookies()
</a></li>
1371 <li><a href=
"#HttpRequest_setUrl">HttpRequest::setUrl()
</a></li>
1372 <li><a href=
"#HttpRequest_getUrl">HttpRequest::getUrl()
</a></li>
1373 <li><a href=
"#HttpRequest_setMethod">HttpRequest::setMethod()
</a></li>
1374 <li><a href=
"#HttpRequest_getMethod">HttpRequest::getMethod()
</a></li>
1375 <li><a href=
"#HttpRequest_setContentType">HttpRequest::setContentType()
</a></li>
1376 <li><a href=
"#HttpRequest_getContentType">HttpRequest::getContentType()
</a></li>
1377 <li><a href=
"#HttpRequest_setQueryData">HttpRequest::setQueryData()
</a></li>
1378 <li><a href=
"#HttpRequest_getQueryData">HttpRequest::getQueryData()
</a></li>
1379 <li><a href=
"#HttpRequest_addQueryData">HttpRequest::addQueryData()
</a></li>
1380 <li><a href=
"#HttpRequest_addPostFields">HttpRequest::addPostFields()
</a></li>
1381 <li><a href=
"#HttpRequest_setPostFields">HttpRequest::setPostFields()
</a></li>
1382 <li><a href=
"#HttpRequest_getPostFields">HttpRequest::getPostFields()
</a></li>
1383 <li><a href=
"#HttpRequest_setRawPostData">HttpRequest::setRawPostData()
</a></li>
1384 <li><a href=
"#HttpRequest_addRawPostData">HttpRequest::addRawPostData()
</a></li>
1385 <li><a href=
"#HttpRequest_getRawPostData">HttpRequest::getRawPostData()
</a></li>
1386 <li><a href=
"#HttpRequest_addPostFile">HttpRequest::addPostFile()
</a></li>
1387 <li><a href=
"#HttpRequest_setPostFiles">HttpRequest::setPostFiles()
</a></li>
1388 <li><a href=
"#HttpRequest_getPostFiles">HttpRequest::getPostFiles()
</a></li>
1389 <li><a href=
"#HttpRequest_setPutFile">HttpRequest::setPutFile()
</a></li>
1390 <li><a href=
"#HttpRequest_getPutFile">HttpRequest::getPutFile()
</a></li>
1391 <li><a href=
"#HttpRequest_setPutData">HttpRequest::setPutData()
</a></li>
1392 <li><a href=
"#HttpRequest_addPutData">HttpRequest::addPutData()
</a></li>
1393 <li><a href=
"#HttpRequest_getPutData">HttpRequest::getPutData()
</a></li>
1394 <li><a href=
"#HttpRequest_getResponseData">HttpRequest::getResponseData()
</a></li>
1395 <li><a href=
"#HttpRequest_getResponseHeader">HttpRequest::getResponseHeader()
</a></li>
1396 <li><a href=
"#HttpRequest_getResponseCookies">HttpRequest::getResponseCookies()
</a></li>
1397 <li><a href=
"#HttpRequest_getResponseBody">HttpRequest::getResponseBody()
</a></li>
1398 <li><a href=
"#HttpRequest_getResponseCode">HttpRequest::getResponseCode()
</a></li>
1399 <li><a href=
"#HttpRequest_getResponseStatus">HttpRequest::getResponseStatus()
</a></li>
1400 <li><a href=
"#HttpRequest_getResponseInfo">HttpRequest::getResponseInfo()
</a></li>
1401 <li><a href=
"#HttpRequest_getResponseMessage">HttpRequest::getResponseMessage()
</a></li>
1402 <li><a href=
"#HttpRequest_getRequestMessage">HttpRequest::getRequestMessage()
</a></li>
1403 <li><a href=
"#HttpRequest_getRawRequestMessage">HttpRequest::getRawRequestMessage()
</a></li>
1404 <li><a href=
"#HttpRequest_getRawResponseMessage">HttpRequest::getRawResponseMessage()
</a></li>
1405 <li><a href=
"#HttpRequest_getHistory">HttpRequest::getHistory()
</a></li>
1406 <li><a href=
"#HttpRequest_clearHistory">HttpRequest::clearHistory()
</a></li>
1407 <li><a href=
"#HttpRequest_send">HttpRequest::send()
</a></li>
1411 <li><a class=
"tocfile" href=
"#http_requestpool_object.c">http_requestpool_object.c
</a>
1413 <li><a href=
"#HttpRequestPool___construct">HttpRequestPool::__construct()
</a></li>
1414 <li><a href=
"#HttpRequestPool___destruct">HttpRequestPool::__destruct()
</a></li>
1415 <li><a href=
"#HttpRequestPool_reset">HttpRequestPool::reset()
</a></li>
1416 <li><a href=
"#HttpRequestPool_attach">HttpRequestPool::attach()
</a></li>
1417 <li><a href=
"#HttpRequestPool_detach">HttpRequestPool::detach()
</a></li>
1418 <li><a href=
"#HttpRequestPool_send">HttpRequestPool::send()
</a></li>
1419 <li><a href=
"#HttpRequestPool_socketPerform">HttpRequestPool::socketPerform()
</a></li>
1420 <li><a href=
"#HttpRequestPool_socketSelect">HttpRequestPool::socketSelect()
</a></li>
1421 <li><a href=
"#HttpRequestPool_valid">HttpRequestPool::valid()
</a></li>
1422 <li><a href=
"#HttpRequestPool_current">HttpRequestPool::current()
</a></li>
1423 <li><a href=
"#HttpRequestPool_key">HttpRequestPool::key()
</a></li>
1424 <li><a href=
"#HttpRequestPool_next">HttpRequestPool::next()
</a></li>
1425 <li><a href=
"#HttpRequestPool_rewind">HttpRequestPool::rewind()
</a></li>
1426 <li><a href=
"#HttpRequestPool_count">HttpRequestPool::count()
</a></li>
1427 <li><a href=
"#HttpRequestPool_getAttachedRequests">HttpRequestPool::getAttachedRequests()
</a></li>
1428 <li><a href=
"#HttpRequestPool_getFinishedRequests">HttpRequestPool::getFinishedRequests()
</a></li>
1432 <li><a class=
"tocfile" href=
"#http_response_object.c">http_response_object.c
</a>
1434 <li><a href=
"#HttpResponse_setHeader">HttpResponse::setHeader()
</a></li>
1435 <li><a href=
"#HttpResponse_getHeader">HttpResponse::getHeader()
</a></li>
1436 <li><a href=
"#HttpResponse_setCache">HttpResponse::setCache()
</a></li>
1437 <li><a href=
"#HttpResponse_getCache">HttpResponse::getCache()
</a></li>
1438 <li><a href=
"#HttpResponse_setGzip">HttpResponse::setGzip()
</a></li>
1439 <li><a href=
"#HttpResponse_getGzip">HttpResponse::getGzip()
</a></li>
1440 <li><a href=
"#HttpResponse_setCacheControl">HttpResponse::setCacheControl()
</a></li>
1441 <li><a href=
"#HttpResponse_getCacheControl">HttpResponse::getCacheControl()
</a></li>
1442 <li><a href=
"#HttpResponse_setContentType">HttpResponse::setContentType()
</a></li>
1443 <li><a href=
"#HttpResponse_getContentType">HttpResponse::getContentType()
</a></li>
1444 <li><a href=
"#HttpResponse_guessContentType">HttpResponse::guessContentType()
</a></li>
1445 <li><a href=
"#HttpResponse_setContentDisposition">HttpResponse::setContentDisposition()
</a></li>
1446 <li><a href=
"#HttpResponse_getContentDisposition">HttpResponse::getContentDisposition()
</a></li>
1447 <li><a href=
"#HttpResponse_setETag">HttpResponse::setETag()
</a></li>
1448 <li><a href=
"#HttpResponse_getETag">HttpResponse::getETag()
</a></li>
1449 <li><a href=
"#HttpResponse_setLastModified">HttpResponse::setLastModified()
</a></li>
1450 <li><a href=
"#HttpResponse_getLastModified">HttpResponse::getLastModified()
</a></li>
1451 <li><a href=
"#HttpResponse_setThrottleDelay">HttpResponse::setThrottleDelay()
</a></li>
1452 <li><a href=
"#HttpResponse_getThrottleDelay">HttpResponse::getThrottleDelay()
</a></li>
1453 <li><a href=
"#HttpResponse_setBufferSize">HttpResponse::setBufferSize()
</a></li>
1454 <li><a href=
"#HttpResponse_getBufferSize">HttpResponse::getBufferSize()
</a></li>
1455 <li><a href=
"#HttpResponse_setData">HttpResponse::setData()
</a></li>
1456 <li><a href=
"#HttpResponse_getData">HttpResponse::getData()
</a></li>
1457 <li><a href=
"#HttpResponse_setStream">HttpResponse::setStream()
</a></li>
1458 <li><a href=
"#HttpResponse_getStream">HttpResponse::getStream()
</a></li>
1459 <li><a href=
"#HttpResponse_setFile">HttpResponse::setFile()
</a></li>
1460 <li><a href=
"#HttpResponse_getFile">HttpResponse::getFile()
</a></li>
1461 <li><a href=
"#HttpResponse_send">HttpResponse::send()
</a></li>
1462 <li><a href=
"#HttpResponse_capture">HttpResponse::capture()
</a></li>
1468 <p><b>Generated at: Fri,
07 Jul
2006 21:
23:
59 +
0200</b></p>
projects / m6w6 / ext-http / blob