yevhenlisovenko/nano-service

nano-service

v7.5.0 2026-02-13 19:19 UTC

Requires

• php: ^8.4
• ext-curl: *
• league/statsd: ^2.0
• monolog/monolog: ^2.0 || ^3.0
• myclabs/php-enum: ^1.8
• php-amqplib/php-amqplib: ^3.7.3
• psr/log: ^1.0 || ^2.0 || ^3.0
• ramsey/uuid: ^3 || ^4
• spatie/crypto: ^2.0

Requires (Dev)

• phpunit/phpunit: ^9.6

MIT

• Awescode GmbH

README

PHP library for event-driven microservices using RabbitMQ.

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

Installation

composer require yevhenlisovenko/nano-service:^7.5

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

Document	Description
CONFIGURATION.md	All environment variables
METRICS.md	All metrics, tags, and when they fire
INTEGRATION.md	How to integrate as publisher or consumer
TRACE_USAGE.md	Distributed tracing with appendTraceId()
DEPLOYMENT.md	Kubernetes templates and rollout strategy
TROUBLESHOOTING.md	Common issues and solutions
CHANGELOG.md	Version history and migration guides

Architecture

Document	Description
Publishing Deep Dive	Outbox pattern, event tracing, error handling
Consuming Deep Dive	Inbox pattern, circuit breaker, retry logic

Development

Document	Description
CLAUDE.md	LLM development rules
Code Review	Code review checklist
Bug Fixes	Known issues and fixes

License

MIT License