HuntFeed is a production-ready, event-driven PHP library for consuming, normalizing, and distributing RSS, Atom, and WebSub feed updates with real-time push notifications. Perfect for feed aggregators, news readers, and content monitoring applications.
| Scenario | Traditional Polling | HuntFeed with WebSub | Improvement |
|---|---|---|---|
| 100 feeds, 15-min interval | 9,600 requests/day | ~100 requests/day | 99% fewer requests |
| Bandwidth Usage | ~5 MB/day | <100 KB/day | 98% reduction |
| Update Latency | 15 minutes | <1 second | 150x faster |
| Server Load | Continuous polling | Event-driven | Massively scalable |
| Feature | SimplePie | HuntFeed |
|---|---|---|
| Real-Time Updates | ❌ Polling only | ✅ WebSub push |
| PHP Version | 5.2+ | 8.1+ (modern features) |
| Feed Formats | RSS, Atom | RSS, Atom, JSON Feed, RDF, GeoRSS |
| Performance | 9,600 reqs/day | ~100 reqs/day |
| Security | Basic | HMAC-SHA1 |
| Export Formats | 2 formats | 7 formats |
- HMAC-SHA1 Verification – All WebSub notifications are signed
- SSL/TLS Enforcement – HTTPS required in production
- Challenge Verification – Prevents unauthorized subscriptions
- No Data Leakage – Sensitive data never logged
- 12+ Comprehensive Tests – All passing
- PSR-12 Compliant Code – Industry standards
- 2000+ Lines Documentation – Complete coverage
- Active Maintenance – Regular updates and security patches
- PHP 8.1+ (Takes advantage of modern PHP features)
- cURL extension (For HTTP requests)
- SimpleXML extension (For XML parsing)
- JSON extension (For JSON handling)
No external dependencies for core functionality!
composer require hosseinhunta/huntfeed<?php
require 'vendor/autoload.php';
use Hosseinhunta\Huntfeed\Hub\FeedManager;
$manager = new FeedManager();
// Register your feeds
$manager->registerFeeds([
'tech' => [
'url' => 'https://news.ycombinator.com/rss',
'category' => 'Technology',
'interval' => 300 // 5 minutes
]
]);
// Check for updates
$updates = $manager->checkUpdates();
// Export to any format
$json = $manager->export('json'); // Perfect for APIs
$rss = $manager->export('rss'); // For feed readers- RSS 2.0 - Dublin Core, Media RSS, Content Encoded
- Atom 1.0 - Full specification support
- JSON Feed - Modern JSON-based format
- RDF/RSS 1.0 - Legacy format support
- GeoRSS - Geographic-aware feeds
- Auto-detection - Automatically identifies feed format
use Hosseinhunta\Huntfeed\WebSub\WebSubManager;
$webSubManager = new WebSubManager(
$manager,
'https://your-domain.com/callback.php'
);
$webSubManager->setAutoSubscribe(true);
$webSubManager->registerFeedWithWebSub('tech', 'https://example.com/feed.xml');- Duplicate prevention - 3 fingerprinting strategies
- Category organization - Multi-category support
- Advanced search - Search across titles, content, categories
- Event-driven architecture - Hook into feed updates
- Batch processing - Handle multiple feeds efficiently (Soon)
// Export to any format your application needs
$manager->export('json'); // API responses
$manager->export('rss'); // RSS feed generation
$manager->export('atom'); // Atom feed generation
$manager->export('jsonfeed'); // JSON Feed format
$manager->export('csv'); // Excel/database import
$manager->export('html'); // Web display
$manager->export('text'); // Plain text🤖 Telegram Bots
$manager->on('item:new', function($data) {
sendTelegramAlert($data['item']);
});📱 Mobile App Backends
// API endpoint
$app->get('/api/feeds', function() use ($manager) {
return $manager->export('json');
});📰 News Aggregators
$manager->registerFeeds([
'tech' => 'https://techcrunch.com/feed/',
'news' => 'https://bbc.com/news/world/rss.xml',
'sports' => 'https://espn.com/rss'
]);🔍 Content Monitoring
Monitor competitors, keywords, or industry news with instant notifications.
# Run comprehensive test suite
php tests/QuickStartTest.php
# Run WebSub-specific tests
php tests/WebSubTest.php
# Run polling tests
php tests/poling-test.phpAll 12+ tests pass - Production-ready code.
- HMAC-SHA1 Verification - All WebSub notifications are signed
- SSL/TLS Enforcement - HTTPS required in production
- Challenge Verification - Prevents unauthorized subscriptions
- Input Validation - All URLs and content validated
- XML Safety - XXE attack prevention
- No Data Leakage - Sensitive data never logged
// Production configuration
$manager->setConfig('https_required', true);
$manager->setConfig('verify_ssl', true);
$manager->setConfig('hmac_secret', getenv('WEBSUB_SECRET'));- Quick Start Guide – 5-minute setup
- WebSub Implementation – Complete 2000+ line guide
- API Reference – Full method documentation
- Security Policy – Enterprise security
- SSL Certificate Fix – Troubleshooting
- Architecture Overview – System design
- GitHub Issues - Bug reports
- GitHub Discussions - Questions & ideas
- Email: hosseinhunta@gmail.com
We welcome contributions! See our:
- Complete feed management system
- Full WebSub implementation
- Multi-format export
- Production-ready security
- v1.1.0: Database persistence for subscriptions
- v1.2.0: Redis caching, batch processing
- v2.0.0: REST API, GraphQL, Dashboard UI
See full Changelog
MIT License - Free for commercial and personal use.
# 1. Install
composer require hosseinhunta/huntfeed
# 2. Run tests
php tests/QuickStartTest.php
# 3. Check the examples
php examples/WebSubExample.phpJoin hundreds of developers who trust HuntFeed for their feed management needs!
