New

Just launched: Vueblocks, a brand-new search engine for Vue packages! Explore Vueblocks →

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

Build Status Stable Version Total Downloads License

基于 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

petk/phpwhois

Whois for PHP

134,804 7
larva/laravel-sms

This is a SMS.

3,775 0
larva/laravel-settings

This is laravel settings module.

2,791 0
larva/laravel-censor

This is a censor.

1,619 5
larva/laravel-aliyun

This is a Laravel expansion for the Aliyun.

1,423 0

Version History

Version Released PHP Laravel License
1.3.0 ^8.2 ^11.0|^12.0|^13.0 MIT
1.2.9 ^8.0.2 ^9.0|^10.0|^11.0|^12.0 MIT
1.2.8 ^8.0.2 ^9.0|^10.0|^11.0 MIT
1.2.7 ^8.0.2 ^9.0|^10.0|^11.0 MIT
1.2.6 ^8.0.2 ^9.0|^10.0|^11.0 MIT