LWP::Pr...::https(3)

💖 NAME 💖

Okay bestie, welcome to the LWP::Protocol::https(3) page from User Contributed Perl Documentation — you're literally in the right place, and the name is giving exactly what it says.

• LWP::Protocol::https — Provide https support for LWP::UserAgent.

---

✨ SYNOPSIS ✨

Here's the code vibe check, copy-paste energy:

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 🦋

So like, LWP::Protocol::https provides support for using https schemed URLs with LWP. It's a plug-in to the LWP protocol handling, so you don't use it directly — no cap, it's doing behind-the-scenes main character work. Once the module is installed, LWP is able to access sites using HTTP over SSL/TLS. Slay. 🔥

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.

Bestie, real talk: if Mozilla::CA isn't available, SSL requests will fail. The move is to either install this module, set up an alternative SSL_ca_file, or disable hostname verification. Choose wisely 💅

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. That's the whole glow-up, honestly. ✨

---

🔥 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.

---

This cute lil page is from perl v5.42.0, dated 2024-03-22, with footer tag LWP::Pr...::https(3) — mwah, go verify those hostnames bestie 💋✨