ViewVC Help
View File | Revision Log | Show Annotations | Download File
/cvs/AnyEvent-HTTP/HTTP.pm
(Generate patch)

Comparing AnyEvent-HTTP/HTTP.pm (file contents):
Revision 1.16 by root, Fri Jun 6 12:57:48 2008 UTC vs.
Revision 1.41 by root, Sun Jul 5 23:50:59 2009 UTC

3AnyEvent::HTTP - simple but non-blocking HTTP/HTTPS client 3AnyEvent::HTTP - simple but non-blocking HTTP/HTTPS client
4 4
5=head1 SYNOPSIS 5=head1 SYNOPSIS
6 6
7 use AnyEvent::HTTP; 7 use AnyEvent::HTTP;
8
9 http_get "http://www.nethype.de/", sub { print $_[1] };
10
11 # ... do something else here
8 12
9=head1 DESCRIPTION 13=head1 DESCRIPTION
10 14
11This module is an L<AnyEvent> user, you need to make sure that you use and 15This module is an L<AnyEvent> user, you need to make sure that you use and
12run a supported event loop. 16run a supported event loop.
35package AnyEvent::HTTP; 39package AnyEvent::HTTP;
36 40
37use strict; 41use strict;
38no warnings; 42no warnings;
39 43
40use Carp; 44use Errno ();
41 45
42use AnyEvent (); 46use AnyEvent 4.452 ();
43use AnyEvent::Util (); 47use AnyEvent::Util ();
44use AnyEvent::Socket (); 48use AnyEvent::Socket ();
45use AnyEvent::Handle (); 49use AnyEvent::Handle ();
46 50
47use base Exporter::; 51use base Exporter::;
48 52
49our $VERSION = '1.01'; 53our $VERSION = '1.12';
50 54
51our @EXPORT = qw(http_get http_request); 55our @EXPORT = qw(http_get http_post http_head http_request);
52 56
53our $USERAGENT = "Mozilla/5.0 (compatible; AnyEvent::HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)"; 57our $USERAGENT = "Mozilla/5.0 (compatible; U; AnyEvent-HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)";
54our $MAX_RECURSE = 10; 58our $MAX_RECURSE = 10;
55our $MAX_PERSISTENT = 8; 59our $MAX_PERSISTENT = 8;
56our $PERSISTENT_TIMEOUT = 2; 60our $PERSISTENT_TIMEOUT = 2;
57our $TIMEOUT = 300; 61our $TIMEOUT = 300;
58 62
67my %CO_SLOT; # number of open connections, and wait queue, per host 71my %CO_SLOT; # number of open connections, and wait queue, per host
68 72
69=item http_get $url, key => value..., $cb->($data, $headers) 73=item http_get $url, key => value..., $cb->($data, $headers)
70 74
71Executes an HTTP-GET request. See the http_request function for details on 75Executes an HTTP-GET request. See the http_request function for details on
72additional parameters. 76additional parameters and the return value.
73 77
74=item http_head $url, key => value..., $cb->($data, $headers) 78=item http_head $url, key => value..., $cb->($data, $headers)
75 79
76Executes an HTTP-HEAD request. See the http_request function for details on 80Executes an HTTP-HEAD request. See the http_request function for details
77additional parameters. 81on additional parameters and the return value.
78 82
79=item http_post $url, $body, key => value..., $cb->($data, $headers) 83=item http_post $url, $body, key => value..., $cb->($data, $headers)
80 84
81Executes an HTTP-POST request with a request body of C<$bod>. See the 85Executes an HTTP-POST request with a request body of C<$body>. See the
82http_request function for details on additional parameters. 86http_request function for details on additional parameters and the return
87value.
83 88
84=item http_request $method => $url, key => value..., $cb->($data, $headers) 89=item http_request $method => $url, key => value..., $cb->($data, $headers)
85 90
86Executes a HTTP request of type C<$method> (e.g. C<GET>, C<POST>). The URL 91Executes a HTTP request of type C<$method> (e.g. C<GET>, C<POST>). The URL
87must be an absolute http or https URL. 92must be an absolute http or https URL.
93
94When called in void context, nothing is returned. In other contexts,
95C<http_request> returns a "cancellation guard" - you have to keep the
96object at least alive until the callback get called. If the object gets
97destroyed before the callbakc is called, the request will be cancelled.
88 98
89The callback will be called with the response data as first argument 99The callback will be called with the response data as first argument
90(or C<undef> if it wasn't available due to errors), and a hash-ref with 100(or C<undef> if it wasn't available due to errors), and a hash-ref with
91response headers as second argument. 101response headers as second argument.
92 102
93All the headers in that hash are lowercased. In addition to the response 103All the headers in that hash are lowercased. In addition to the response
94headers, the three "pseudo-headers" C<HTTPVersion>, C<Status> and 104headers, the "pseudo-headers" C<HTTPVersion>, C<Status> and C<Reason>
95C<Reason> contain the three parts of the HTTP Status-Line of the same 105contain the three parts of the HTTP Status-Line of the same name. The
106pseudo-header C<URL> contains the original URL (which can differ from the
107requested URL when following redirects).
108
96name. If the server sends a header multiple lines, then their contents 109If the server sends a header multiple times, then their contents will be
97will be joined together with C<\x00>. 110joined together with a comma (C<,>), as per the HTTP spec.
98 111
99If an internal error occurs, such as not being able to resolve a hostname, 112If an internal error occurs, such as not being able to resolve a hostname,
100then C<$data> will be C<undef>, C<< $headers->{Status} >> will be C<599> 113then C<$data> will be C<undef>, C<< $headers->{Status} >> will be C<59x>
101and the C<Reason> pseudo-header will contain an error message. 114(usually C<599>) and the C<Reason> pseudo-header will contain an error
115message.
102 116
103A typical callback might look like this: 117A typical callback might look like this:
104 118
105 sub { 119 sub {
106 my ($body, $hdr) = @_; 120 my ($body, $hdr) = @_;
152based on the original netscape specification. 166based on the original netscape specification.
153 167
154The C<$hash_ref> must be an (initially empty) hash reference which will 168The C<$hash_ref> must be an (initially empty) hash reference which will
155get updated automatically. It is possible to save the cookie_jar to 169get updated automatically. It is possible to save the cookie_jar to
156persistent storage with something like JSON or Storable, but this is not 170persistent storage with something like JSON or Storable, but this is not
157recommended, as expire times are currently being ignored. 171recommended, as expiry times are currently being ignored.
158 172
159Note that this cookie implementation is not of very high quality, nor 173Note that this cookie implementation is not of very high quality, nor
160meant to be complete. If you want complete cookie management you have to 174meant to be complete. If you want complete cookie management you have to
161do that on your own. C<cookie_jar> is meant as a quick fix to get some 175do that on your own. C<cookie_jar> is meant as a quick fix to get some
162cookie-using sites working. Cookies are a privacy disaster, do not use 176cookie-using sites working. Cookies are a privacy disaster, do not use
163them unless required to. 177them unless required to.
178
179=item tls_ctx => $scheme | $tls_ctx
180
181Specifies the AnyEvent::TLS context to be used for https connections. This
182parameter follows the same rules as the C<tls_ctx> parameter to
183L<AnyEvent::Handle>, but additionally, the two strings C<low> or
184C<high> can be specified, which give you a predefined low-security (no
185verification, highest compatibility) and high-security (CA and common-name
186verification) TLS context.
187
188The default for this option is C<low>, which could be interpreted as "give
189me the page, no matter what".
190
191=item on_header => $callback->($hdr)
192
193When specified, this callback will be called with the header hash as soon
194as headers have been successfully received from the remote server (not on
195locally-generated errors).
196
197It has to return either true (in which case AnyEvent::HTTP will continue),
198or false, in which case AnyEvent::HTTP will cancel the download (and call
199the finish callback with an error code of C<598>).
200
201This callback is useful, among other things, to quickly reject unwanted
202content, which, if it is supposed to be rare, can be faster than first
203doing a C<HEAD> request.
204
205=item on_body => $callback->($data, $hdr)
206
207When specified, all body data will be "filtered" through this callback.
208
209The callback will incrementally receive body data, and is supposed to
210return it or a modified version of it (empty strings are valid returns).
211
212If the callback returns C<undef>, then the request will be cancelled.
213
214This callback is useful when you want to do some processing on the data,
215or the data is too large to be held in memory (so the callback writes it
216to a file and returns the empty string) and so on.
217
218It is usually preferred over doing your own body handling via
219C<want_body_handle>.
220
221=item want_body_handle => $enable
222
223When enabled (default is disabled), the behaviour of AnyEvent::HTTP
224changes considerably: after parsing the headers, and instead of
225downloading the body (if any), the completion callback will be
226called. Instead of the C<$body> argument containing the body data, the
227callback will receive the L<AnyEvent::Handle> object associated with the
228connection. In error cases, C<undef> will be passed. When there is no body
229(e.g. status C<304>), the empty string will be passed.
230
231The handle object might or might not be in TLS mode, might be connected to
232a proxy, be a persistent connection etc., and configured in unspecified
233ways. The user is responsible for this handle (it will not be used by this
234module anymore).
235
236This is useful with some push-type services, where, after the initial
237headers, an interactive protocol is used (typical example would be the
238push-style twitter API which starts a JSON/XML stream).
239
240If you think you need this, first have a look at C<on_body>, to see if
241that doesn'T solve your problem in a better way.
164 242
165=back 243=back
166 244
167Example: make a simple HTTP GET request for http://www.nethype.de/ 245Example: make a simple HTTP GET request for http://www.nethype.de/
168 246
181 my ($body, $hdr) = @_; 259 my ($body, $hdr) = @_;
182 use Data::Dumper; 260 use Data::Dumper;
183 print Dumper $hdr; 261 print Dumper $hdr;
184 } 262 }
185 ; 263 ;
264
265Example: make another simple HTTP GET request, but immediately try to
266cancel it.
267
268 my $request = http_request GET => "http://www.nethype.de/", sub {
269 my ($body, $hdr) = @_;
270 print "$body\n";
271 };
272
273 undef $request;
186 274
187=cut 275=cut
188 276
189sub _slot_schedule; 277sub _slot_schedule;
190sub _slot_schedule($) { 278sub _slot_schedule($) {
214 push @{ $CO_SLOT{$_[0]}[1] }, $_[1]; 302 push @{ $CO_SLOT{$_[0]}[1] }, $_[1];
215 303
216 _slot_schedule $_[0]; 304 _slot_schedule $_[0];
217} 305}
218 306
307our $qr_nl = qr<\015?\012>;
308our $qr_nlnl = qr<\015?\012\015?\012>;
309
310our $TLS_CTX_LOW = { cache => 1, sslv2 => 1 };
311our $TLS_CTX_HIGH = { cache => 1, verify => 1, verify_peername => "https" };
312
219sub http_request($$@) { 313sub http_request($$@) {
220 my $cb = pop; 314 my $cb = pop;
221 my ($method, $url, %arg) = @_; 315 my ($method, $url, %arg) = @_;
222 316
223 my %hdr; 317 my %hdr;
318
319 $arg{tls_ctx} = $TLS_CTX_LOW if $arg{tls_ctx} eq "low" || !exists $arg{tls_ctx};
320 $arg{tls_ctx} = $TLS_CTX_HIGH if $arg{tls_ctx} eq "high";
224 321
225 $method = uc $method; 322 $method = uc $method;
226 323
227 if (my $hdr = $arg{headers}) { 324 if (my $hdr = $arg{headers}) {
228 while (my ($k, $v) = each %$hdr) { 325 while (my ($k, $v) = each %$hdr) {
229 $hdr{lc $k} = $v; 326 $hdr{lc $k} = $v;
230 } 327 }
231 } 328 }
232 329
233 my $recurse = exists $arg{recurse} ? $arg{recurse} : $MAX_RECURSE; 330 my $recurse = exists $arg{recurse} ? delete $arg{recurse} : $MAX_RECURSE;
234 331
235 return $cb->(undef, { Status => 599, Reason => "recursion limit reached" }) 332 return $cb->(undef, { Status => 599, Reason => "Too many redirections", URL => $url })
236 if $recurse < 0; 333 if $recurse < 0;
237 334
238 my $proxy = $arg{proxy} || $PROXY; 335 my $proxy = $arg{proxy} || $PROXY;
239 my $timeout = $arg{timeout} || $TIMEOUT; 336 my $timeout = $arg{timeout} || $TIMEOUT;
240 337
241 $hdr{"user-agent"} ||= $USERAGENT;
242
243 my ($scheme, $authority, $upath, $query, $fragment) = 338 my ($uscheme, $uauthority, $upath, $query, $fragment) =
244 $url =~ m|(?:([^:/?#]+):)?(?://([^/?#]*))?([^?#]*)(?:\?([^#]*))?(?:#(.*))?|; 339 $url =~ m|(?:([^:/?#]+):)?(?://([^/?#]*))?([^?#]*)(?:\?([^#]*))?(?:#(.*))?|;
245 340
246 $scheme = lc $scheme; 341 $uscheme = lc $uscheme;
247 342
248 my $uport = $scheme eq "http" ? 80 343 my $uport = $uscheme eq "http" ? 80
249 : $scheme eq "https" ? 443 344 : $uscheme eq "https" ? 443
250 : return $cb->(undef, { Status => 599, Reason => "only http and https URL schemes supported" }); 345 : return $cb->(undef, { Status => 599, Reason => "Only http and https URL schemes supported", URL => $url });
251 346
252 $hdr{referer} ||= "$scheme://$authority$upath"; # leave out fragment and query string, just a heuristic
253
254 $authority =~ /^(?: .*\@ )? ([^\@:]+) (?: : (\d+) )?$/x 347 $uauthority =~ /^(?: .*\@ )? ([^\@:]+) (?: : (\d+) )?$/x
255 or return $cb->(undef, { Status => 599, Reason => "unparsable URL" }); 348 or return $cb->(undef, { Status => 599, Reason => "Unparsable URL", URL => $url });
256 349
257 my $uhost = $1; 350 my $uhost = $1;
258 $uport = $2 if defined $2; 351 $uport = $2 if defined $2;
259 352
260 $uhost =~ s/^\[(.*)\]$/$1/; 353 $uhost =~ s/^\[(.*)\]$/$1/;
262 355
263 $upath =~ s%^/?%/%; 356 $upath =~ s%^/?%/%;
264 357
265 # cookie processing 358 # cookie processing
266 if (my $jar = $arg{cookie_jar}) { 359 if (my $jar = $arg{cookie_jar}) {
267 %$jar = () if $jar->{version} < 1; 360 %$jar = () if $jar->{version} != 1;
268 361
269 my @cookie; 362 my @cookie;
270 363
271 while (my ($chost, $v) = each %$jar) { 364 while (my ($chost, $v) = each %$jar) {
365 if ($chost =~ /^\./) {
272 next unless $chost eq substr $uhost, -length $chost; 366 next unless $chost eq substr $uhost, -length $chost;
273 next unless $chost =~ /^\./; 367 } elsif ($chost =~ /\./) {
368 next unless $chost eq $uhost;
369 } else {
370 next;
371 }
274 372
275 while (my ($cpath, $v) = each %$v) { 373 while (my ($cpath, $v) = each %$v) {
276 next unless $cpath eq substr $upath, 0, length $cpath; 374 next unless $cpath eq substr $upath, 0, length $cpath;
277 375
278 while (my ($k, $v) = each %$v) { 376 while (my ($k, $v) = each %$v) {
279 next if $scheme ne "https" && exists $v->{secure}; 377 next if $uscheme ne "https" && exists $v->{secure};
378 my $value = $v->{value};
379 $value =~ s/([\\"])/\\$1/g;
280 push @cookie, "$k=$v->{value}"; 380 push @cookie, "$k=\"$value\"";
281 } 381 }
282 } 382 }
283 } 383 }
284 384
285 $hdr{cookie} = join "; ", @cookie 385 $hdr{cookie} = join "; ", @cookie
286 if @cookie; 386 if @cookie;
287 } 387 }
288 388
289 my ($rhost, $rport, $rpath); # request host, port, path 389 my ($rhost, $rport, $rscheme, $rpath); # request host, port, path
290 390
291 if ($proxy) { 391 if ($proxy) {
292 ($rhost, $rport, $scheme) = @$proxy; 392 ($rpath, $rhost, $rport, $rscheme) = ($url, @$proxy);
293 $rpath = $url; 393
394 # don't support https requests over https-proxy transport,
395 # can't be done with tls as spec'ed, unless you double-encrypt.
396 $rscheme = "http" if $uscheme eq "https" && $rscheme eq "https";
294 } else { 397 } else {
295 ($rhost, $rport, $rpath) = ($uhost, $uport, $upath); 398 ($rhost, $rport, $rscheme, $rpath) = ($uhost, $uport, $uscheme, $upath);
296 $hdr{host} = $uhost;
297 } 399 }
298 400
401 $hdr{"user-agent"} ||= $USERAGENT;
402 $hdr{referer} ||= "$uscheme://$uauthority$upath"; # leave out fragment and query string, just a heuristic
403
404 $hdr{host} = "$uhost:$uport";
299 $hdr{"content-length"} = length $arg{body}; 405 $hdr{"content-length"} = length $arg{body};
300 406
301 my %state = (connect_guard => 1); 407 my %state = (connect_guard => 1);
302 408
303 _get_slot $uhost, sub { 409 _get_slot $uhost, sub {
305 411
306 return unless $state{connect_guard}; 412 return unless $state{connect_guard};
307 413
308 $state{connect_guard} = AnyEvent::Socket::tcp_connect $rhost, $rport, sub { 414 $state{connect_guard} = AnyEvent::Socket::tcp_connect $rhost, $rport, sub {
309 $state{fh} = shift 415 $state{fh} = shift
310 or return $cb->(undef, { Status => 599, Reason => "$!" }); 416 or return (%state = (), $cb->(undef, { Status => 599, Reason => "$!", URL => $url }));
417 pop; # free memory, save a tree
311 418
312 delete $state{connect_guard}; # reduce memory usage, save a tree 419 return unless delete $state{connect_guard};
313 420
314 # get handle 421 # get handle
315 $state{handle} = new AnyEvent::Handle 422 $state{handle} = new AnyEvent::Handle
316 fh => $state{fh}, 423 fh => $state{fh},
317 ($scheme eq "https" ? (tls => "connect") : ()); 424 timeout => $timeout,
425 peername => $rhost,
426 tls_ctx => $arg{tls_ctx};
318 427
319 # limit the number of persistent connections 428 # limit the number of persistent connections
429 # keepalive not yet supported
320 if ($KA_COUNT{$_[1]} < $MAX_PERSISTENT_PER_HOST) { 430 if ($KA_COUNT{$_[1]} < $MAX_PERSISTENT_PER_HOST) {
321 ++$KA_COUNT{$_[1]}; 431 ++$KA_COUNT{$_[1]};
322 $state{handle}{ka_count_guard} = AnyEvent::Util::guard { --$KA_COUNT{$_[1]} }; 432 $state{handle}{ka_count_guard} = AnyEvent::Util::guard {
433 --$KA_COUNT{$_[1]}
434 };
323 $hdr{connection} = "keep-alive"; 435 $hdr{connection} = "keep-alive";
324 delete $hdr{connection}; # keep-alive not yet supported
325 } else { 436 } else {
326 delete $hdr{connection}; 437 delete $hdr{connection};
327 } 438 }
328 439
329 # (re-)configure handle 440 # (re-)configure handle
330 $state{handle}->timeout ($timeout);
331 $state{handle}->on_error (sub { 441 $state{handle}->on_error (sub {
332 my $errno = "$!";
333 %state = (); 442 %state = ();
334 $cb->(undef, { Status => 599, Reason => $errno }); 443 $cb->(undef, { Status => 599, Reason => $_[2], URL => $url });
335 }); 444 });
336 $state{handle}->on_eof (sub { 445 $state{handle}->on_eof (sub {
337 %state = (); 446 %state = ();
338 $cb->(undef, { Status => 599, Reason => "unexpected end-of-file" }); 447 $cb->(undef, { Status => 599, Reason => "Unexpected end-of-file", URL => $url });
339 }); 448 });
340 449
450 $state{handle}->starttls ("connect") if $rscheme eq "https";
451
452 # handle actual, non-tunneled, request
453 my $handle_actual_request = sub {
454 $state{handle}->starttls ("connect") if $uscheme eq "https" && !exists $state{handle}{tls};
455
341 # send request 456 # send request
342 $state{handle}->push_write ( 457 $state{handle}->push_write (
343 "$method $rpath HTTP/1.0\015\012" 458 "$method $rpath HTTP/1.0\015\012"
344 . (join "", map "$_: $hdr{$_}\015\012", keys %hdr) 459 . (join "", map "\u$_: $hdr{$_}\015\012", keys %hdr)
345 . "\015\012" 460 . "\015\012"
346 . (delete $arg{body}) 461 . (delete $arg{body})
347 );
348
349 %hdr = (); # reduce memory usage, save a kitten
350
351 # status line
352 $state{handle}->push_read (line => qr/\015?\012/, sub {
353 $_[1] =~ /^HTTP\/([0-9\.]+) \s+ ([0-9]{3}) \s+ ([^\015\012]+)/ix
354 or return (%state = (), $cb->(undef, { Status => 599, Reason => "invalid server response ($_[1])" }));
355
356 my %hdr = ( # response headers
357 HTTPVersion => "\x00$1",
358 Status => "\x00$2",
359 Reason => "\x00$3",
360 ); 462 );
361 463
464 %hdr = (); # reduce memory usage, save a kitten
465
466 # status line
467 $state{handle}->push_read (line => $qr_nl, sub {
468 $_[1] =~ /^HTTP\/([0-9\.]+) \s+ ([0-9]{3}) (?: \s+ ([^\015\012]*) )?/ix
469 or return (%state = (), $cb->(undef, { Status => 599, Reason => "Invalid server response ($_[1])", URL => $url }));
470
471 my %hdr = ( # response headers
472 HTTPVersion => ",$1",
473 Status => ",$2",
474 Reason => ",$3",
475 URL => ",$url"
476 );
477
362 # headers, could be optimized a bit 478 # headers, could be optimized a bit
363 $state{handle}->unshift_read (line => qr/\015?\012\015?\012/, sub { 479 $state{handle}->unshift_read (line => $qr_nlnl, sub {
364 for ("$_[1]\012") { 480 for ("$_[1]\012") {
365 # we support spaces in field names, as lotus domino 481 y/\015//d; # weed out any \015, as they show up in the weirdest of places.
366 # creates them. 482
483 # things seen, not parsed:
484 # p3pP="NON CUR OTPi OUR NOR UNI"
485
367 $hdr{lc $1} .= "\x00$2" 486 $hdr{lc $1} .= ",$2"
368 while /\G 487 while /\G
369 ([^:\000-\037]+): 488 ([^:\000-\037]+):
370 [\011\040]* 489 [\011\040]*
371 ((?: [^\015\012]+ | \015?\012[\011\040] )*) 490 ((?: [^\012]+ | \012[\011\040] )*)
372 \015?\012 491 \012
373 /gxc; 492 /gxc;
374 493
375 /\G$/ 494 /\G$/
376 or return (%state = (), $cb->(undef, { Status => 599, Reason => "garbled response headers" })); 495 or return (%state = (), $cb->(undef, { Status => 599, Reason => "Garbled response headers", URL => $url }));
377 } 496 }
378 497
379 substr $_, 0, 1, "" 498 substr $_, 0, 1, ""
380 for values %hdr; 499 for values %hdr;
381 500
382 my $finish = sub { 501 # redirect handling
383 %state = (); 502 # microsoft and other shitheads don't give a shit for following standards,
503 # try to support some common forms of broken Location headers.
504 if ($hdr{location} !~ /^(?: $ | [^:\/?\#]+ : )/x) {
505 $hdr{location} =~ s/^\.\/+//;
384 506
385 # set-cookie processing 507 my $url = "$rscheme://$uhost:$uport";
386 if ($arg{cookie_jar} && exists $hdr{"set-cookie"}) {
387 for (split /\x00/, $hdr{"set-cookie"}) {
388 my ($cookie, @arg) = split /;\s*/;
389 my ($name, $value) = split /=/, $cookie, 2;
390 my %kv = (value => $value, map { split /=/, $_, 2 } @arg);
391
392 my $cdom = (delete $kv{domain}) || $uhost;
393 my $cpath = (delete $kv{path}) || "/";
394
395 $cdom =~ s/^.?/./; # make sure it starts with a "."
396 508
397 next if $cdom =~ /\.$/; 509 unless ($hdr{location} =~ s/^\///) {
398 510 $url .= $upath;
399 # this is not rfc-like and not netscape-like. go figure. 511 $url =~ s/\/[^\/]*$//;
400 my $ndots = $cdom =~ y/.//; 512 }
401 next if $ndots < ($cdom =~ /\.[^.][^.]\.[^.][^.]$/ ? 3 : 2); 513
402 514 $hdr{location} = "$url/$hdr{location}";
515 }
516
517 my $redirect;
518
519 if ($recurse) {
520 if ($hdr{Status} =~ /^30[12]$/ && $method ne "POST") {
521 # apparently, mozilla et al. just change POST to GET here
522 # more research is needed before we do the same
403 # store it 523 $redirect = 1;
404 $arg{cookie_jar}{version} = 1; 524 } elsif ($hdr{Status} == 303) {
405 $arg{cookie_jar}{$cdom}{$cpath}{$name} = \%kv; 525 # even http/1.1 is unclear on how to mutate the method
526 $method = "GET" unless $method eq "HEAD";
527 $redirect = 1;
528 } elsif ($hdr{Status} == 307 && $method =~ /^(?:GET|HEAD)$/) {
529 $redirect = 1;
406 } 530 }
407 } 531 }
408 532
409 if ($_[1]{Status} =~ /^30[12]$/ && $recurse) { 533 my $finish = sub {
410 # microsoft and other assholes don't give a shit for following standards, 534 $state{handle}->destroy if $state{handle};
411 # try to support a common form of broken Location header. 535 %state = ();
412 $_[1]{location} =~ s%^/%$scheme://$uhost:$uport/%;
413 536
537 # set-cookie processing
538 if ($arg{cookie_jar}) {
539 for ($_[1]{"set-cookie"}) {
540 # parse NAME=VALUE
541 my @kv;
542
543 while (/\G\s* ([^=;,[:space:]]+) \s*=\s* (?: "((?:[^\\"]+|\\.)*)" | ([^=;,[:space:]]*) )/gcxs) {
544 my $name = $1;
545 my $value = $3;
546
547 unless ($value) {
548 $value = $2;
549 $value =~ s/\\(.)/$1/gs;
550 }
551
552 push @kv, $name => $value;
553
554 last unless /\G\s*;/gc;
555 }
556
557 last unless @kv;
558
559 my $name = shift @kv;
560 my %kv = (value => shift @kv, @kv);
561
562 my $cdom;
563 my $cpath = (delete $kv{path}) || "/";
564
565 if (exists $kv{domain}) {
566 $cdom = delete $kv{domain};
567
568 $cdom =~ s/^\.?/./; # make sure it starts with a "."
569
570 next if $cdom =~ /\.$/;
571
572 # this is not rfc-like and not netscape-like. go figure.
573 my $ndots = $cdom =~ y/.//;
574 next if $ndots < ($cdom =~ /\.[^.][^.]\.[^.][^.]$/ ? 3 : 2);
575 } else {
576 $cdom = $uhost;
577 }
578
579 # store it
580 $arg{cookie_jar}{version} = 1;
581 $arg{cookie_jar}{$cdom}{$cpath}{$name} = \%kv;
582
583 redo if /\G\s*,/gc;
584 }
585 }
586
587 if ($redirect) {
588 # we ignore any errors, as it is very common to receive
589 # Content-Length != 0 but no actual body
590 # we also access %hdr, as $_[1] might be an erro
414 http_request ($method, $_[1]{location}, %arg, recurse => $recurse - 1, $cb); 591 http_request ($method => $hdr{location}, %arg, recurse => $recurse - 1, $cb);
592 } else {
593 $cb->($_[0], $_[1]);
594 }
595 };
596
597 my $len = $hdr{"content-length"};
598
599 if (!$redirect && $arg{on_header} && !$arg{on_header}(\%hdr)) {
600 $finish->(undef, { Status => 598, Reason => "Request cancelled by on_header", URL => $url });
601 } elsif (
602 $hdr{Status} =~ /^(?:1..|204|304)$/
603 or $method eq "HEAD"
604 or (defined $len && !$len)
605 ) {
606 # no body
607 $finish->("", \%hdr);
415 } else { 608 } else {
416 $cb->($_[0], $_[1]); 609 # body handling, four different code paths
610 # for want_body_handle, on_body (2x), normal (2x)
611 # we might read too much here, but it does not matter yet (no pers. connections)
612 if (!$redirect && $arg{want_body_handle}) {
613 $_[0]->on_eof (undef);
614 $_[0]->on_error (undef);
615 $_[0]->on_read (undef);
616
617 $finish->(delete $state{handle}, \%hdr);
618
619 } elsif ($arg{on_body}) {
620 $_[0]->on_error (sub { $finish->(undef, { Status => 599, Reason => $_[2], URL => $url }) });
621 if ($len) {
622 $_[0]->on_eof (undef);
623 $_[0]->on_read (sub {
624 $len -= length $_[0]{rbuf};
625
626 $arg{on_body}(delete $_[0]{rbuf}, \%hdr)
627 or $finish->(undef, { Status => 598, Reason => "Request cancelled by on_body", URL => $url });
628
629 $len > 0
630 or $finish->("", \%hdr);
631 });
632 } else {
633 $_[0]->on_eof (sub {
634 $finish->("", \%hdr);
635 });
636 $_[0]->on_read (sub {
637 $arg{on_body}(delete $_[0]{rbuf}, \%hdr)
638 or $finish->(undef, { Status => 598, Reason => "Request cancelled by on_body", URL => $url });
639 });
640 }
641 } else {
642 $_[0]->on_eof (undef);
643
644 if ($len) {
645 $_[0]->on_error (sub { $finish->(undef, { Status => 599, Reason => $_[2], URL => $url }) });
646 $_[0]->on_read (sub {
647 $finish->((substr delete $_[0]{rbuf}, 0, $len, ""), \%hdr)
648 if $len <= length $_[0]{rbuf};
649 });
650 } else {
651 $_[0]->on_error (sub {
652 $! == Errno::EPIPE
653 ? $finish->(delete $_[0]{rbuf}, \%hdr)
654 : $finish->(undef, { Status => 599, Reason => $_[2], URL => $url });
655 });
656 $_[0]->on_read (sub { });
657 }
658 }
417 } 659 }
418 }; 660 });
661 });
662 };
419 663
420 if ($hdr{Status} =~ /^(?:1..|204|304)$/ or $method eq "HEAD") { 664 # now handle proxy-CONNECT method
421 $finish->(undef, \%hdr); 665 if ($proxy && $uscheme eq "https") {
666 # oh dear, we have to wrap it into a connect request
667
668 # maybe re-use $uauthority with patched port?
669 $state{handle}->push_write ("CONNECT $uhost:$uport HTTP/1.0\015\012Host: $uhost\015\012\015\012");
670 $state{handle}->push_read (line => $qr_nlnl, sub {
671 $_[1] =~ /^HTTP\/([0-9\.]+) \s+ ([0-9]{3}) (?: \s+ ([^\015\012]*) )?/ix
672 or return (%state = (), $cb->(undef, { Status => 599, Reason => "Invalid proxy connect response ($_[1])", URL => $url }));
673
674 if ($2 == 200) {
675 $rpath = $upath;
676 &$handle_actual_request;
422 } else { 677 } else {
423 if (exists $hdr{"content-length"}) { 678 %state = ();
424 $_[0]->unshift_read (chunk => $hdr{"content-length"}, sub { 679 $cb->(undef, { Status => $2, Reason => $3, URL => $url });
425 # could cache persistent connection now
426 if ($hdr{connection} =~ /\bkeep-alive\b/i) {
427 # but we don't, due to misdesigns, this is annoyingly complex
428 };
429
430 $finish->($_[1], \%hdr);
431 });
432 } else {
433 # too bad, need to read until we get an error or EOF,
434 # no way to detect winged data.
435 $_[0]->on_error (sub {
436 $finish->($_[0]{rbuf}, \%hdr);
437 });
438 $_[0]->on_eof (undef);
439 $_[0]->on_read (sub { });
440 }
441 } 680 }
442 }); 681 });
682 } else {
683 &$handle_actual_request;
443 }); 684 }
685
444 }, sub { 686 }, sub {
445 $timeout 687 $timeout
446 }; 688 };
447 }; 689 };
448 690
458 unshift @_, "HEAD"; 700 unshift @_, "HEAD";
459 &http_request 701 &http_request
460} 702}
461 703
462sub http_post($$@) { 704sub http_post($$@) {
705 my $url = shift;
463 unshift @_, "POST", "body"; 706 unshift @_, "POST", $url, "body";
464 &http_request 707 &http_request
465} 708}
466 709
467=back 710=back
468 711
480The default value for the C<recurse> request parameter (default: C<10>). 723The default value for the C<recurse> request parameter (default: C<10>).
481 724
482=item $AnyEvent::HTTP::USERAGENT 725=item $AnyEvent::HTTP::USERAGENT
483 726
484The default value for the C<User-Agent> header (the default is 727The default value for the C<User-Agent> header (the default is
485C<Mozilla/5.0 (compatible; AnyEvent::HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)>). 728C<Mozilla/5.0 (compatible; U; AnyEvent-HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)>).
486 729
487=item $AnyEvent::HTTP::MAX_PERSISTENT 730=item $AnyEvent::HTTP::MAX_PERSISTENT
488 731
489The maximum number of persistent connections to keep open (default: 8). 732The maximum number of persistent connections to keep open (default: 8).
490 733
517 760
518L<AnyEvent>. 761L<AnyEvent>.
519 762
520=head1 AUTHOR 763=head1 AUTHOR
521 764
522 Marc Lehmann <schmorp@schmorp.de> 765 Marc Lehmann <schmorp@schmorp.de>
523 http://home.schmorp.de/ 766 http://home.schmorp.de/
767
768With many thanks to Дмитрий Шалашов, who provided countless
769testcases and bugreports.
524 770
525=cut 771=cut
526 772
5271 7731
528 774

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines