laravel-whois

基于 io-developer/php-whois 的 Laravel WHOIS 查询扩展，支持域名解析、结构化查询和原始响应获取。

环境需求

• PHP 8.2 或更高版本
• Laravel 11、12 或 13
• PHP JSON 扩展

安装

composer require larva/laravel-whois

扩展支持 Laravel 包自动发现，无需手动注册服务提供者或 Facade。

使用

在需要查询的类中引入 Facade：

use Larva\Whois\Whois;

结构化查询

$info = Whois::lookup('www.example.com');

查询成功时返回数组；无法获取结构化信息时返回 null。数组包含以下字段：

获取完整查询对象

use Iodev\Whois\Modules\Tld\TldInfo;

/** @var TldInfo|null $info */
$info = Whois::lookupInfo('example.com');

该方法返回 TldInfo 对象或 null，可访问解析库提供的完整字段和原始响应。

获取原始响应

$raw = Whois::lookupRaw('example.com');

解析域名

查询方法支持传入主域名、子域名或包含 URL 的字符串，并会自动提取可注册域名：

$domain = Whois::getDomain('https://www.example.com/path');
// example.com

$domain = Whois::getDomain('www.example.co.uk');
// example.co.uk

异常处理

• 域名无效时可能抛出 Larva\Whois\IllegalDomainException 或 Pdp\CannotProcessHost。
• WHOIS 服务器连接、响应或解析失败时，可能抛出 Iodev\Whois\Exceptions\WhoisException 及其子类。

查询结果取决于对应 WHOIS 服务器返回的数据，执行在线查询时请确保网络可以访问相关 WHOIS 服务。

测试

composer test

部分测试会访问真实 WHOIS 服务器，需要可用的网络连接。