larva / laravel-whois
A Laravel WHOIS query extension with domain parsing, structured results, and raw WHOIS responses.
1.3.0
2026-11-07 02:30 UTC
Requires
- php: ^8.2
- ext-json: *
- illuminate/console: ^11.0|^12.0|^13.0
- illuminate/database: ^11.0|^12.0|^13.0
- illuminate/http: ^11.0|^12.0|^13.0
- illuminate/queue: ^11.0|^12.0|^13.0
- illuminate/support: ^11.0|^12.0|^13.0
- io-developer/php-whois: ^4.1
- jeremykendall/php-domain-parser: ^6.4
- larva/support: ^2.0
Requires (Dev)
- phpunit/phpunit: ^11.5
Suggests
None
Provides
None
Conflicts
None
Replaces
None
README
基于 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。数组包含以下字段:
| 字段 | 说明 |
|---|---|
parser_type |
响应解析器类型 |
name |
域名 |
registrar |
注册商 |
owner |
所有者信息 |
whois_server |
WHOIS 服务器 |
states |
域名状态数组 |
name_servers |
DNS 服务器数组 |
dnssec |
DNSSEC 信息 |
creation_date |
注册时间,Illuminate\Support\Carbon 实例 |
expiration_date |
过期时间,Illuminate\Support\Carbon 实例 |
updated_date |
更新时间,Illuminate\Support\Carbon 实例 |
response_raw |
原始 WHOIS 响应 |
获取完整查询对象
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 服务器,需要可用的网络连接。