search

szbalint / WWW--Curl

Perl binding for libcurl
http://curl.haxx.se
Other
28 stars 19 forks source link

readme

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.

For example on Ubuntu installing libcurl4-openssl-dev will satisfy this dependency.

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.18 requires at least Perl 5.8.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 - https://metacpan.org/pod/WWW::Curl . The source code repository is available at https://github.com/szbalint/WWW--Curl . Copyright (C) 2000-2005, 2008-2014 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 MIT license.