countless-integers/laravel-health-check

Customizable health-checks Laravel applications

3.0.0 2024-04-15 15:30 UTC

README

build

Installation

PHP 8.0+ is required.

$ composer require countless-integers/laravel-health-check
$ php artisan vendor:publish

Configuration

Package publishes its config to your project's and it can be found at config/health-check.php.

Gotchas

  • even though all checker classes are optional, all the libraries that they depend on are not
  • no aliases for check, instead check class names are used

Configuration keys

checkers

List of checker classes that should run on service check. By default, all available checkers are included in the exported configuration. You can disable the ones you don`t want by removing their key from this array.

Some of the checkers can or need to be configured. List of available configuration options:

extended_checks

Same format as checkers, but these checks are only run if the endpoint was called with extended option (see below).

Other options

Contribution guidelines

PR-s need to:

  • include a description explaining the problem and solution
  • pass static analysis (uses psalm, ran on CI)
  • pass test (uses codeception, ran on CI)

Running tests

You can use composer scripts:

  • to run all tests:

      $ composer test
    
  • to run only unit tests:

      $ composer unit-test
    
  • to run only unit tests with test coverage:

      $ composer unit-test-coverage
    
  • to view the coverage report (mac only):

      $ composer coverage-report
    
  • to run static analysis:

      $ composer static-analysis
    
  • to run all:

      $ composer qa