---
name: "WWW::Curl::Simple"
section: "3pm"
platform: "linux"
package: "libwww-curl-simple-perl"
version: "0.100191-3"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/WWW::Curl::Simple"
---

# 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 \<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.