/ 
WWW-CurlOO-0.11_51
/ WWW::CurlOO

NAME

WWW::CurlOO - Perl interface for libcurl

WARNING

THIS MODULE IS UNDER HEAVY DEVELOPEMENT AND SOME INTERFACE MAY CHANGE YET.

SYNOPSIS

use WWW::CurlOO;
print $WWW::CurlOO::VERSION;

print WWW::CurlOO::version();

DOCUMENTATION

WWW::CurlOO 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 http://curl.haxx.se.

DESCRIPTION

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 WWW::CurlOO qw(:constants);

To perform any request you want WWW::CurlOO::Easy.

FUNCTIONS

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

version

Returns libcurl version string.

my $libcurl_verstr = WWW::CurlOO::version();
# prints something like:
# libcurl/7.21.4 GnuTLS/2.10.4 zlib/1.2.5 c-ares/1.7.4 libidn/1.20 libssh2/1.2.7 librtmp/2.3
print $libcurl_verstr;

Calls curl_version(3) function.

version_info

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

my $libcurl_ver = WWW::CurlOO::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 WWW::CurlOO qw(:constants);
unless ( WWW::CurlOO::version_info()->{features} & CURL_VERSION_SSL ) {
    die "SSL support is required\n";
}
getdate

Decodes date string returning its numerical value, in seconds.

my $time = WWW::CurlOO::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.

CONSTANTS

CURL_VERSION_* and CURLVERSION_*

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

LIBCURL_*

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

AUTHORS

This package was mostly rewritten by Przemyslaw Iskra <sparky at pld-linux.org>.

It is based on WWW::Curl developed by Cris Bailiff <c.bailiff+curl at devsecure.com> and Balint Szilakszi <szbalint at cpan.org>.

Original Author Georg Horn <horn@koblenz-net.de>, with additional callback, pod and test work by Cris Bailiff <c.bailiff+curl@devsecure.com> and Forrest Cahoon <forrest.cahoon@merrillcorp.com>. Sebastian Riedel added ::Multi and Anton Fedorov (datacompboy <at> mail.ru) added ::Share. Balint Szilakszi repackaged the module into a more modern form.

COPYRIGHT

Copyright (c) 2011 Przemyslaw Iskra.

Copyright (C) 2000-2005,2008-2010 Daniel Stenberg, Cris Bailiff, Sebastian Riedel, Balint Szilakszi et al.

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.

SEE ALSO

http://curl.haxx.se

libcurl(3)