Mail::SPF(3)          User Contributed Perl Documentation         Mail::SPF(3)


NAME
       Mail::SPF - An object-oriented implementation of Sender Policy
       Framework

VERSION
       version 3.20260331

SYNOPSIS
           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;

DESCRIPTION
       Mail::SPF is an object-oriented implementation of Sender Policy
       Framework (SPF).  See <https://tools.ietf.org/html/rfc7208> for more
       information about SPF.

       This class collection aims to fully conform to the SPF specification
       (RFC 4408) so as to serve both as a production quality SPF
       implementation and as a reference for other developers of SPF
       implementations.

SEE ALSO
       Mail::SPF::Server, Mail::SPF::Request, Mail::SPF::Result

       For availability, support, and license information, see the README file
       included with Mail::SPF.

REFERENCES
       The SPF project
           <http://www.open-spf.org/>

       The SPFv1 specification (RFC 7208)
           <http://www.open-spf.org/Specifications>,
           <https://tools.ietf.org/html/rfc7208>

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

perl v5.42.1                      2026-04-02                      Mail::SPF(3)