Download the PHP package palpalani/laravel-dns-deny-list-check without Composer

Laravel DNS Deny List Check

A modern, production-ready Laravel package for checking email server IP addresses against verified DNS-based blacklists (DNSBL/RBL). This package helps ensure email deliverability by testing your mail server against 12 carefully curated, actively maintained blacklist services.

📑 Table of Contents

• Features
• Requirements
• Architecture
• Installation
• Configuration
• Usage
• Testing
• Production Considerations
• Documentation
• Tools & Standards
• Quality Metrics
• Contributing
• Security
• License

✨ Features

• 🔍 Production-Verified DNSBL Servers - Only 12 verified, functional servers (January 2025)
• 🚀 Modern PHP 8.3+ - Uses readonly properties, constructor promotion, and strict typing
• 🌐 Full IPv4 & IPv6 Support - Handles both IP versions with proper reverse notation
• ⚡ Performance Optimized - Configurable timeouts and optional concurrent checking
• 📊 Detailed Statistics - Comprehensive response data with performance metrics
• 🎯 Tier-Based Checking - Critical, Important, and Supplementary DNSBL categories
• 🔧 Laravel Integration - Service provider, facade, and configuration support
• ✅ Comprehensive Testing - 47 tests with 374 assertions using Pest
• 🛡️ Edge Case Handling - Graceful error handling and validation
• 🔒 Production Ready - Zero false positives, reliable DNSBL servers only
• 📈 Type Safe - Full PHPStan static analysis coverage

📋 Requirements

• PHP 8.3 or higher
• Laravel 11.x or 12.x
• ext-dns (for DNS lookups)

🏗️ Architecture

Built with modern PHP and Laravel best practices:

• Type Safety: Full type hints, strict types, and PHPStan analysis
• Testing: Comprehensive Pest test suite with high coverage
• Code Quality: Laravel Pint for code formatting, PHPStan for static analysis
• Performance: Optimized DNS queries with configurable timeouts

🚀 Installation

Install the package via Composer:

The service provider will be automatically registered thanks to Laravel's package auto-discovery.

Configuration (Optional)

Publish the configuration file to customize DNSBL servers:

This creates config/dns-deny-list-check.php with 12 production-verified DNSBL servers:

📖 Usage

Basic Usage

Response Structure

Advanced Configuration

Laravel Service Container

🧪 Testing

Run the comprehensive test suite:

The package includes 47 tests with 374 assertions using Pest covering:

• ✅ IPv4 and IPv6 validation
• ✅ DNSBL server connectivity
• ✅ Error handling and edge cases
• ✅ Facade functionality
• ✅ Performance testing
• ✅ Configuration validation
• ✅ Type safety and static analysis

Code Quality

🔒 Production Considerations

DNSBL Server Reliability

This package uses only verified, production-ready DNSBL servers (January 2025):

• ❌ Removed non-functional services: SORBS (shut down June 2024), SpamRats, defunct Spamhaus services
• ✅ 12 verified servers: Tested for DNS resolution, active maintenance, and low false positives
• 🎯 Tier-based approach: Critical (3), Important (4), Supplementary (5) categories

Performance Tips

Error Handling

📚 Documentation

Comprehensive documentation is available in the repository:

• API Reference
• Configuration Guide
• Performance Optimization
• DNSBL Server Guide

🔧 Tools & Standards

This package uses modern development tools and follows best practices:

• Testing: Pest PHP - A delightful PHP testing framework
• Code Style: Laravel Pint - Opinionated PHP code style fixer
• Static Analysis: PHPStan with Larastan
• CI/CD: GitHub Actions with comprehensive test matrix
• Code Quality: Automated code style fixes and static analysis on every push

📊 Quality Metrics

• ✅ 100% Type Coverage - Full type hints and PHPStan analysis
• ✅ 47 Tests - Comprehensive test suite with Pest
• ✅ 374 Assertions - Thorough validation of all features
• ✅ Zero Dependencies - No external HTTP dependencies, uses native DNS resolution
• ✅ Production Verified - Only active, reliable DNSBL servers

📋 Changelog

Please see CHANGELOG for more information on what has changed recently.

ToDo

📋 Alternative Blacklist Checking Techniques

Here are other methods beyond DNS-based blacklists for email deliverability checking:

1. API-Based Reputation Services

2. Multi-Service Aggregators

3. SURBL/URIBL Domain Checking

4. SMTP Test Connections

5. GeoIP & ASN-Based Checks

6. Machine Learning Reputation Scoring

7. Real-Time Threat Intelligence

8. Email Authentication Checks

9. Historical Analysis

10. Integration Examples

🤝 Contributing

We welcome contributions! Please see CONTRIBUTING for details.

Development Setup

Contribution Guidelines

• ✅ Follow PSR-12 coding standards (enforced by Laravel Pint)
• ✅ Write tests for new features using Pest
• ✅ Ensure PHPStan analysis passes (composer analyse)
• ✅ Update documentation accordingly
• ✅ Ensure all tests pass before submitting PR
• ✅ Follow semantic versioning for releases

🔐 Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

For security-related issues, please email [email protected] instead of using the issue tracker.

📦 Versioning

We use SemVer for versioning. For the versions available, see the tags on this repository.

👥 Credits

• palPalani - Creator and maintainer
• All Contributors - Thank you for your contributions!

Acknowledgments

• Spatie - For excellent Laravel package tools and inspiration
• DNSBL Service Providers - For maintaining public blacklist services
• Laravel Community - For feedback and testing

📄 License

The MIT License (MIT). Please see License File for more information.