README

Asyncio

Modern Async Foundations for PHP

High-performance asynchronous framework for PHP with support for Revolt and Swoole

✨ Features

• High-performance asynchronous execution for modern PHP projects
• Event-loop driven architecture
• Compatible with Revolt and Swoole
• Fiber-friendly async design
• Non-blocking file, socket, and stream utilities
• Lightweight helpers for building async-first applications
• MIT licensed and easy to integrate into existing codebases

🛠️ Requirements

• PHP 8.4 or higher
• revolt/event-loop : ^1.0
• Optional : ext-swoole for high-performance coroutine support
• Optional : ext-pcntl for better signal handling

📦 Installation

Install via Composer :

composer require taknone/asyncio

Optional Extensions

pecl install swoole

🏁 Getting Started

The library is designed to be used with async-friendly code, event loops, Fibers, and non-blocking I/O

<?php

require 'vendor/autoload.php';

use function Tak\Asyncio\async;
use function Tak\Asyncio\delay;

use Tak\Asyncio\TimeoutCancellation;

$future = async(function () : void {
    echo 'Background task initialized' , PHP_EOL;
    delay(1.5);
    echo 'Background task completed' , PHP_EOL;
});

echo 'Main execution continues without blocking.' , PHP_EOL;

$future->await(new TimeoutCancellation(2));

echo 'Future resolved successfully' , PHP_EOL;

💈 Project Structure

This package is autoloaded through PSR-4 with the Tak\\Asyncio\\ namespace and includes helper files for :

• src/functions.php
• src/File/functions.php
• src/Socket/functions.php
• src/ByteStream/functions.php

That layout is ideal for helper-based async APIs that cover core runtime, file, socket, and stream operations

⁉️ Why Asyncio

Asyncio is built for developers who want a clean async layer without sacrificing PHP performance or portability. It is a good fit for :

• async services
• background workers
• socket servers
• file streaming
• high-concurrency I/O
• coroutine-based applications

⚡ Usage Notes

• Use Revolt when you want a standards-friendly event loop
• Use Swoole when you want coroutine-based high-performance execution
• Keep I/O non-blocking to get the best results
• Prefer async helpers instead of direct blocking calls inside loop-driven code

Contributing

Contributions are welcome. Please keep changes consistent with the existing architecture, naming style, and async-first design

📜 License

This project is licensed under the MIT License