phpman > perldoc > LWP::Protocol::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.