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.1 by root, Tue Jun 3 16:37:13 2008 UTC vs.
Revision 1.25 by root, Mon Jul 21 05:42:07 2008 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.
17
18This module implements a simple, stateless and non-blocking HTTP
19client. It supports GET, POST and other request methods, cookies and more,
20all on a very low level. It can follow redirects supports proxies and
21automatically limits the number of connections to the values specified in
22the RFC.
23
24It should generally be a "good client" that is enough for most HTTP
25tasks. Simple tasks should be simple, but complex tasks should still be
26possible as the user retains control over request and response headers.
27
28The caller is responsible for authentication management, cookies (if
29the simplistic implementation in this module doesn't suffice), referer
30and other high-level protocol details for which this module offers only
31limited support.
13 32
14=head2 METHODS 33=head2 METHODS
15 34
16=over 4 35=over 4
17 36
… …
29use AnyEvent::Socket (); 48use AnyEvent::Socket ();
30use AnyEvent::Handle (); 49use AnyEvent::Handle ();
31 50
32use base Exporter::; 51use base Exporter::;
33 52
34our $VERSION = '1.0'; 53our $VERSION = '1.03';
35 54
36our @EXPORT = qw(http_get http_request); 55our @EXPORT = qw(http_get http_post http_head http_request);
37 56
38our $MAX_REDIRECTS = 10;
39our $USERAGENT = "Mozilla/5.0 (compatible; AnyEvent::HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)"; 57our $USERAGENT = "Mozilla/5.0 (compatible; AnyEvent::HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)";
58our $MAX_RECURSE = 10;
40our $MAX_PERSISTENT = 8; 59our $MAX_PERSISTENT = 8;
41our $PERSISTENT_TIMEOUT = 15; 60our $PERSISTENT_TIMEOUT = 2;
42our $TIMEOUT = 60; 61our $TIMEOUT = 300;
43 62
44# changing these is evil 63# changing these is evil
45our $MAX_PERSISTENT_PER_HOST = 2; 64our $MAX_PERSISTENT_PER_HOST = 2;
46our $MAX_PER_HOST = 4; # not respected yet :( 65our $MAX_PER_HOST = 4;
66
67our $PROXY;
68our $ACTIVE = 0;
47 69
48my %KA_COUNT; # number of open keep-alive connections per host 70my %KA_COUNT; # number of open keep-alive connections per host
71my %CO_SLOT; # number of open connections, and wait queue, per host
49 72
50=item http_get $url, key => value..., $cb->($data, $headers) 73=item http_get $url, key => value..., $cb->($data, $headers)
51 74
52Executes 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
53additional parameters. 76additional parameters.
54 77
78=item http_head $url, key => value..., $cb->($data, $headers)
79
80Executes an HTTP-HEAD request. See the http_request function for details on
81additional parameters.
82
83=item http_post $url, $body, key => value..., $cb->($data, $headers)
84
85Executes an HTTP-POST request with a request body of C<$bod>. See the
86http_request function for details on additional parameters.
87
55=item http_request $method => $url, key => value..., $cb->($data, $headers) 88=item http_request $method => $url, key => value..., $cb->($data, $headers)
56 89
57Executes a HTTP request of type C<$method> (e.g. C<GET>, C<POST>). The URL 90Executes a HTTP request of type C<$method> (e.g. C<GET>, C<POST>). The URL
58must be an absolute http or https URL. 91must be an absolute http or https URL.
59 92
93The callback will be called with the response data as first argument
94(or C<undef> if it wasn't available due to errors), and a hash-ref with
95response headers as second argument.
96
97All the headers in that hash are lowercased. In addition to the response
98headers, the "pseudo-headers" C<HTTPVersion>, C<Status> and C<Reason>
99contain the three parts of the HTTP Status-Line of the same name. The
100pseudo-header C<URL> contains the original URL (which can differ from the
101requested URL when following redirects).
102
103If the server sends a header multiple lines, then their contents will be
104joined together with C<\x00>.
105
106If an internal error occurs, such as not being able to resolve a hostname,
107then C<$data> will be C<undef>, C<< $headers->{Status} >> will be C<599>
108and the C<Reason> pseudo-header will contain an error message.
109
110A typical callback might look like this:
111
112 sub {
113 my ($body, $hdr) = @_;
114
115 if ($hdr->{Status} =~ /^2/) {
116 ... everything should be ok
117 } else {
118 print "error, $hdr->{Status} $hdr->{Reason}\n";
119 }
120 }
121
60Additional parameters are key-value pairs, and are fully optional. They 122Additional parameters are key-value pairs, and are fully optional. They
61include: 123include:
62 124
63=over 4 125=over 4
64 126
65=item recurse => $boolean (default: true) 127=item recurse => $count (default: $MAX_RECURSE)
66 128
67Whether to recurse requests or not, e.g. on redirects, authentication 129Whether to recurse requests or not, e.g. on redirects, authentication
68retries and so on. 130retries and so on, and how often to do so.
69 131
70=item headers => hashref 132=item headers => hashref
71 133
72The request headers to use. 134The request headers to use. Currently, C<http_request> may provide its
135own C<Host:>, C<Content-Length:>, C<Connection:> and C<Cookie:> headers
136and will provide defaults for C<User-Agent:> and C<Referer:>.
73 137
74=item timeout => $seconds 138=item timeout => $seconds
75 139
76The time-out to use for various stages - each connect attempt will reset 140The time-out to use for various stages - each connect attempt will reset
77the timeout, as will read or write activity. 141the timeout, as will read or write activity. Default timeout is 5 minutes.
142
143=item proxy => [$host, $port[, $scheme]] or undef
144
145Use the given http proxy for all requests. If not specified, then the
146default proxy (as specified by C<$ENV{http_proxy}>) is used.
147
148C<$scheme> must be either missing or C<http> for HTTP, or C<https> for
149HTTPS.
150
151=item body => $string
152
153The request body, usually empty. Will be-sent as-is (future versions of
154this module might offer more options).
155
156=item cookie_jar => $hash_ref
157
158Passing this parameter enables (simplified) cookie-processing, loosely
159based on the original netscape specification.
160
161The C<$hash_ref> must be an (initially empty) hash reference which will
162get updated automatically. It is possible to save the cookie_jar to
163persistent storage with something like JSON or Storable, but this is not
164recommended, as expire times are currently being ignored.
165
166Note that this cookie implementation is not of very high quality, nor
167meant to be complete. If you want complete cookie management you have to
168do that on your own. C<cookie_jar> is meant as a quick fix to get some
169cookie-using sites working. Cookies are a privacy disaster, do not use
170them unless required to.
78 171
79=back 172=back
80 173
81=back 174Example: make a simple HTTP GET request for http://www.nethype.de/
175
176 http_request GET => "http://www.nethype.de/", sub {
177 my ($body, $hdr) = @_;
178 print "$body\n";
179 };
180
181Example: make a HTTP HEAD request on https://www.google.com/, use a
182timeout of 30 seconds.
183
184 http_request
185 GET => "https://www.google.com",
186 timeout => 30,
187 sub {
188 my ($body, $hdr) = @_;
189 use Data::Dumper;
190 print Dumper $hdr;
191 }
192 ;
82 193
83=cut 194=cut
84 195
196sub _slot_schedule;
197sub _slot_schedule($) {
198 my $host = shift;
199
200 while ($CO_SLOT{$host}[0] < $MAX_PER_HOST) {
201 if (my $cb = shift @{ $CO_SLOT{$host}[1] }) {
202 # somebody wants that slot
203 ++$CO_SLOT{$host}[0];
204 ++$ACTIVE;
205
206 $cb->(AnyEvent::Util::guard {
207 --$ACTIVE;
208 --$CO_SLOT{$host}[0];
209 _slot_schedule $host;
210 });
211 } else {
212 # nobody wants the slot, maybe we can forget about it
213 delete $CO_SLOT{$host} unless $CO_SLOT{$host}[0];
214 last;
215 }
216 }
217}
218
219# wait for a free slot on host, call callback
220sub _get_slot($$) {
221 push @{ $CO_SLOT{$_[0]}[1] }, $_[1];
222
223 _slot_schedule $_[0];
224}
225
85sub http_request($$$;@) { 226sub http_request($$@) {
86 my $cb = pop; 227 my $cb = pop;
87 my ($method, $url, %arg) = @_; 228 my ($method, $url, %arg) = @_;
88 229
89 my %hdr; 230 my %hdr;
90 231
232 $method = uc $method;
233
91 if (my $hdr = delete $arg{headers}) { 234 if (my $hdr = $arg{headers}) {
92 while (my ($k, $v) = each %$hdr) { 235 while (my ($k, $v) = each %$hdr) {
93 $hdr{lc $k} = $v; 236 $hdr{lc $k} = $v;
94 } 237 }
95 } 238 }
96 239
240 my $recurse = exists $arg{recurse} ? delete $arg{recurse} : $MAX_RECURSE;
241
242 return $cb->(undef, { Status => 599, Reason => "recursion limit reached", URL => $url })
243 if $recurse < 0;
244
245 my $proxy = $arg{proxy} || $PROXY;
97 my $timeout = $arg{timeout} || $TIMEOUT; 246 my $timeout = $arg{timeout} || $TIMEOUT;
98 247
99 $hdr{"user-agent"} ||= $USERAGENT; 248 $hdr{"user-agent"} ||= $USERAGENT;
100 249
101 my ($scheme, $authority, $path, $query, $fragment) = 250 my ($scheme, $authority, $upath, $query, $fragment) =
102 $url =~ m|(?:([^:/?#]+):)?(?://([^/?#]*))?([^?#]*)(?:\?([^#]*))?(?:#(.*))?|; 251 $url =~ m|(?:([^:/?#]+):)?(?://([^/?#]*))?([^?#]*)(?:\?([^#]*))?(?:#(.*))?|;
103 252
104 $scheme = lc $scheme; 253 $scheme = lc $scheme;
254
105 my $port = $scheme eq "http" ? 80 255 my $uport = $scheme eq "http" ? 80
106 : $scheme eq "https" ? 443 256 : $scheme eq "https" ? 443
107 : croak "$url: only http and https URLs supported"; 257 : return $cb->(undef, { Status => 599, Reason => "only http and https URL schemes supported", URL => $url });
258
259 $hdr{referer} ||= "$scheme://$authority$upath"; # leave out fragment and query string, just a heuristic
108 260
109 $authority =~ /^(?: .*\@ )? ([^\@:]+) (?: : (\d+) )?$/x 261 $authority =~ /^(?: .*\@ )? ([^\@:]+) (?: : (\d+) )?$/x
110 or croak "$authority: unparsable URL"; 262 or return $cb->(undef, { Status => 599, Reason => "unparsable URL", URL => $url });
111 263
112 my $host = $1; 264 my $uhost = $1;
113 $port = $2 if defined $2; 265 $uport = $2 if defined $2;
114 266
115 $host =~ s/^\[(.*)\]$/$1/; 267 $uhost =~ s/^\[(.*)\]$/$1/;
116 $path .= "?$query" if length $query; 268 $upath .= "?$query" if length $query;
117 269
118 $hdr{host} = $host = lc $host; 270 $upath =~ s%^/?%/%;
119 271
120 my %state; 272 # cookie processing
121 273 if (my $jar = $arg{cookie_jar}) {
122 my $body = ""; 274 %$jar = () if $jar->{version} < 1;
123 $state{body} = $body; 275
124 276 my @cookie;
125 $hdr{"content-length"} = length $body; 277
126 278 while (my ($chost, $v) = each %$jar) {
127 $state{connect_guard} = AnyEvent::Socket::tcp_connect $host, $port, sub { 279 next unless $chost eq substr $uhost, -length $chost;
128 $state{fh} = shift 280 next unless $chost =~ /^\./;
129 or return $cb->(undef, { Status => 599, Reason => "$!" }); 281
130 282 while (my ($cpath, $v) = each %$v) {
131 delete $state{connect_guard}; # reduce memory usage, save a tree 283 next unless $cpath eq substr $upath, 0, length $cpath;
132 284
133 # get handle 285 while (my ($k, $v) = each %$v) {
134 $state{handle} = new AnyEvent::Handle 286 next if $scheme ne "https" && exists $v->{secure};
135 fh => $state{fh}, 287 push @cookie, "$k=$v->{value}";
136 ($scheme eq "https" ? (tls => "connect") : ()); 288 }
137 289 }
138 # limit the number of persistent connections
139 if ($KA_COUNT{$_[1]} < $MAX_PERSISTENT_PER_HOST) {
140 ++$KA_COUNT{$_[1]};
141 $state{handle}{ka_count_guard} = AnyEvent::Util::guard { --$KA_COUNT{$_[1]} };
142 $hdr{connection} = "keep-alive";
143 } else {
144 delete $hdr{connection};
145 } 290 }
291
292 $hdr{cookie} = join "; ", @cookie
293 if @cookie;
294 }
146 295
296 my ($rhost, $rport, $rpath); # request host, port, path
297
298 if ($proxy) {
299 ($rhost, $rport, $scheme) = @$proxy;
300 $rpath = $url;
301 } else {
302 ($rhost, $rport, $rpath) = ($uhost, $uport, $upath);
303 $hdr{host} = $uhost;
304 }
305
306 $hdr{"content-length"} = length $arg{body};
307
308 my %state = (connect_guard => 1);
309
310 _get_slot $uhost, sub {
311 $state{slot_guard} = shift;
312
313 return unless $state{connect_guard};
314
315 $state{connect_guard} = AnyEvent::Socket::tcp_connect $rhost, $rport, sub {
316 $state{fh} = shift
317 or return $cb->(undef, { Status => 599, Reason => "$!", URL => $url });
318
319 delete $state{connect_guard}; # reduce memory usage, save a tree
320
321 # get handle
322 $state{handle} = new AnyEvent::Handle
323 fh => $state{fh},
324 ($scheme eq "https" ? (tls => "connect") : ());
325
326 # limit the number of persistent connections
327 if ($KA_COUNT{$_[1]} < $MAX_PERSISTENT_PER_HOST) {
328 ++$KA_COUNT{$_[1]};
329 $state{handle}{ka_count_guard} = AnyEvent::Util::guard { --$KA_COUNT{$_[1]} };
330 $hdr{connection} = "keep-alive";
331 delete $hdr{connection}; # keep-alive not yet supported
332 } else {
333 delete $hdr{connection};
334 }
335
147 # (re-)configure handle 336 # (re-)configure handle
148 $state{handle}->timeout ($timeout); 337 $state{handle}->timeout ($timeout);
149 $state{handle}->on_error (sub { 338 $state{handle}->on_error (sub {
339 my $errno = "$!";
150 %state = (); 340 %state = ();
151 $cb->(undef, { Status => 599, Reason => "$!" }); 341 $cb->(undef, { Status => 599, Reason => $errno, URL => $url });
152 }); 342 });
153 $state{handle}->on_eof (sub { 343 $state{handle}->on_eof (sub {
154 %state = (); 344 %state = ();
155 $cb->(undef, { Status => 599, Reason => "unexpected end-of-file" }); 345 $cb->(undef, { Status => 599, Reason => "unexpected end-of-file", URL => $url });
156 }); 346 });
157 347
158 # send request 348 # send request
159 $state{handle}->push_write ( 349 $state{handle}->push_write (
160 "\U$method\E $path HTTP/1.0\015\012" 350 "$method $rpath HTTP/1.0\015\012"
161 . (join "", map "$_: $hdr{$_}\015\012", keys %hdr) 351 . (join "", map "$_: $hdr{$_}\015\012", keys %hdr)
162 . "\015\012" 352 . "\015\012"
163 . (delete $state{body}) 353 . (delete $arg{body})
164 );
165
166 %hdr = (); # reduce memory usage, save a kitten
167
168 # status line
169 $state{handle}->push_read (line => qr/\015?\012/, sub {
170 $_[1] =~ /^HTTP\/([0-9\.]+) \s+ ([0-9]{3}) \s+ ([^\015\012]+)/ix
171 or return (%state = (), $cb->(undef, { Status => 599, Reason => "invalid server response ($_[1])" }));
172
173 my %hdr = ( # response headers
174 HTTPVersion => ",$1",
175 Status => ",$2",
176 Reason => ",$3",
177 ); 354 );
178 355
356 %hdr = (); # reduce memory usage, save a kitten
357
358 # status line
359 $state{handle}->push_read (line => qr/\015?\012/, sub {
360 $_[1] =~ /^HTTP\/([0-9\.]+) \s+ ([0-9]{3}) (?: \s+ ([^\015\012]*) )?/ix
361 or return (%state = (), $cb->(undef, { Status => 599, Reason => "invalid server response ($_[1])", URL => $url }));
362
363 my %hdr = ( # response headers
364 HTTPVersion => "\x00$1",
365 Status => "\x00$2",
366 Reason => "\x00$3",
367 URL => "\x00$url"
368 );
369
179 # headers, could be optimized a bit 370 # headers, could be optimized a bit
180 $state{handle}->unshift_read (line => qr/\015?\012\015?\012/, sub { 371 $state{handle}->unshift_read (line => qr/\015?\012\015?\012/, sub {
181 for ("$_[1]\012") { 372 for ("$_[1]\012") {
373 # we support spaces in field names, as lotus domino
374 # creates them.
182 $hdr{lc $1} .= ",$2" 375 $hdr{lc $1} .= "\x00$2"
183 while /\G 376 while /\G
184 ([^:\000-\040]+): 377 ([^:\000-\037]+):
185 [\011\040]* 378 [\011\040]*
186 ((?: [^\015\012]+ | \015?\012[\011\040] )*) 379 ((?: [^\015\012]+ | \015?\012[\011\040] )*)
187 \015?\012 380 \015?\012
188 /gxc; 381 /gxc;
189 382
190 /\G$/ 383 /\G$/
191 or return $cb->(undef, { Status => 599, Reason => "garbled response headers" }); 384 or return (%state = (), $cb->(undef, { Status => 599, Reason => "garbled response headers", URL => $url }));
192 } 385 }
193 386
194 substr $_, 0, 1, "" 387 substr $_, 0, 1, ""
195 for values %hdr; 388 for values %hdr;
196 389
197 if (exists $hdr{"content-length"}) { 390 my $finish = sub {
198 $_[0]->unshift_read (chunk => $hdr{"content-length"}, sub {
199 # could cache persistent connection now
200 if ($hdr{connection} =~ /\bkeep-alive\b/i) {
201 };
202
203 %state = (); 391 %state = ();
392
393 # set-cookie processing
394 if ($arg{cookie_jar} && exists $hdr{"set-cookie"}) {
395 for (split /\x00/, $hdr{"set-cookie"}) {
396 my ($cookie, @arg) = split /;\s*/;
397 my ($name, $value) = split /=/, $cookie, 2;
398 my %kv = (value => $value, map { split /=/, $_, 2 } @arg);
399
400 my $cdom = (delete $kv{domain}) || $uhost;
401 my $cpath = (delete $kv{path}) || "/";
402
403 $cdom =~ s/^.?/./; # make sure it starts with a "."
404
405 next if $cdom =~ /\.$/;
406
407 # this is not rfc-like and not netscape-like. go figure.
408 my $ndots = $cdom =~ y/.//;
409 next if $ndots < ($cdom =~ /\.[^.][^.]\.[^.][^.]$/ ? 3 : 2);
410
411 # store it
412 $arg{cookie_jar}{version} = 1;
413 $arg{cookie_jar}{$cdom}{$cpath}{$name} = \%kv;
414 }
415 }
416
417 # microsoft and other shitheads don't give a shit for following standards,
418 # try to support some common forms of broken Location headers.
419 if ($_[1]{location} !~ /^(?: $ | [^:\/?\#]+ : )/x) {
420 $_[1]{location} =~ s/^\.\/+//;
421
422 my $url = "$scheme://$uhost:$uport";
423
424 unless ($_[1]{location} =~ s/^\///) {
425 $url .= $upath;
426 $url =~ s/\/[^\/]*$//;
427 }
428
429 $_[1]{location} = "$url/$_[1]{location}";
430 }
431
432 if ($_[1]{Status} =~ /^30[12]$/ && $recurse && $method ne "POST") {
433 # apparently, mozilla et al. just change POST to GET here
434 # more research is needed before we do the same
435 http_request ($method, $_[1]{location}, %arg, recurse => $recurse - 1, $cb);
436 } elsif ($_[1]{Status} == 303 && $recurse) {
437 # even http/1.1 is unlear on how to mutate the method
438 $method = "GET" unless $method eq "HEAD";
439 http_request ($method => $_[1]{location}, %arg, recurse => $recurse - 1, $cb);
440 } elsif ($_[1]{Status} == 307 && $recurse && $method =~ /^(?:GET|HEAD)$/) {
441 http_request ($method => $_[1]{location}, %arg, recurse => $recurse - 1, $cb);
442 } else {
204 $cb->($_[1], \%hdr); 443 $cb->($_[0], $_[1]);
444 }
205 }); 445 };
446
447 if ($hdr{Status} =~ /^(?:1..|204|304)$/ or $method eq "HEAD") {
448 $finish->(undef, \%hdr);
206 } else { 449 } else {
450 if (exists $hdr{"content-length"}) {
451 $_[0]->unshift_read (chunk => $hdr{"content-length"}, sub {
452 # could cache persistent connection now
453 if ($hdr{connection} =~ /\bkeep-alive\b/i) {
454 # but we don't, due to misdesigns, this is annoyingly complex
455 };
456
457 $finish->($_[1], \%hdr);
458 });
459 } else {
207 # too bad, need to read until we get an error or EOF, 460 # too bad, need to read until we get an error or EOF,
208 # no way to detect winged data. 461 # no way to detect winged data.
209 $_[0]->on_error (sub { 462 $_[0]->on_error (sub {
210 %state = ();
211 $cb->($_[0]{rbuf}, \%hdr); 463 $finish->($_[0]{rbuf}, \%hdr);
464 });
465 $_[0]->on_eof (undef);
466 $_[0]->on_read (sub { });
467 }
212 }); 468 }
213 $_[0]->on_eof (undef);
214 $_[0]->on_read (sub { });
215 } 469 });
216 }); 470 });
471 }, sub {
472 $timeout
217 }); 473 };
218 }, sub {
219 $timeout
220 }; 474 };
221 475
222 defined wantarray && AnyEvent::Util::guard { %state = () } 476 defined wantarray && AnyEvent::Util::guard { %state = () }
223} 477}
224 478
225sub http_get($$;@) { 479sub http_get($@) {
226 unshift @_, "GET"; 480 unshift @_, "GET";
227 &http_request 481 &http_request
228} 482}
229 483
484sub http_head($@) {
485 unshift @_, "HEAD";
486 &http_request
487}
488
489sub http_post($$@) {
490 my $url = shift;
491 unshift @_, "POST", $url, "body";
492 &http_request
493}
494
495=back
496
230=head2 GLOBAL VARIABLES 497=head2 GLOBAL FUNCTIONS AND VARIABLES
231 498
232=over 4 499=over 4
233 500
501=item AnyEvent::HTTP::set_proxy "proxy-url"
502
503Sets the default proxy server to use. The proxy-url must begin with a
504string of the form C<http://host:port> (optionally C<https:...>).
505
234=item $AnyEvent::HTTP::MAX_REDIRECTS 506=item $AnyEvent::HTTP::MAX_RECURSE
235 507
236The default value for the C<max_redirects> request parameter 508The default value for the C<recurse> request parameter (default: C<10>).
237(default: C<10>).
238 509
239=item $AnyEvent::HTTP::USERAGENT 510=item $AnyEvent::HTTP::USERAGENT
240 511
241The default value for the C<User-Agent> header (the default is 512The default value for the C<User-Agent> header (the default is
242C<Mozilla/5.0 (compatible; AnyEvent::HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)>). 513C<Mozilla/5.0 (compatible; AnyEvent::HTTP/$VERSION; +http://software.schmorp.de/pkg/AnyEvent)>).
243 514
244=item $AnyEvent::HTTP::MAX_PERSISTENT 515=item $AnyEvent::HTTP::MAX_PERSISTENT
245 516
246The maximum number of persistent connections to keep open (default: 8). 517The maximum number of persistent connections to keep open (default: 8).
247 518
519Not implemented currently.
520
248=item $AnyEvent::HTTP::PERSISTENT_TIMEOUT 521=item $AnyEvent::HTTP::PERSISTENT_TIMEOUT
249 522
250The maximum time to cache a persistent connection, in seconds (default: 15). 523The maximum time to cache a persistent connection, in seconds (default: 2).
524
525Not implemented currently.
526
527=item $AnyEvent::HTTP::ACTIVE
528
529The number of active connections. This is not the number of currently
530running requests, but the number of currently open and non-idle TCP
531connections. This number of can be useful for load-leveling.
251 532
252=back 533=back
253 534
254=cut 535=cut
255 536
537sub set_proxy($) {
538 $PROXY = [$2, $3 || 3128, $1] if $_[0] =~ m%^(https?):// ([^:/]+) (?: : (\d*) )?%ix;
539}
540
541# initialise proxy from environment
542set_proxy $ENV{http_proxy};
543
256=head1 SEE ALSO 544=head1 SEE ALSO
257 545
258L<AnyEvent>. 546L<AnyEvent>.
259 547
260=head1 AUTHOR 548=head1 AUTHOR
261 549
262 Marc Lehmann <schmorp@schmorp.de> 550 Marc Lehmann <schmorp@schmorp.de>
263 http://home.schmorp.de/ 551 http://home.schmorp.de/
264 552
265=cut 553=cut
266 554
2671 5551
268 556

Diff Legend

– Removed lines
+ Added lines
< Changed lines
> Changed lines