Download the PHP package maestrodimateo/simple-consul without Composer
On this page you can find all versions of the php package maestrodimateo/simple-consul. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download maestrodimateo/simple-consul
More information about maestrodimateo/simple-consul
Files in maestrodimateo/simple-consul
Package simple-consul
Short Description A simple, elegant Laravel wrapper for HashiCorp Consul
License MIT
Informations about the package simple-consul
Simple Consul
A simple, elegant Laravel wrapper for HashiCorp Consul.
Built on top of friendsofphp/consul-php-sdk, this package provides a clean Facade and helper for KV store, service discovery, health checks, and distributed locking — without dealing with raw HTTP responses.
Installation
Publish the config:
Quick Start
Add to your .env:
The consul() helper is also available:
Auto Service Registration
The package can automatically register your application with Consul on boot. Just set the env variables — zero PHP code needed:
The service registers on every boot (idempotent) and Consul's health check handles cleanup when the app goes down — no deregister needed.
Manual register/deregister
Health Check Types
Configure the check type via CONSUL_HEALTH_CHECK_TYPE. Default is http.
HTTP (default)
Consul polls an endpoint on your app:
TCP
Consul checks that the port accepts connections:
gRPC
For gRPC services:
TTL
Your app sends periodic heartbeats. Consul marks the service as critical if no heartbeat is received within the TTL:
Call passCheck() periodically (e.g., in the scheduler):
Script
Consul runs a command to check health:
KV Store
Service Discovery
Health Checks
Distributed Locking
With callback (recommended)
Manual lock management
Raw SDK Access
For advanced use cases, access the underlying SDK services directly:
Configuration
KV Prefix
The kv_prefix is prepended to all KV operations automatically:
Testing
License
MIT
Credits
- Noel Mebale
- Built on friendsofphp/consul-php-sdk
All versions of simple-consul with dependencies
friendsofphp/consul-php-sdk Version ^5.3
illuminate/support Version ^12.0 || ^13.0