Net::Curl - Perl interface for libcurl


 use Net::Curl;
 print $Net::Curl::VERSION;

 print Net::Curl::version();


Net::Curl provides a Perl interface to libcurl created with object-oriented implementations in mind. This documentation contains Perl-specific details and quirks. For more information consult libcurl man pages and documentation at


This package contains some static functions and version-releated constants. It does not export by default anything, but constants can be exported upon request.

 use Net::Curl qw(:constants);

To perform any request you want Net::Curl::Easy.


None of those functions are exported, you must use fully qualified names.


Returns libcurl version string.

 my $libcurl_verstr = Net::Curl::version();
 # prints something like:
 # libcurl/7.21.4 GnuTLS/2.10.4 zlib/1.2.5 c-ares/1.7.4 ...
 print $libcurl_verstr;

Calls curl_version(3) function.


Returns a hashref with the same information as curl_version_info(3).

 my $libcurl_ver = Net::Curl::version_info();
 print Dumper( $libcurl_ver );

Example for version_info with age CURLVERSION_FOURTH:

 age => 3,
 version => '7.21.4',
 version_num => 464132,
 host => 'x86_64-pld-linux-gnu',
 features => 18109,
 ssl_version => 'GnuTLS/2.10.4'
 ssl_version_num => 0,
 libz_version => '1.2.5',
 protocols => [ 'dict', 'file', 'ftp', 'ftps', 'gopher', 'http',
                'https', 'imap', 'imaps', 'ldap', 'ldaps', 'pop3',
                'pop3s', 'rtmp', 'rtsp', 'scp', 'sftp', 'smtp',
                'smtps', 'telnet', 'tftp' ],
 ares => '1.7.4',
 ares_num => 67332,
 libidn => '1.20',
 iconv_ver_num => 0,
 libssh_version => 'libssh2/1.2.7',

You can import constants if you want to check libcurl features:

 use Net::Curl qw(:constants);
 my $vi = Net::Curl::version_info();
 unless ( $vi->{features} & CURL_VERSION_SSL ) {
     die "SSL support is required\n";

Decodes date string returning its numerical value, in seconds.

 my $time = Net::Curl::getdate( "GMT 08:49:37 06-Nov-94 Sunday" );
 my $timestr = gmtime $time;
 print "$timestr\n";
 # Sun Nov  6 08:49:37 1994

See curl_getdate(3) for more info on supported input formats.



Can be used for decoding version_info() values. curl_version_info(3)


Can be used for determining buildtime libcurl version. Some Net::Curl features will not be available if it was built with older libcurl, even if runtime libcurl version has necessary features.


Implemented interface is solid, there should be no more changes to it. Only new features will be added.

This package tries very hard to not allow user do anything that could make libcurl crash, but there still may be some corner cases where that happens.


This package was mostly rewritten by Przemyslaw Iskra <sparky at>.


Module started as an extension to WWW::Curl developed by Cris Bailiff <c.bailiff+curl at>, Balint Szilakszi <szbalint at> and a long list of contributors. However, currently it shares no common code.


Copyright (c) 2011-2015 Przemyslaw Iskra.

You may opt to use, copy, modify, merge, publish, distribute and/or sell copies of the Software, and permit persons to whom the Software is furnished to do so, under the terms of the MPL or the MIT/X-derivate licenses. You may pick one of these licenses.


Net::Curl::Easy Net::Curl::Compat Net::Curl::examples libcurl(3)