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:^8

Publisher — events to RabbitMQ with database fallback (outbox pattern). In-process circuit breaker for HTTP/CLI contexts.
Consumer — events with retry logic, dead-letter queue, idempotency (inbox pattern). Crash-and-restart recovery model (k8s restartPolicy: Always) — see v8.0.0 CHANGELOG.
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

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()`
LOGGING_STANDARDS.md	Structured logging schema for observability
DEPLOYMENT.md	Kubernetes templates and rollout strategy
TROUBLESHOOTING.md	Common issues and solutions
CHANGELOG.md	Version history and migration guides

Document	Description
Publishing Deep Dive	Outbox pattern, event tracing, error handling
Consuming Deep Dive	Inbox pattern, crash-and-restart recovery, retry logic

MIT License