Download the PHP package sanmai/round-robin without Composer
On this page you can find all versions of the php package sanmai/round-robin. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download sanmai/round-robin
More information about sanmai/round-robin
Files in sanmai/round-robin
Package round-robin
Short Description Minimal round-robin scheduler for PHP Fibers
License Apache-2.0
FAQ
Example:
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Informations about the package round-robin
sanmai/round-robin
A minimal, dependency-free round-robin scheduler for PHP Fibers.
A thin layer for cooperative multitasking:
- no event loop
- no promises
- no futures
- no async/await syntax
- no I/O magic
You write synchronous-looking code, insert Fiber::suspend() where it makes sense,
and the scheduler resumes fibers in round-robin order.
Installation
Design goals
- Explicit control flow - fibers yield only where you say so
- Deterministic scheduling - simple round-robin, no heuristics
- Shared memory model - no message passing abstraction
- Zero dependencies
- Tiny surface area - easy to read, audit, and modify
Non-goals:
- Non-blocking I/O
- Parallelism
- Promises / futures
- Structured concurrency
- Cancellation graphs
If you need those, use Amp or Revolt instead.
Quality assurance
This library maintains 100% code coverage and 100% mutation score with Infection. Tests cover every line and every mutation.
Basic usage
Creating a scheduler
Adding fibers
Running
Output:
Passing data between fibers
Fibers share memory. Use ordinary PHP data structures.
API
RoundRobin\Scheduler
add(Fiber $fiber): void
Adds a fiber to the scheduler.
- Fibers may be added before or after
run() - A fiber is scheduled until it terminates
run(): void
Runs all scheduled fibers until all of them terminate.
Behavior:
- starts fibers that have not yet started
- resumes suspended fibers
- skips terminated fibers
- stops when no runnable fibers remain
tick(): bool
Runs a single round of scheduling.
Returns:
trueif at least one fiber was executedfalseif all fibers are terminated
Useful for embedding the scheduler into an existing loop.
How scheduling works
- Only one fiber runs at a time
- Fibers must call
Fiber::suspend()to yield - The scheduler resumes fibers in FIFO order
- There is no preemption
- Blocking I/O blocks the entire process
This is cooperative multitasking by design.
About I/O
This library does not make I/O non-blocking.
If a fiber performs blocking I/O:
- the entire PHP process blocks
- no other fiber runs
If you need:
- non-blocking file or socket I/O
- readiness notifications
- timers
Use an event loop (e.g. Revolt) or integrate stream_select() yourself.
When to use this
Use this when you need:
- incremental Fiber adoption
- structured long-running logic
- explicit yield points
- deterministic execution
- no framework lock-in
Skip if you need:
- async/await semantics
- transparent non-blocking I/O
- parallelism
- cancellation propagation
License
Apache-2.0
