Skip to content

ziming/laravel-domain-health-check

Repository files navigation

Domain Health Check for Laravel Health and Oh Dear

Latest Version on Packagist GitHub Tests Action Status GitHub Code Style Action Status Total Downloads

Domain Health Check for Spatie Laravel Health Package. Which also works with Oh Dear monitoring service.

It 1st attempts an RDAP lookup for the domain expiry date, if that fails (e.g. many TLDs do not support RDAP yet), it falls back to a WHOIS lookup.

This fills a missing gap in Oh Dear as Oh Dear only supports RDAP domain expiry checks at the moment, which does not work for many TLDs.

So by using this package, you get to monitor your domain expiry dates in both Laravel Health and Oh Dear even if your domain TLD does not support RDAP.

You may also wish to check out my other Laravel Health related packages that fills in the missing gaps in Laravel Health and Oh Dear monitoring:

Support me

You can donate to my GitHub sponsor or use my referral link for Oh Dear so I get a small reward if you become a paid customer in the future. This comes at no extra cost to you and helps support my open source work.

https://ohdear.app/?via=laravel-health-domain-check

Installation

You can install the package via composer:

composer require ziming/laravel-domain-health-check

Usage

// In your Laravel Health Service Provider register() method

use Spatie\Health\Facades\Health;
use Ziming\LaravelDomainHealthCheckHealthCheck\DomainCheck;

Health::checks([
    DomainCheck::new()
        ->daily()
        ->domain('example.com') // by default, it uses your app.url config host if you did not call this method
        ->warnWhenDaysLeftToDomainExpiry(28)
        ->failWhenDaysLeftToDomainExpiry(7),
]);

If it works you will be getting the following in Laravel Health and Oh Dear

Laravel Health Screenshot Oh Dear Screenshot

Testing

composer test

Changelog

Please see CHANGELOG for more information on what has changed recently.

Contributing

Please see CONTRIBUTING for details.

Security Vulnerabilities

Please review our security policy on how to report security vulnerabilities.

Credits

License

The MIT License (MIT). Please see License File for more information.