PHPackages                             omegaalfa/fiber-event-loop - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Framework](/categories/framework)
4. /
5. omegaalfa/fiber-event-loop

ActiveLibrary[Framework](/categories/framework)

omegaalfa/fiber-event-loop
==========================

A lightweight, high-performance fiber-based event loop for modern PHP applications. Enables asynchronous I/O with synchronous-like syntax.

016PHP

Since Dec 19Pushed 4mo agoCompare

[ Source](https://github.com/omegaalfa/FiberEventLoop)[ Packagist](https://packagist.org/packages/omegaalfa/fiber-event-loop)[ RSS](/packages/omegaalfa-fiber-event-loop/feed)WikiDiscussions main Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

🚀 FiberEventLoop
================

[](#-fibereventloop)

[![PHP Version](https://camo.githubusercontent.com/0f16581d1180dbfd4c0e13166ec1267d4ad2f2fab8281ea6d6b284cf5c65d921/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e322532422d626c75652e737667)](https://php.net)[![License](https://camo.githubusercontent.com/8bb50fd2278f18fc326bf71f6e88ca8f884f72f179d3e555e20ed30157190d0d/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d677265656e2e737667)](LICENSE)[![Performance](https://camo.githubusercontent.com/77f74cce5e7152c81976cca303f957b7b85b4215c03b15aa3a8cb1e8924b32bb/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f706572666f726d616e63652d756c7472612d2d6f7074696d697a65642d627269676874677265656e2e737667)](README.md)[![Code Style](https://camo.githubusercontent.com/d90cbe9ce0545e3ce23bd68f5d85a5db60dada70e3a4935aacbf9126afedb1be/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f636f64652d2d7374796c652d5053522d2d31322d696e666f726d6174696f6e616c2e737667)](https://www.php-fig.org/psr/psr-12/)

**Event Loop assíncrono ultra-otimizado baseado em PHP Fibers nativos** com suporte completo a TCP, timers, streams e operações de I/O não-bloqueantes em arquitetura reativa.

> ⚡ **Zero dependências externas** | 🔥 **Performance máxima (1.500+ req/s)** | 🎯 **API limpa e intuitiva** | 🧬 **Fibers nativos do PHP 8.1+** | 📊 **Observabilidade integrada**

📋 Índice
--------

[](#-índice)

- [O que é?](#o-que-%C3%A9)
- [Características](#caracter%C3%ADsticas)
- [Comparação de Performance](#compara%C3%A7%C3%A3o-de-performance)
- [Requisitos](#requisitos)
- [Instalação](#instala%C3%A7%C3%A3o)
- [Início Rápido](#in%C3%ADcio-r%C3%A1pido)
- [Guia Completo](#guia-completo)
    - [Timers e Scheduling](#timers-e-scheduling)
    - [TCP Streams](#tcp-streams)
    - [Leitura de Arquivos](#leitura-de-arquivos)
    - [Fibers e Concorrência](#fibers-e-concorr%C3%AAncia)
    - [Gerenciamento de Erros](#gerenciamento-de-erros)
    - [Otimizações de Performance](#otimiza%C3%A7%C3%B5es-de-performance)
- [Exemplos Práticos](#exemplos-pr%C3%A1ticos)
- [API Reference Completa](#api-reference-completa)
- [Troubleshooting](#troubleshooting)
- [Contribuindo](#contribuindo)
- [Licença](#licen%C3%A7a)

---

O que é?
--------

[](#o-que-é)

FiberEventLoop é uma **biblioteca de event loop reativa** escrita em PHP puro que implementa o padrão Reactor com suporte nativo a [PHP Fibers](https://www.php.net/manual/pt_BR/language.fibers.php) (introduzidos no PHP 8.1).

Diferente de callbacks tradicionais, o FiberEventLoop permite **escrever código assíncrono com sintaxe síncrona**, mantendo a legibilidade e facilitando o debugging.

### Quando usar?

[](#quando-usar)

✅ **Ideal para:**

- Servidores TCP/HTTP assincronos
- Scrapers web em alta escala
- Processamento de streams
- Task schedulers (cron-like)
- Monitoramento em tempo real
- Microserviços
- WebSockets e conexões long-lived

❌ **Não é ideal para:**

- Aplicações síncronas simples (use Laravel/Symfony)
- Processamento pesado de CPU (use Swoole com workers)

---

Características
---------------

[](#características)

### 🎯 Core Features

[](#-core-features)

RecursoStatusDescrição**Event Loop não-bloqueante**✅Loop reativo baseado em Fibers nativos**TCP Server/Client**✅Full support a sockets + non-blocking I/O**Timers**✅`after()`, `repeat()`, `sleep()` assíncrono**Streams**✅Leitura/escrita não-bloqueante**Gerenciamento de Fibers**✅Pool, priorização, cancelamento**File I/O assíncrono**✅Leitura de arquivos sem bloqueio**Zero dependências**✅Puro PHP, sem extensões externas**Idle adaptativo**✅Reduz CPU em 90%+ quando idle**Métricas integradas**✅Observabilidade built-in### 🚀 Performance

[](#-performance)

```
┌─────────────────────────────────────────────────┐
│ Benchmark em Intel i7 16GB RAM / PHP 8.2        │
├─────────────────────────────────────────────────┤
│ Timers simultâneos:   50,000/s   (
