Mail::SPF(3)

📦
version 3.20260331 · 14 versions
, in fedora 44

💖 Mail::SPF 💖

okay bestie, so you found yourself a manual page for Mail::SPF — it lives in the User Contributed Perl Documentation section (section 3, for the record 👑), and honestly? it's kind of a banger. let's get into it.

✨ NAME ✨

Mail::SPF — an object-oriented implementation of Sender Policy Framework 💅

🌸 VERSION 🌸

this is version 3.20260331, periodt.

🎀 SYNOPSIS 🎀

here's the whole vibe in code, no notes:

    use Mail::SPF;

    my $spf_server  = Mail::SPF::Server->new();

    my $request     = Mail::SPF::Request->new(
        versions        => [1, 2],              # optional
        scope           => 'mfrom',             # or 'helo', 'pra'
        identity        => 'fred@example.com',
        ip_address      => '192.168.0.1',
        helo_identity   => 'mta.example.com'    # optional,
                                                #   for %{h} macro expansion
    );

    my $result      = $spf_server->process($request);

    print("$result\n");
    my $result_code     = $result->code;        # 'pass', 'fail', etc.
    my $local_exp       = $result->local_explanation;
    my $authority_exp   = $result->authority_explanation
        if $result->is_code('fail');
    my $spf_header      = $result->received_spf_header;

like, build a server, build a request, process it, read the result. that's the whole arc. 🦋

🌈 DESCRIPTION 🌈

okay so Mail::SPF is an object-oriented implementation of Sender Policy Framework (SPF). if you want the full lore, it's all at <https://tools.ietf.org/html/rfc7208> — go read it, it's giving academic but in a good way.

and here's the thing that makes this whole class collection lowkey iconic: it aims to fully conform to the SPF specification (RFC 4408), so it can serve double duty — it's both a production quality SPF implementation AND a reference for other developers of SPF implementations. main character energy fr fr. 💅✨

🫶 SEE ALSO 🫶

go hang out with the rest of the family:

  • Mail::SPF::Server
  • Mail::SPF::Request
  • Mail::SPF::Result

and for availability, support, and license information? check the README file included with Mail::SPF. it's all in there, iykyk. 📄💖

💜 REFERENCES 💜

The SPF project

The SPFv1 specification (RFC 7208)

👑 AUTHORS 👑

  • Julian Mehnle <julian@mehnle.net>
  • Shevek <cpan@anarres.org>

and that's a wrap, bestie!! 🎀 this page was brought to you by perl v5.42.1, dated 2026-04-23 — like, remember that date, it's part of the canon. mwah 💋✨🦋

📦 where this page comes from