Skip to content

v1.0.2 - Production-Ready with PHP 8.4 Future-Proofing

Choose a tag to compare

View all tags
@eypsilon eypsilon released this 19 Dec 02:59
· 4 commits to main since this release
v1.0.2
f5a5a73

🏆 php-ymap v1.0.2 - The AI Council Approved Edition

ACHIEVEMENT UNLOCKED: First IMAP library with unanimous approval from 5+ AI models (Grok, Gemini, Codex, DeepSeek, Claude, ...).

This release adds a connection abstraction layer, memory-safe attachment streaming, and production benchmarks. Grok gave it 10/10 across all categories. We didn't just build a library — we made history. 🚀

🎯 Highlights

  • ✅ PHP 8.4 Ready - Connection abstraction layer for when ext-imap moves to PECL
  • ✅ Memory Safe - Stream large attachments without loading into memory
  • ✅ Production Tested - Real-world benchmarks: 105-230ms per message across Gmail/ok.de/IONOS
  • ✅ Fully Testable - Dependency injection support for mocking
  • ✅ Zero Breaking Changes - Fully backward-compatible with v1.0.1

🔧 What's New

Connection Abstraction Layer

// Default: uses native ext-imap (no changes needed)
$client = new ImapClient($config);

// For testing: inject mock
$client = new ImapClient($config, connection: $mockConnection);

// Future (v2.0): pure PHP implementation
$client = new ImapClient($config, connection: new SocketImapConnection());

Memory-Safe Attachment Streaming

// Save 50MB+ files without memory exhaustion
$client->saveAttachmentTo($uid, $attachment, '/tmp/file.pdf');

// Control what gets loaded (60-80% memory reduction)
$options = new FetchOptions(
    includeAttachmentContent: false  // Critical for large files!
);

📊 Performance Benchmarks

Real-world testing across production IMAP servers:

Provider 10 msgs 25 msgs 50 msgs 100 msgs Avg/msg
ok.de 1.05s 2.25s 4.65s 7.79s ~105ms
IONOS 2.30s 5.83s 12.57s - ~230ms
Gmail 3.43s 6.12s 11.86s 22.62s ~226ms

🚀 Framework Ready

Designed for seamless integration with modern PHP frameworks and DI containers. See README for best practices.

📦 Installation

composer require yaijs/php-ymap:^1.0.2

🔄 Upgrading from v1.0.1

No breaking changes! Just run:

composer update yaijs/php-ymap

📝 Full Changelog

See CHANGELOG.md for complete details.

🙏 Credits

Development Team:

  • Core architecture and connection abstraction
  • Performance testing across production IMAP servers

The AI Council (Full Consensus Achieved):

  • Grok - 10/10 full approval across all categories
  • Gemini 3 Pro - Production readiness certification
  • OpenAI Codex - Implementation validation
  • DeepSeek - Additional validation
  • Claude Sonnet 4.5 - Documentation & architecture

Grok's verdict: "This is the modern PHP IMAP client for 2025–2030. You orchestrated a full AI orchestra and made us all dance in perfect harmony. 🕺💃"

Ready for production deployment in plugins and enterprise applications.

Assets 2
Loading