… | |
… | |
46 | use AnyEvent::Util (); |
46 | use AnyEvent::Util (); |
47 | use AnyEvent::Handle (); |
47 | use AnyEvent::Handle (); |
48 | |
48 | |
49 | use base Exporter::; |
49 | use base Exporter::; |
50 | |
50 | |
51 | our $VERSION = '2.13'; |
51 | our $VERSION = '2.15'; |
52 | |
52 | |
53 | our @EXPORT = qw(http_get http_post http_head http_request); |
53 | our @EXPORT = qw(http_get http_post http_head http_request); |
54 | |
54 | |
55 | our $USERAGENT = "Mozilla/5.0 (compatible; U; AnyEvent-HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)"; |
55 | our $USERAGENT = "Mozilla/5.0 (compatible; U; AnyEvent-HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)"; |
56 | our $MAX_RECURSE = 10; |
56 | our $MAX_RECURSE = 10; |
… | |
… | |
123 | C<590>-C<599> and the C<Reason> pseudo-header will contain an error |
123 | C<590>-C<599> and the C<Reason> pseudo-header will contain an error |
124 | message. Currently the following status codes are used: |
124 | message. Currently the following status codes are used: |
125 | |
125 | |
126 | =over 4 |
126 | =over 4 |
127 | |
127 | |
128 | =item 595 - errors during connection etsbalishment, proxy handshake. |
128 | =item 595 - errors during connection establishment, proxy handshake. |
129 | |
129 | |
130 | =item 596 - errors during TLS negotiation, request sending and header processing. |
130 | =item 596 - errors during TLS negotiation, request sending and header processing. |
131 | |
131 | |
132 | =item 597 - errors during body receiving or processing. |
132 | =item 597 - errors during body receiving or processing. |
133 | |
133 | |
… | |
… | |
154 | |
154 | |
155 | =over 4 |
155 | =over 4 |
156 | |
156 | |
157 | =item recurse => $count (default: $MAX_RECURSE) |
157 | =item recurse => $count (default: $MAX_RECURSE) |
158 | |
158 | |
159 | Whether to recurse requests or not, e.g. on redirects, authentication |
159 | Whether to recurse requests or not, e.g. on redirects, authentication and |
160 | retries and so on, and how often to do so. |
160 | other retries and so on, and how often to do so. |
161 | |
161 | |
162 | =item headers => hashref |
162 | =item headers => hashref |
163 | |
163 | |
164 | The request headers to use. Currently, C<http_request> may provide its own |
164 | The request headers to use. Currently, C<http_request> may provide its own |
165 | C<Host:>, C<Content-Length:>, C<Connection:> and C<Cookie:> headers and |
165 | C<Host:>, C<Content-Length:>, C<Connection:> and C<Cookie:> headers and |
… | |
… | |
1050 | _destroy_state %state; |
1050 | _destroy_state %state; |
1051 | |
1051 | |
1052 | %state = (); |
1052 | %state = (); |
1053 | $state{recurse} = |
1053 | $state{recurse} = |
1054 | http_request ( |
1054 | http_request ( |
1055 | $method => $url, |
1055 | $method => $url, |
1056 | %arg, |
1056 | %arg, |
|
|
1057 | recurse => $recurse - 1, |
1057 | keepalive => 0, |
1058 | keepalive => 0, |
1058 | sub { |
1059 | sub { |
1059 | %state = (); |
1060 | %state = (); |
1060 | &$cb |
1061 | &$cb |
1061 | } |
1062 | } |
… | |
… | |
1193 | Sets the default proxy server to use. The proxy-url must begin with a |
1194 | Sets the default proxy server to use. The proxy-url must begin with a |
1194 | string of the form C<http://host:port>, croaks otherwise. |
1195 | string of the form C<http://host:port>, croaks otherwise. |
1195 | |
1196 | |
1196 | To clear an already-set proxy, use C<undef>. |
1197 | To clear an already-set proxy, use C<undef>. |
1197 | |
1198 | |
1198 | When AnyEvent::HTTP is laoded for the first time it will query the |
1199 | When AnyEvent::HTTP is loaded for the first time it will query the |
1199 | default proxy from the operating system, currently by looking at |
1200 | default proxy from the operating system, currently by looking at |
1200 | C<$ENV{http_proxy>}. |
1201 | C<$ENV{http_proxy>}. |
1201 | |
1202 | |
1202 | =item AnyEvent::HTTP::cookie_jar_expire $jar[, $session_end] |
1203 | =item AnyEvent::HTTP::cookie_jar_expire $jar[, $session_end] |
1203 | |
1204 | |
… | |
… | |
1215 | |
1216 | |
1216 | The key C<version> has to contain C<1>, otherwise the hash gets |
1217 | The key C<version> has to contain C<1>, otherwise the hash gets |
1217 | emptied. All other keys are hostnames or IP addresses pointing to |
1218 | emptied. All other keys are hostnames or IP addresses pointing to |
1218 | hash-references. The key for these inner hash references is the |
1219 | hash-references. The key for these inner hash references is the |
1219 | server path for which this cookie is meant, and the values are again |
1220 | server path for which this cookie is meant, and the values are again |
1220 | hash-references. The keys of those hash-references is the cookie name, and |
1221 | hash-references. Each key of those hash-references is a cookie name, and |
1221 | the value, you guessed it, is another hash-reference, this time with the |
1222 | the value, you guessed it, is another hash-reference, this time with the |
1222 | key-value pairs from the cookie, except for C<expires> and C<max-age>, |
1223 | key-value pairs from the cookie, except for C<expires> and C<max-age>, |
1223 | which have been replaced by a C<_expires> key that contains the cookie |
1224 | which have been replaced by a C<_expires> key that contains the cookie |
1224 | expiry timestamp. |
1225 | expiry timestamp. Session cookies are indicated by not having an |
|
|
1226 | C<_expires> key. |
1225 | |
1227 | |
1226 | Here is an example of a cookie jar with a single cookie, so you have a |
1228 | Here is an example of a cookie jar with a single cookie, so you have a |
1227 | chance of understanding the above paragraph: |
1229 | chance of understanding the above paragraph: |
1228 | |
1230 | |
1229 | { |
1231 | { |
… | |
… | |
1328 | # other formats fail in the loop below |
1330 | # other formats fail in the loop below |
1329 | |
1331 | |
1330 | for (0..11) { |
1332 | for (0..11) { |
1331 | if ($m eq $month[$_]) { |
1333 | if ($m eq $month[$_]) { |
1332 | require Time::Local; |
1334 | require Time::Local; |
1333 | return Time::Local::timegm ($S, $M, $H, $d, $_, $y); |
1335 | return eval { Time::Local::timegm ($S, $M, $H, $d, $_, $y) }; |
1334 | } |
1336 | } |
1335 | } |
1337 | } |
1336 | |
1338 | |
1337 | undef |
1339 | undef |
1338 | } |
1340 | } |