PHPackages                             mallardduck/whodis - 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 & Helpers](/categories/utility)
4. /
5. mallardduck/whodis

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

mallardduck/whodis
==================

A simple to use whois client for PHP

1.0.0(3y ago)15081MITPHPPHP ^8.0

Since Jan 22Pushed 3y ago2 watchersCompare

[ Source](https://github.com/mallardduck/whodis)[ Packagist](https://packagist.org/packages/mallardduck/whodis)[ Docs](https://github.com/mallardduck)[ RSS](/packages/mallardduck-whodis/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (13)Versions (3)Used By (0)

Whodis - Easy to use Whois client for PHP
=========================================

[](#whodis---easy-to-use-whois-client-for-php)

[![Source Code](https://camo.githubusercontent.com/45de220d170ada68ca8b07655048543f31077a5a189301425eb66a48bf530edf/68747470733a2f2f696d672e736869656c64732e696f2f7374617469632f76313f6c6162656c3d736f75726365266d6573736167653d6d616c6c6172646475636b2f77686f64697326636f6c6f723d626c7565267374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/mallardduck/whodis)[![License](https://camo.githubusercontent.com/c4940171899c67bd61d516d88ebecd8615e5c6bd96e39995ddd5807fe5b4eab5/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f6c2f6d616c6c6172646475636b2f77686f6469733f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/mallardduck/whodis)[![PHP Version](https://camo.githubusercontent.com/e962cda24c40447adb83113e503ab02d9189ef0f8015db1132cfc3e777e6f074/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6d616c6c6172646475636b2f77686f6469732e7376673f7374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/mallardduck/whodis)[![Latest Stable Version](https://camo.githubusercontent.com/3e7d5fe7fd45f8d13a7dc4840d61f22b5d8611b63e026d2686705a9dce2866b6/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6d616c6c6172646475636b2f77686f6469733f6c6f676f3d7061636b6167697374266c6162656c3d52656c65617365267374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/mallardduck/whodis)[![Total Download Count](https://camo.githubusercontent.com/f214d56c8a792b613e68a74151a07a9464b8ad840b2c6576cde2cf811b6204a3/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6d616c6c6172646475636b2f77686f6469733f6c6f676f3d7061636b6167697374267374796c653d666f722d7468652d6261646765)](https://packagist.org/packages/mallardduck/whodis/stats)

Purpose
-------

[](#purpose)

A simple to use high-level Whois client for PHP.

Requirements
------------

[](#requirements)

- PHP >= 8.0

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

[](#installation)

The best installation method is to simply use composer.

### Stable version

[](#stable-version)

```
composer require mallardduck/whodis
```

Example Usage
-------------

[](#example-usage)

```
require __DIR__ . '/vendor/autoload.php';

use MallardDuck\Whodis\Whodis;

$whodis = new Whodis();
$response = $whodis->lookup('danpock.me', fullResults: true);
echo $response; // Prints WHOIS results identical to running `whois danpock.me` in shell*.
```

> - = Varies based on CLI `whois` client, docs assume your client matches BSD `whois` which provides recursive results by default.

Testing
-------

[](#testing)

```
$ composer test
```

> Note: Due to how fast PHP tests run false-negatives can spawn. Whois servers may disconnect during a test resulting in empty response and failing tests.

TODO Before V2
--------------

[](#todo-before-v2)

- Add result parsing features,
- Refactor lookup output to provide POPO of info,
- Allow output as plain text, or POPOs; maybe different methods?

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

[](#contributing)

Please see our [contributing guide](http://docs.php-http.org/en/latest/development/contributing.html).

Security
--------

[](#security)

If you discover any security related issues, please contact us at .

License
-------

[](#license)

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

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity51

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

1211d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/801be8ba9bfb0cb2629f51f9753a0392683c2680fe3e941a188495840d920333?d=identicon)[MallardDuck](/maintainers/MallardDuck)

---

Top Contributors

[![mallardduck](https://avatars.githubusercontent.com/u/619938?v=4)](https://github.com/mallardduck "mallardduck (20 commits)")

---

Tags

phpwhoiswhois-clientdomainwhoislookupwhois-clientwhodis

###  Code Quality

TestsPest

Static AnalysisPHPStan, Psalm

Code StylePHP\_CodeSniffer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/mallardduck-whodis/health.svg)

```
[![Health](https://phpackages.com/badges/mallardduck-whodis/health.svg)](https://phpackages.com/packages/mallardduck-whodis)
```

###  Alternatives

[io-developer/php-whois

PHP WHOIS provides parsed and raw whois lookup of domains and ASN routes. PHP 5.4+ and 7+ compatible

4922.4M8](/packages/io-developer-php-whois)[mallardduck/whois-client

A very basic Whois client for PHP. The library is limited in function since it's intended to be a low-level client that handles only request and raw output.

162.0k3](/packages/mallardduck-whois-client)[helgesverre/domain-availability

A PHP library for checking if a domain name is registered or not

26618.4k1](/packages/helgesverre-domain-availability)[novutec/whoisparser

Lookup domain names, IP addresses and AS numbers by WHOIS.

392.0M1](/packages/novutec-whoisparser)[cocur/domain

Check domain name availability and WHOIS

701.3k](/packages/cocur-domain)[larva/laravel-whois

Whois Query Extension for Laravel.

1135.2k](/packages/larva-laravel-whois)

PHPackages © 2026

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