Low overhead. High performance. Ready for anything.
CitOmni is a modular PHP 8.2+ framework built around deterministic execution, zero-magic boot, and measurable green performance.
It scales from tiny shared-hosting sites to enterprise-grade automation without ever changing its philosophy: explicit, deterministic, fast.
A minimal, composable foundation for PHP applications:
| Layer | Package | Purpose |
|---|---|---|
| 🧠 Core | citomni/kernel |
Deterministic config + service map |
| 🌐 HTTP | citomni/http |
Router / Request / Response |
| 💻 CLI | citomni/cli |
Command runner / Scheduler |
| 🧩 Providers | citomni/* |
Auth / Infra / Testing / etc. |
Two runtime modes. One philosophy.
-> Runtime Modes explained ›
CitOmni merges static constants - not runtime code.
Vendor baseline -> Providers -> App base -> Env overlay
- Config: deep, last-wins
- Services: left-wins (ID override surface)
- Routes: associative, per-path merge
Providers are pure declarative overlays - no reflection, no scanning, no surprises.
-> Providers & Services ›
CitOmni minimizes CPU cycles, allocations, and file I/O at the framework layer.
| Metric | Result (shared hosting, PHP 8.2 + OPcache) |
|---|---|
| Exec time | ≈ 0.004 s |
| Peak memory | ≈ 0.5 MB |
| Included files | 24 |
| Est. throughput | ~175 RPS per worker @ 70 % utilization |
-> Full report: Capacity & Green by Design (2025-10-02)
Fast software is green software - fewer joules per request, fewer servers, smaller footprint.
composer create-project citomni/http-skeleton my-app
cd my-app
php -S 127.0.0.1:8080 -t publicVisit http://127.0.0.1:8080
Append ?_perf to any URL in dev to see timing, memory, and file metrics.
More examples -> citomni/http-skeleton
- Runtime / Execution Modes
- Services & Providers
- Capacity & Green by Design Report
- Conventions & Contribution Guide
- Low overhead - no bloat, no runtime guessing.
- High performance - deterministic paths, cache-friendly arrays.
- Ready for anything - HTTP / CLI / automation, same core.
CitOmni doesn't guess. It knows.
© 2012-present Lars Grove Mortensen - MIT license (core packages). Docs © CitOmni Contributors, CC BY-SA 4.0.