PHPackages                             yevhenlisovenko/nano-service - 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. [Queues & Workers](/categories/queues)
4. /
5. yevhenlisovenko/nano-service

ActiveLibrary[Queues & Workers](/categories/queues)

yevhenlisovenko/nano-service
============================

nano-service

v7.5.2(3mo ago)44.6k↑66.7%MITPHPPHP ^8.4

Since Aug 20Pushed 3mo ago1 watchersCompare

[ Source](https://github.com/yevhenlisovenko/php-nano-service)[ Packagist](https://packagist.org/packages/yevhenlisovenko/nano-service)[ Docs](https://github.com/yevhenlisovenko/nano-service)[ RSS](/packages/yevhenlisovenko-nano-service/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (10)Dependencies (8)Versions (46)Used By (0)

Nano-Service
============

[](#nano-service)

PHP library for event-driven microservices using RabbitMQ.

Reliable event publishing and consuming with outbox/inbox pattern, circuit breaker, idempotency, and observability.

Installation
------------

[](#installation)

```
composer require yevhenlisovenko/nano-service:^7.5
```

Features
--------

[](#features)

- **Publisher** — events to RabbitMQ with database fallback (outbox pattern)
- **Consumer** — events with retry logic, dead-letter queue, idempotency (inbox pattern)
- **Circuit breaker** — automatic outage detection and graceful degradation
- **Metrics** — opt-in StatsD metrics for publisher, consumer, HTTP, and connections
- **Connection pooling** — shared static connections/channels, prevents channel exhaustion
- **Distributed tracing** — trace\_id chains across event hops

Documentation
-------------

[](#documentation)

DocumentDescription[CONFIGURATION.md](docs/CONFIGURATION.md)All environment variables[METRICS.md](docs/METRICS.md)All metrics, tags, and when they fire[INTEGRATION.md](docs/INTEGRATION.md)How to integrate as publisher or consumer[TRACE\_USAGE.md](docs/TRACE_USAGE.md)Distributed tracing with `appendTraceId()`[LOGGING\_STANDARDS.md](docs/LOGGING_STANDARDS.md)Structured logging schema for observability[DEPLOYMENT.md](docs/DEPLOYMENT.md)Kubernetes templates and rollout strategy[TROUBLESHOOTING.md](docs/TROUBLESHOOTING.md)Common issues and solutions[CHANGELOG.md](docs/CHANGELOG.md)Version history and migration guides### Architecture

[](#architecture)

DocumentDescription[Publishing Deep Dive](docs/ARCHITECTURE_PUBLISHING_DEEP_DIVE.md)Outbox pattern, event tracing, error handling[Consuming Deep Dive](docs/ARCHITECTURE_CONSUMING_DEEP_DIVE.md)Inbox pattern, circuit breaker, retry logic### Development

[](#development)

DocumentDescription[CLAUDE.md](CLAUDE.md)LLM development rules[Code Review](docs/development/CODE_REVIEW.md)Code review checklist[Bug Fixes](docs/development/BUGFIXES.md)Known issues and fixesLicense
-------

[](#license)

MIT License

###  Health Score

51

—

FairBetter than 96% of packages

Maintenance82

Actively maintained with recent releases

Popularity26

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 90.8% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~13 days

Recently: every ~0 days

Total

42

Last Release

92d ago

Major Versions

v2.4.0 → v3.0.02025-06-19

v3.1.0 → v4.0.02026-01-06

v4.0.0 → v5.0.02026-01-16

v5.0.0 → v6.0.02026-01-19

v6.8.0 → v7.0.02026-02-09

PHP version history (2 changes)v1.8.0PHP ^8.1

v7.4.5PHP ^8.4

### Community

Maintainers

![](https://www.gravatar.com/avatar/7932461f5d3d8775210ba7ff5487258ff23c274648a9936341112158aa487480?d=identicon)[Yevhen L.](/maintainers/Yevhen%20L.)

---

Top Contributors

[![begimov](https://avatars.githubusercontent.com/u/3600510?v=4)](https://github.com/begimov "begimov (59 commits)")[![yevhenlisovenko](https://avatars.githubusercontent.com/u/11060056?v=4)](https://github.com/yevhenlisovenko "yevhenlisovenko (6 commits)")

---

Tags

asyncdistributed-systemsevent-busevent-drivenmessage-queuemicroservicesnanomsgphpphp-messagingphp-rabbitmqpubsubqueueingrabbitmq

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/yevhenlisovenko-nano-service/health.svg)

```
[![Health](https://phpackages.com/badges/yevhenlisovenko-nano-service/health.svg)](https://phpackages.com/packages/yevhenlisovenko-nano-service)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.7k509.9M17.0k](/packages/laravel-framework)[magento/community-edition

Magento 2 (Open Source)

12.1k52.1k10](/packages/magento-community-edition)[shopware/platform

The Shopware e-commerce core

3.3k1.5M3](/packages/shopware-platform)[wheelpros/fitment-platform-api

Magento 2 (Open Source)

12.1k1.2k](/packages/wheelpros-fitment-platform-api)[laravel/nightwatch

The official Laravel Nightwatch package.

3526.1M13](/packages/laravel-nightwatch)[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

595.2M386](/packages/shopware-core)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)