Download the PHP package antevemus/alinq-revolt without Composer

Antevemus ALinq Revolt

The asynchronous companion of ALinq for PHP 8.4+
selectAsync(), whereAsync(), selectManyAsync() and eachAsync() over the Revolt event loop: each item's closure runs in its own Fiber (Amp futures), through an ordered, bounded, lazy window of items in flight, and the result is a core ALinq lazy collection, so every core operator chains after it. For per-item I/O against non-blocking clients (the Amp HTTP client, async SDKs).

🇧🇷 Português (Brasil)

The documentation lives in docs/pt-BR (Portuguese, Brazil), one page per topic, in the Docs Kit format (a docs-nav.json per language), and every PHP block of the pages is run by the test suite.

🚀 Quick Start

The same block opens Getting Started, and the test suite runs it with the answers written in its comments:

📦 Installation

Install via Composer: composer require antevemus/alinq-revolt. Requirements: PHP 8.4 or later; installed with it: antevemus/alinq-collection ^2.3 (the core, same author; 2.3.0 for the declared shape of a generator stage), revolt/event-loop ^1.0 and amphp/amp ^3.0. No PHP extension is required.

A Fiber only gains time while the code inside it waits on non-blocking I/O: blocking calls (file_get_contents(), curl_exec(), PDO) and CPU work run one after the other, whatever the concurrency. Measured against a local HTTP server, 16 requests of 200 ms: 3 222 ms through the core select() with a blocking client, 214 ms through selectAsync(concurrency: 16) with the Amp HTTP client, 3 225 ms through selectAsync() with the blocking client (Tests).

📚 Documentation

Getting started

• pt-BR: Composer, the requirements and the Quick Start.

Concepts

• pt-BR: The ordered, bounded, lazy window, early stop and cancellation, and why Fibers gain time only on non-blocking I/O.

API reference

• pt-BR: The four operators, the closure, keys, errors, time limits and a shared RevoltRunner.

Internals

• pt-BR: Why Revolt and Amp and not ReactPHP, the core's hook that knows no event loop, and what a companion for another event loop implements.

Quality

• pt-BR: The PHPUnit report, the measured timing table and the mutation testing.

Project

• pt-BR: The release shipped and what comes next; the milestone view is in ROADMAP.md.

🧪 Quality

• Tests: 99 PHPUnit tests (vendor/bin/phpunit) and 4436 assertions, 100% passing on PHP 8.4: the operators and the runner, properties against the core as the oracle, the proof of gain against a local HTTP server, and the code blocks of the documentation.
• Properties: 200 seeded inputs per property: selectAsync()/whereAsync()/selectManyAsync() answer as the core select()/where()/selectMany() for any concurrency, take(k) starts at most k + concurrency items, and the core operators downstream answer as over the synchronous version.
• Mutation testing: Infection over the whole src/, MSI 97.74% (4 escaped mutants, all equivalent); the Quality workflow requires 96%.
• The report, the timing table and the mutation run: Tests.

🗺️ Roadmap & Ecosystem

The release shipped and what comes next: Antevemus.AlinqCollection.

📄 License & Authors

This software is open-source, licensed under the MIT License.

• Author: Heliton Junior (CTO) — [email protected]
• Organization: Antevemus Soluções Inovadoras em TI Ltda.
• Copyright: Copyright (c) 2026 Antevemus Soluções Inovadoras em TI Ltda.