Reference

WWW::Curl::Simple(3pm)

A Simpler interface to WWW::Curl

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 <[email protected]>

CONTRIBUTORS

•

Bjørn-Olav Strand <[email protected]>

•

Graham Knop <[email protected]>

•

Marcus Ramberg <[email protected]>

•

Neil Bowers <[email protected]>

•

chromatic <[email protected]>

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.

History