---
name: "Mail::SPF"
section: "3pm"
platform: "linux"
package: "perl-mail-spf"
version: "3.20260331-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/Mail::SPF"
---

# Mail::SPF(3pm)

An object-oriented implementation of Sender Policy Framework

## 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\>