WWW::Curl::Simple(3pm)

WWW::Curl::Simple3pm

A simpler interface to www::curl

Usage

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

Version

version 0.100191

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.

Contributors

•

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

•

Graham Knop <[email protected]>

•

Marcus Ramberg <[email protected]>

•

Neil Bowers <[email protected]>

•

chromatic <[email protected]>

Releases

3 releases since Debian 11 (Bullseye); the text changed 1 time.

  1. 11
  2. 12–13

Author

Andreas Marienborg <[email protected]>

From libwww-curl-simple-perl 0.100191-3 in Debian 13 (Trixie). Parsed by carta from the page's man source.