The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

WWW::Curl::Simple - A Simpler interface to WWW::Curl

VERSION

version 0.100191

SYNOPSIS

    my $curl = WWW::Curl::Simple->new();

    my $res  = $curl->get('http://www.google.com/');

ATTRIBUTES

timeout / timeout_ms

Sets the timeout of individual requests, in seconds or milliseconds.

max_redirects

Sets the maximum number of redirects that should be transparently followed. Set this to 0 if you don't want to follow redirects. Default: 5.

check_ssl_certs

Specifies whether the underlying Curl library should check SSL certificates when making https requests. Defaults to 1 (i.e. do check certs, to err on safe side).

ssl_cert_bundle

Specifies the bundle to look for CA certificates in. Leave blank for system default, which should work if your libcurl is properly compiled.

connection_timeout /connection_timeout_ms

Sets the timeout of the connect phase of requests, in seconds or milliseconds.

fatal

Defaults to true, but if set to false, it will make failure in multi-requests warn instead of die.

METHODS

request($req)

$req should be a HTTP::Request object.

If you have a URI string or object, look at the get method instead. Returns a WWW::Curl::Simple::Request object.

get($uri || URI)

Accepts one parameter, which should be a reference to a URI object or a string representing a URI. Returns a HTTP::Response object.

post($uri || URI, $form)

Creates a HTTP::Request of type POST to $uri, which can be a string or a URI object, and sets the form of the request to $form. See HTTP::Request for more information on the format of $form.

add_request($req)

Adds $req (a HTTP::Request object) to the list of URLs to fetch. Returns a WWW::Curl::Simple::Request object.

register($req)

An alias for add_request.

has_request $request

Will return true if $request is one of the object's requests.

delete_request $req

Removes $req from the object's list of requests.

perform

Does all the requests added with add_request and returns a list of WWW::Curl::Simple::Request objects.

wait

This method is here to provide an easier transition from LWP::Parallel::UserAgent. It is by no means a drop in replacement, but using wait instead of perform makes the return value more like that of LWP::UA.

AUTHOR

Andreas Marienborg <andremar@cpan.org>

CONTRIBUTORS

  • Bjørn-Olav Strand <bo@startsiden.no>

  • Graham Knop <haarg@haarg.org>

  • Marcus Ramberg <marcus@nordaaker.com>

  • Neil Bowers <neil@bowers.com>

  • chromatic <chromatic@wgz.org>

COPYRIGHT AND LICENSE

This software is copyright (c) 2013 by Andreas Marienborg.

This is free software; you can redistribute it and/or modify it under the same terms as the Perl 5 programming language system itself.