PHPackages                             ziming/laravel-domain-health-check - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility &amp; Helpers](/categories/utility)
4. /
5. ziming/laravel-domain-health-check

ActiveLibrary[Utility &amp; Helpers](/categories/utility)

ziming/laravel-domain-health-check
==================================

Whois Domain Health Check for Laravel Health and Oh Dear. May Support RDAP in future.

1.2(3mo ago)07.2k↓25.3%[1 PRs](https://github.com/ziming/laravel-domain-health-check/pulls)MITPHPPHP ^8.2CI passing

Since Nov 20Pushed 1w agoCompare

[ Source](https://github.com/ziming/laravel-domain-health-check)[ Packagist](https://packagist.org/packages/ziming/laravel-domain-health-check)[ Docs](https://github.com/ziming/laravel-domain-health-check)[ GitHub Sponsors](https://github.com/ziming)[ RSS](/packages/ziming-laravel-domain-health-check/feed)WikiDiscussions main Synced 3d ago

READMEChangelog (4)Dependencies (30)Versions (9)Used By (0)

Domain Health Check for Laravel Health and Oh Dear
==================================================

[](#domain-health-check-for-laravel-health-and-oh-dear)

[![Latest Version on Packagist](https://camo.githubusercontent.com/4f1e9e167189d0f3185a7b8934ccc6d71ac7db00f62f6f55b83d0f16ffef9eb6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f7a696d696e672f6c61726176656c2d646f6d61696e2d6865616c74682d636865636b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ziming/laravel-domain-health-check)[![GitHub Tests Action Status](https://camo.githubusercontent.com/59ac5dfcf2041ed7317b85825260e03ede5a8f8f31611c4f25c3c0ef0ed66914/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7a696d696e672f6c61726176656c2d646f6d61696e2d6865616c74682d636865636b2f72756e2d74657374732e796d6c3f6272616e63683d6d61696e266c6162656c3d7465737473267374796c653d666c61742d737175617265)](https://github.com/ziming/laravel-domain-health-check/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://camo.githubusercontent.com/6c8eb31709a6e160288ebff865f2a2603639c69dd6fa9ab1eb8aba4e5a956cb8/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f616374696f6e732f776f726b666c6f772f7374617475732f7a696d696e672f6c61726176656c2d646f6d61696e2d6865616c74682d636865636b2f6669782d7068702d636f64652d7374796c652d6973737565732e796d6c3f6272616e63683d6d61696e266c6162656c3d636f64652532307374796c65267374796c653d666c61742d737175617265)](https://github.com/ziming/laravel-domain-health-check/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/f43724d5736284f0e62be44e135ae4b52fad2adca48947039ccad34c0e43cced/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f7a696d696e672f6c61726176656c2d646f6d61696e2d6865616c74682d636865636b2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/ziming/laravel-domain-health-check)

Domain Health Check for [Spatie Laravel Health](https://github.com/spatie/laravel-health) Package. Which also works with [Oh Dear](https://ohdear.app/?via=laravel-health-domain-check) 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](https://ohdear.app/?via=laravel-health-domain-check) 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.

In the future there may be more domain related health checks added to this package.

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:

- [Memory Usage Health Check](https://github.com/ziming/laravel-memory-health-check)

Support me
----------

[](#support-me)

You can donate to my GitHub sponsor or use my referral link for [Oh Dear](https://ohdear.app/?via=laravel-health-domain-check) 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.

Installation
------------

[](#installation)

You can install the package via composer:

```
composer require ziming/laravel-domain-health-check
```

Usage
-----

[](#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](https://ohdear.app/?via=laravel-health-domain-check)

[![Laravel Health Screenshot](https://private-user-images.githubusercontent.com/679513/517117664-2b53d8a4-43b9-426c-9126-b1951f90df97.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI2OTAyMjgsIm5iZiI6MTc4MjY4OTkyOCwicGF0aCI6Ii82Nzk1MTMvNTE3MTE3NjY0LTJiNTNkOGE0LTQzYjktNDI2Yy05MTI2LWIxOTUxZjkwZGY5Ny5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNjI4JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDYyOFQyMzM4NDhaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT0yYTY3NDljOTgwMTRlMDI4OTVlMmZhMDZkYTE3NTc4ZWMyNTBlNTBhZWM4NjllNTZkNTRlZWJhNjY4MzA2NTc4JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZyZXNwb25zZS1jb250ZW50LXR5cGU9aW1hZ2UlMkZwbmcifQ.cSe-Ytkone0JfgRVdlAyldiIY7Btg7Cx3MSt-qeKSSo)](https://private-user-images.githubusercontent.com/679513/517117664-2b53d8a4-43b9-426c-9126-b1951f90df97.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI2OTAyMjgsIm5iZiI6MTc4MjY4OTkyOCwicGF0aCI6Ii82Nzk1MTMvNTE3MTE3NjY0LTJiNTNkOGE0LTQzYjktNDI2Yy05MTI2LWIxOTUxZjkwZGY5Ny5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNjI4JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDYyOFQyMzM4NDhaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT0yYTY3NDljOTgwMTRlMDI4OTVlMmZhMDZkYTE3NTc4ZWMyNTBlNTBhZWM4NjllNTZkNTRlZWJhNjY4MzA2NTc4JlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZyZXNwb25zZS1jb250ZW50LXR5cGU9aW1hZ2UlMkZwbmcifQ.cSe-Ytkone0JfgRVdlAyldiIY7Btg7Cx3MSt-qeKSSo)[![Oh Dear Screenshot](https://private-user-images.githubusercontent.com/679513/517117536-c73cdafb-076c-433d-baef-5bc92bde14af.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI2OTAyMjgsIm5iZiI6MTc4MjY4OTkyOCwicGF0aCI6Ii82Nzk1MTMvNTE3MTE3NTM2LWM3M2NkYWZiLTA3NmMtNDMzZC1iYWVmLTViYzkyYmRlMTRhZi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNjI4JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDYyOFQyMzM4NDhaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1lOWFmZTVlMDE3MTJkZmFiMmU5NGE1MWYwNWYyZGJmNDg5MjA4MDQwOGJkMmJhZjY4NTJhYjEzNGUxNTk3NGQzJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZyZXNwb25zZS1jb250ZW50LXR5cGU9aW1hZ2UlMkZwbmcifQ.NcsRiWe-4_dsC4RXco0Ceo0OSTQxPdXqFuqDLOAJBPQ)](https://private-user-images.githubusercontent.com/679513/517117536-c73cdafb-076c-433d-baef-5bc92bde14af.png?jwt=eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJpc3MiOiJnaXRodWIuY29tIiwiYXVkIjoicmF3LmdpdGh1YnVzZXJjb250ZW50LmNvbSIsImtleSI6ImtleTUiLCJleHAiOjE3ODI2OTAyMjgsIm5iZiI6MTc4MjY4OTkyOCwicGF0aCI6Ii82Nzk1MTMvNTE3MTE3NTM2LWM3M2NkYWZiLTA3NmMtNDMzZC1iYWVmLTViYzkyYmRlMTRhZi5wbmc_WC1BbXotQWxnb3JpdGhtPUFXUzQtSE1BQy1TSEEyNTYmWC1BbXotQ3JlZGVudGlhbD1BS0lBVkNPRFlMU0E1M1BRSzRaQSUyRjIwMjYwNjI4JTJGdXMtZWFzdC0xJTJGczMlMkZhd3M0X3JlcXVlc3QmWC1BbXotRGF0ZT0yMDI2MDYyOFQyMzM4NDhaJlgtQW16LUV4cGlyZXM9MzAwJlgtQW16LVNpZ25hdHVyZT1lOWFmZTVlMDE3MTJkZmFiMmU5NGE1MWYwNWYyZGJmNDg5MjA4MDQwOGJkMmJhZjY4NTJhYjEzNGUxNTk3NGQzJlgtQW16LVNpZ25lZEhlYWRlcnM9aG9zdCZyZXNwb25zZS1jb250ZW50LXR5cGU9aW1hZ2UlMkZwbmcifQ.NcsRiWe-4_dsC4RXco0Ceo0OSTQxPdXqFuqDLOAJBPQ)Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently.

Contributing
------------

[](#contributing)

Please see [CONTRIBUTING](CONTRIBUTING.md) for details.

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [ziming](https://github.com/ziming)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

47

—

FairBetter than 93% of packages

Maintenance90

Actively maintained with recent releases

Popularity25

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity53

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 76.5% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~39 days

Total

4

Last Release

109d ago

Major Versions

0.1 → 1.02025-11-20

### Community

Maintainers

![](https://www.gravatar.com/avatar/20bbe714df709bd31994360fbba65adce9f28fd930c5590265d4d58c452fe32e?d=identicon)[ziming.opensource](/maintainers/ziming.opensource)

---

Top Contributors

[![ziming](https://avatars.githubusercontent.com/u/679513?v=4)](https://github.com/ziming "ziming (26 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (5 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (2 commits)")[![Copilot](https://avatars.githubusercontent.com/in/1143301?v=4)](https://github.com/Copilot "Copilot (1 commits)")

---

Tags

domain-lookupdomain-lookupslaravellaravel-health-checklaravel-healthchecklaravel-healthchecksoh-dearohdearrdapwhoislaravelziminglaravel-domain-health-check

###  Code Quality

TestsPest

Static AnalysisPHPStan

Code StyleLaravel Pint

### Embed Badge

![Health badge](/badges/ziming-laravel-domain-health-check/health.svg)

```
[![Health](https://phpackages.com/badges/ziming-laravel-domain-health-check/health.svg)](https://phpackages.com/packages/ziming-laravel-domain-health-check)
```

###  Alternatives

[spatie/laravel-pdf

Create PDFs in Laravel apps

1.0k4.8M47](/packages/spatie-laravel-pdf)[codewithdennis/filament-select-tree

The multi-level select field enables you to make single selections from a predefined list of options that are organized into multiple levels or depths.

329530.5k29](/packages/codewithdennis-filament-select-tree)[rawilk/profile-filament-plugin

Profile &amp; MFA starter kit for filament.

3914.6k](/packages/rawilk-profile-filament-plugin)[worksome/exchange

Check Exchange Rates for any currency in Laravel.

124603.0k](/packages/worksome-exchange)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
