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.19 by elmex, Mon Jun 9 13:02:13 2008 UTC vs.
Revision 1.43 by root, Mon Jul 6 03:03:12 2009 UTC

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

Diff Legend

Removed lines
+ Added lines
< Changed lines
> Changed lines