|
Packit |
ec7ac3 |
######################################################################
|
|
Packit |
ec7ac3 |
LWP::Protocol::https 6.06
|
|
Packit |
ec7ac3 |
######################################################################
|
|
Packit |
ec7ac3 |
|
|
Packit |
ec7ac3 |
NAME
|
|
Packit |
ec7ac3 |
LWP::Protocol::https - Provide https support for LWP::UserAgent
|
|
Packit |
ec7ac3 |
|
|
Packit |
ec7ac3 |
SYNOPSIS
|
|
Packit |
ec7ac3 |
use LWP::UserAgent;
|
|
Packit |
ec7ac3 |
|
|
Packit |
ec7ac3 |
$ua = LWP::UserAgent->new(ssl_opts => { verify_hostname => 1 });
|
|
Packit |
ec7ac3 |
$res = $ua->get("https://www.example.com");
|
|
Packit |
ec7ac3 |
|
|
Packit |
ec7ac3 |
DESCRIPTION
|
|
Packit |
ec7ac3 |
The LWP::Protocol::https module provides support for using https schemed
|
|
Packit |
ec7ac3 |
URLs with LWP. This module is a plug-in to the LWP protocol handling, so
|
|
Packit |
ec7ac3 |
you don't use it directly. Once the module is installed LWP is able to
|
|
Packit |
ec7ac3 |
access sites using HTTP over SSL/TLS.
|
|
Packit |
ec7ac3 |
|
|
Packit |
ec7ac3 |
If hostname verification is requested by LWP::UserAgent's "ssl_opts",
|
|
Packit |
ec7ac3 |
and neither "SSL_ca_file" nor "SSL_ca_path" is set, then "SSL_ca_file"
|
|
Packit |
ec7ac3 |
is implied to be the one provided by Mozilla::CA. If the Mozilla::CA
|
|
Packit |
ec7ac3 |
module isn't available SSL requests will fail. Either install this
|
|
Packit |
ec7ac3 |
module, set up an alternative "SSL_ca_file" or disable hostname
|
|
Packit |
ec7ac3 |
verification.
|
|
Packit |
ec7ac3 |
|
|
Packit |
ec7ac3 |
This module used to be bundled with the libwww-perl, but it was
|
|
Packit |
ec7ac3 |
unbundled in v6.02 in order to be able to declare its dependencies
|
|
Packit |
ec7ac3 |
properly for the CPAN tool-chain. Applications that need https support
|
|
Packit |
ec7ac3 |
can just declare their dependency on LWP::Protocol::https and will no
|
|
Packit |
ec7ac3 |
longer need to know what underlying modules to install.
|
|
Packit |
ec7ac3 |
|
|
Packit |
ec7ac3 |
SEE ALSO
|
|
Packit |
ec7ac3 |
IO::Socket::SSL, Crypt::SSLeay, Mozilla::CA
|
|
Packit |
ec7ac3 |
|
|
Packit |
ec7ac3 |
COPYRIGHT
|
|
Packit |
ec7ac3 |
Copyright 1997-2011 Gisle Aas.
|
|
Packit |
ec7ac3 |
|
|
Packit |
ec7ac3 |
This library is free software; you can redistribute it and/or modify it
|
|
Packit |
ec7ac3 |
under the same terms as Perl itself.
|
|
Packit |
ec7ac3 |
|