# phpman > info > LWP::Protocol::https

[LWP::Protocol::https](https://www.chedong.com/phpMan.php/perldoc/LWP%3A%3AProtocol%3A%3Ahttps/markdown)(3User Contributed Perl [DocumentaLWP::Protocol](https://www.chedong.com/phpMan.php/perldoc/DocumentaLWP%3A%3AProtocol/markdown)::[https(3pm)](https://www.chedong.com/phpMan.php/man/https/3pm/markdown)

NAME
       [LWP::Protocol::https](https://www.chedong.com/phpMan.php/perldoc/LWP%3A%3AProtocol%3A%3Ahttps/markdown) - Provide https support for [LWP::UserAgent](https://www.chedong.com/phpMan.php/perldoc/LWP%3A%3AUserAgent/markdown)

SYNOPSIS
         use [LWP::UserAgent](https://www.chedong.com/phpMan.php/perldoc/LWP%3A%3AUserAgent/markdown);

         $ua = [LWP::UserAgent](https://www.chedong.com/phpMan.php/perldoc/LWP%3A%3AUserAgent/markdown)->new(ssl_opts => { verify_hostname => 1 });
         $res = $ua->get("<https://www.example.com>");

         # specify a CA path
         $ua = [LWP::UserAgent](https://www.chedong.com/phpMan.php/perldoc/LWP%3A%3AUserAgent/markdown)->new(
             ssl_opts => {
                 SSL_ca_path     => '/etc/ssl/certs',
                 verify_hostname => 1,
             }
         );

DESCRIPTION
       The [LWP::Protocol::https](https://www.chedong.com/phpMan.php/perldoc/LWP%3A%3AProtocol%3A%3Ahttps/markdown) 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](https://www.chedong.com/phpMan.php/perldoc/LWP%3A%3AUserAgent/markdown)'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](https://www.chedong.com/phpMan.php/perldoc/Mozilla%3A%3ACA/markdown).  If the [Mozilla::CA](https://www.chedong.com/phpMan.php/perldoc/Mozilla%3A%3ACA/markdown)
       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](https://www.chedong.com/phpMan.php/perldoc/LWP%3A%3AProtocol%3A%3Ahttps/markdown) and will no
       longer need to know what underlying modules to install.

SEE ALSO
       [IO::Socket::SSL](https://www.chedong.com/phpMan.php/perldoc/IO%3A%3ASocket%3A%3ASSL/markdown), [Crypt::SSLeay](https://www.chedong.com/phpMan.php/perldoc/Crypt%3A%3ASSLeay/markdown), [Mozilla::CA](https://www.chedong.com/phpMan.php/perldoc/Mozilla%3A%3ACA/markdown)

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.32.0                      2020-12-21         [LWP::Protocol](https://www.chedong.com/phpMan.php/perldoc/LWP%3A%3AProtocol/markdown)::[https(3pm)](https://www.chedong.com/phpMan.php/man/https/3pm/markdown)