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