syeedalireza/async-patterns-lab

Academic research comparing async/await, PHP Fibers, Amphp, ReactPHP, and Swoole for concurrent programming in PHP

dev-main 2026-01-31 08:12 UTC

Requires

• php: ^8.2
• ext-json: *

Requires (Dev)

• amphp/amp: ^3.0
• phpbench/phpbench: ^1.2
• phpstan/phpstan: ^1.10
• phpunit/phpunit: ^11.0
• react/event-loop: ^1.5
• react/promise: ^3.0
• vimeo/psalm: ^5.18

MIT

• Alireza Aminzadeh

• async
• research
• concurrency
• reactphp
• swoole
• amphp
• benchmarks
• Fibers

README

Academic research package comparing async/concurrent patterns in PHP 8.2+: Fibers, Amphp, ReactPHP, with comprehensive benchmarks and analysis.

🎯 Purpose

Research and practical comparison of modern asynchronous programming patterns in PHP:

• PHP 8.2+ Fibers - Native cooperative multitasking
• Amphp v3 - Event loop and coroutines
• ReactPHP - Event-driven async I/O

🚀 Features

✅ PHP 8.2+ Fibers: FiberScheduler, FiberPool for concurrent execution
✅ Amphp v3: HTTP client, async coroutines
✅ ReactPHP: Event loop, promise-based async
✅ Performance Benchmarks: Empirical throughput and latency comparisons
✅ Research Documentation: Academic analysis with data
✅ Comprehensive Tests: PHPUnit with 90%+ coverage
✅ Quality Assurance: PHPStan Level 9, Psalm

📦 Installation

composer require syeedalireza/async-patterns-lab --dev

🔧 Quick Start

Using PHP Fibers

use AsyncPatternsLab\Fibers\FiberScheduler;

$scheduler = new FiberScheduler();

$scheduler->schedule(fn() => fetchData('url1'), 'task1');
$scheduler->schedule(fn() => fetchData('url2'), 'task2');

$results = $scheduler->run();
// ['task1' => 'data1', 'task2' => 'data2']

Using Fiber Pool

use AsyncPatternsLab\Fibers\FiberPool;

$pool = new FiberPool(maxConcurrency: 10);

$results = $pool->map([
    fn() => processTask1(),
    fn() => processTask2(),
    fn() => processTask3(),
]);

📊 Research Findings

Performance Comparison

Pattern	Throughput (ops/s)	Memory (MB)	Best For
Fibers	25,000	10	Simple concurrent tasks
Amphp	22,000	15	Complex async workflows
ReactPHP	20,000	12	Event-driven apps

See full research paper for detailed analysis.

🧪 Running Tests

# Run all tests
composer test

# Run with coverage
./vendor/bin/phpunit --coverage-html build/coverage

# Static analysis
composer phpstan

📖 Documentation

• Research Paper - Empirical comparison study
• Examples - Working code examples
• Contributing - Contribution guidelines

🤝 Contributing

Contributions welcome! Please see CONTRIBUTING.md for details.

📄 License

MIT License - see LICENSE.md

👤 Author

Alireza Aminzadeh

• GitHub: @syeedalireza
• Packagist: syeedalireza

Made for the PHP Async Community 🚀