larva/laravel-whois
A Laravel WHOIS query extension with domain parsing, structured results, and raw WHOIS responses.
63,120
11
| Install | |
|---|---|
composer require larva/laravel-whois |
|
| Latest Version: | 1.3.0 |
| PHP: | ^8.2 |
| Laravel: | 11 · 12 · 13 |
| Older releases: | 6 – 10 |
| License: | MIT |
| Last Updated: | Nov 7, 2026 |
| Links: | GitHub · Packagist |
Maintainer: xutongle
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。数组包含以下字段:
| 字段 | 说明 |
|---|---|
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 服务器,需要可用的网络连接。
Related Packages
Version History
| Version | Released | PHP | Laravel | License |
|---|---|---|---|---|
| 1.3.0 | ^8.2 | ^11.0| | MIT | |
| 1.2.9 | ^8.0.2 | ^9.0| | MIT | |
| 1.2.8 | ^8.0.2 | ^9.0| | MIT | |
| 1.2.7 | ^8.0.2 | ^9.0| | MIT | |
| 1.2.6 | ^8.0.2 | ^9.0| | MIT | |
| 1.2.5 | ^8.0.2 | ^9.0| | MIT | |
| 1.2.4 | ^8.0.2 | ^9.0| | MIT | |
| 1.2.3 | ^8.0.2 | ^9.0| | MIT | |
| 1.2.2 | ^8.0.2 | ^9.0| | MIT | |
| 1.2.1 | ^8.0.2 | ^9.0| | MIT | |
| 1.2.0 | ^8.0.2 | ^9.0| | MIT | |
| 1.1.2 | ^8.0.2 | ^9.0| | MIT | |
| 1.1.1 | ^8.0.2 | ^9.0 | MIT | |
| 1.1.0 | ^8.0.2 | ^9.0 | MIT | |
| 1.0.14 | ^7.2 || | ^6.0 || | MIT | |
| 1.0.13 | ^7.2 || | ^6.0 || | MIT | |
| 1.0.12 | ^7.2 || | ^6.0 || | MIT | |
| 1.0.11 | ^7.2 || | ^6.0 || | MIT | |
| 1.0.10 | ^7.2 || | ^6.0 || | MIT | |
| 1.0.9 | ^7.2 || | ^6.0 || | MIT | |
| 1.0.8 | ^7.2 || | ^6.0 || | MIT | |
| 1.0.7 | ^7.2 || | ^6.0 || | MIT | |
| 1.0.6 | ^7.2 || | ^6.0 || | MIT | |
| 1.0.5 | ^7.2 || | ^6.0 || | MIT | |
| 1.0.4 | ^7.2 || | ^6.0 || | MIT | |
| 1.0.3 | ^7.2 || | ^6.0 || | MIT | |
| 1.0.2 | ^7.2 || | ^6.0 || | MIT | |
| 1.0.1 | ^7.2 || | ^6.0 || | MIT | |
| 1.0.0 | ^7.2 || | ^6.0 || | MIT |