chocofamilyme/laravel-healthcheck

Serves functionality of healthchecks of your application

4.0.0 2023-03-07 07:41 UTC

Requires

• php: ^8.0.2
• ext-json: *
• illuminate/cache: ^8.0|^9.0|^10.0
• illuminate/database: ^8.0|^9.0|^10.0
• illuminate/http: ^8.0|^9.0|^10.0
• illuminate/routing: ^8.0|^9.0|^10.0
• illuminate/session: ^8.0|^9.0|^10.0
• illuminate/support: ^8.0|^9.0|^10.0

Requires (Dev)

• squizlabs/php_codesniffer: ^3.5
• vimeo/psalm: ^4.3

BSD-3-Clause

• IT Chocolife.me

• laravel
• status
• healthcheck

README

Health Check library adds new endpoints(routes) to your project which are used to check some services of your application. For example you want to check "Database Connection" of your microservice.

Installation

composer require chocofamilyme/laravel-healthcheck ^2.0

Publishing the configuration (optional)

php artisan vendor:publish --provider="Chocofamilyme\LaravelHealthCheck\Providers\HealthCheckServiceProvider"

Checks

• Database connection check
• Cache write&read check
• Sessions write&read check
• Storage check

Routes

• /health

{
  "DB": "OK",
  "CACHE": "OK",
  "SESSIONS": "CRITICAL",
  "STORAGE": "OK"
}

• /health/extended

{
  "DB": {
    "STATUS": "OK",
    "STATUS_BOOL": true,
    "MESSAGE": null
  },
  "CACHE": {
    "STATUS": "OK",
    "STATUS_BOOL": true,
    "MESSAGE": null
  },
  "SESSIONS": {
    "STATUS": "CRITICAL",
    "STATUS_BOOL": false,
    "MESSAGE": "Connection to tarantool.example.com failed"
  },
  "STORAGE": {
    "STATUS": "OK",
    "STATUS_BOOL": true,
    "MESSAGE": null
  }
}

How to write your custom checks

Create a class which implements Chocofamilyme\LaravelHealthCheck\Services\Checks\ComponentCheckInterface and add it to healthcheck.php config file like

return [
    'componentChecks' => [
        'YOURCUSTOMCHECK' => YourCustomCheck::class
    ]
]

Responses

There is a configuration param which describes which response class to use to output the response. For example

• /health - Chocofamilyme\LaravelHealthCheck\Responses\Response::class output would look like this

{
  "DB": "OK",
  "CACHE": "OK",
  "SESSIONS": "CRITICAL",
  "STORAGE": "OK"
}

• /health - Chocofamilyme\LaravelHealthCheck\Responses\Response::class output would look like this

{
    "data": {
        "DB": "OK",
        "CACHE": "OK",
        "SESSIONS": "CRITICAL",
        "STORAGE": "OK"
    }
}

Feel free to add your responses, if you want for example to output it in a view instead json.