A simple to use whois client for PHP

1.0.0 2023-01-22 02:03 UTC

This package is auto-updated.

Last update: 2024-07-23 02:09:28 UTC


Source Code License PHP Version Latest Stable Version Total Download Count


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


  • PHP >= 8.0


The best installation method is to simply use composer.

Stable version

composer require mallardduck/whodis

Example Usage

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

use MallardDuck\Whodis\Whodis;

$whodis = new Whodis();
$response = $whodis->lookup('', fullResults: true);
echo $response; // Prints WHOIS results identical to running `whois` in shell*.
  • = Varies based on CLI whois client, docs assume your client matches BSD whois which provides recursive results by default.


$ 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

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


Please see our contributing guide.


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


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