LWP::P...:https(3pm) User Contributed Perl Documentation LWP::P...:https(3pm)
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.
perl v5.38.2 2024-03-18 LWP::P...:https(3pm)
Generated by dwww version 1.16 on Tue Dec 16 06:49:57 CET 2025.