README for Perl extension WWW::Curl
The Perl module WWW::Curl provides an interface to the cURL library "libcurl".
See http://curl.haxx.se/ for more information on cURL and libcurl.
This module requires libcurl and the corresponding header files to be
installed. You then may install this module via the usual way
(for installation on Windows please see README.Win32):
perl Makefile.PL
make
make test
make install
The Makefile.PL script will try to use the 'curl-config' command to find
the correct headers and libcurl path. If curl.h can't be found,
either through curl-config or the internal list of guesses, you can specify
an explicit path when building the Makefile:
perl Makefile.PL /home/foo/curl/include
If you want to specify which curl-config to use instead of the first in path
set the environment variable CURL_CONFIG to point at the curl-config to use.
Minimum version requirements:
This module, starting from version 4 requires at least Perl 5.6.1 and libcurl 7.10.8.
These releases are more than 5 years old and they have multiple security vulnerabilities,
it is advised that you upgrade as soon as possible to a more recent, secure version.
Anything older than these versions of Perl and libcurl respectively is not supported.
Windows specific fixes and patches are welcome as testing is mainly focused on Linux.
The module provides the same functionality, except as noted in the documentation,
as libcurl provides to C programs. Please refer to the documentation of libcurl for the
general interface description and the WWW::Curl POD for the differences.
This software is distributed AS IS, WITHOUT WARRANTY OF ANY KIND, either
express or implied.
History:
The author of the original relase of this software is Georg Horn
Parts of the callback support were added Forrest Cahoon
More callback support, many tests, additional documentation, and Makefile
features have been added by Cris Bailiff
Curl multi support has been added by Sebastian Riedel
The current maintainers are Cris Bailiff and
Bálint Szilakszi
The latest version is available on CPAN and can be downloaded from
http://search.cpan.org/perldoc?WWW::Curl .
The source code repository is available at http://github.com/szbalint/WWW--Curl/tree .
Copyright (C) 2000-2005, 2008-2010 Daniel Stenberg, Cris Bailiff, Bálint 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.