Skip to content

Latest commit

 

History

History
673 lines (645 loc) · 15.1 KB

README.md

File metadata and controls

673 lines (645 loc) · 15.1 KB

Novutec WHOIS Parser

Lookup domain names, IP addresses and AS numbers by WHOIS.

Automatically follows the WHOIS registry referral chains until it finds the correct WHOIS for the most complete WHOIS data. Exceptionally robust WHOIS parser that parses a variety of free form WHOIS data into well-structured data that your application may read. Also returns an indication of whether a domain is available.

Copyright (c) 2007 - 2013 Novutec Inc. (http://www.novutec.com) Licensed under the Apache License, Version 2.0 (the "License").

Installation

Installing from source: git clone git://github.com/novutec/WhoisParser.git or download the latest release

See Novutec Domain Parser (http://github.com/novutec/DomainParser) or download the latest release and install it as well.

Move the source code to your preferred project folder.

Usage

  • Include Parser.php
require_once 'DomainParser/Parser.php';
require_once 'WhoisParser/Parser.php';
  • Create Parser() object
$Parser = new Novutec\WhoisParser\Parser();
  • Call lookup() method
$result = $Parser->lookup($domain);
$result = $Parser->lookup($ipv4);
$result = $Parser->lookup($ipv6);
$result = $Parser->lookup($asn);
  • Access WHOIS record, the object oriented way.
echo $result->created; // get create date of domain name
print_r($result->rawdata); // get raw output as array
  • You may choose 5 different return types. the types are array, object, json, serialize and xml. By default it is object. If you want to change that call the format method before calling the parse method or provide to the constructer.
$Parser->setFormat('json');
$Parser = new Novutec\WhoisParser\Parser('json');
$Parser->setDateFormat('%d.%m.%Y %H:%M:%S');
  • If you have special WHOIS server or login credentials for a registrar WHOIS you may use the method setSpecialWhois(). Please note that if you have a special WHOIS and the WHOIS output looks different you need your own template.
$Parser->setSpecialWhois(array('it' => array('server' => 'whois.nic.it', 'port' => 43,
'format' => '-u username -w passsword %domain%', 'template' => 'it-your-own-template')));

ToDos

  • Caching of data for better performance and to reduce requests
  • Change HTTP Adapter to use GET/POST
  • Change Socket Adapter to be able to use Socks to split requests.

Known bugs to be fixed in further versions

  • [Template] gTLD cps-datensysteme - need caching for testing, because after 5 requests you get blocked
  • [Template] .BJ - recursive lookup for handles

Tested with following RIRs and TLDs

RIRs

[x] Afrinic
[x] Apnic
[x] Arin
[x] Krnic
[x] Lacnic
[x] Ripe

ccTLDs (http://data.iana.org/TLD/tlds-alpha-by-domain.txt)

[x] AC
[x] AC.UK
[ ] AD
[x] AE
[x] AERO
[x] AF
[x] AG
[x] AI
[ ] AL
[x] AM
[ ] AN
[ ] AO
[ ] AQ
[ ] AR - webbased
[x] ARPA
[x] AS
[x] ASIA
[x] AT
[x] AU
[ ] AW
[x] AX
[ ] AZ - webbased
[ ] BA - webbased
[ ] BB - webbased with captcha
[ ] BD
[x] BE
[ ] BF
[x] BG
[ ] BH
[x] BI
[x] BIZ
[ ] BJ - need recursive calls for handles
[ ] BM - webbased
[ ] BN
[x] BO
[x] BR
[ ] BS - webbased
[ ] BT
[ ] BV - no domains but it is NORID
[ ] BW
[x] BY
[x] BZ
[x] CA
[x] CAPETOWN
[x] CAT
[x] CC
[x] CD
[ ] CF
[ ] CG - webbased with captcha
[x] CH
[x] CI
[x] CK
[x] CL
[x] CM
[x] CN
[x] CO
[x] CO.ZA
[x] COM
[x] COOP
[ ] CR - webbased (https://www.nic.cr/es/whois?language=en)
[x] CU - webbased
[ ] CV
[ ] CW
[x] CX
[ ] CY
[x] CZ
[x] DE
[x] DE Registrar WHOIS
[ ] DJ
[x] DK
[x] DM
[ ] DO - whois.nic.do is broken
[x] DURBAN
[x] DZ
[x] EC
[x] EDU
[x] EE
[ ] EG
[ ] ER
[x] ES
[ ] ET
[x] EU
[x] FI
[x] FJ
[ ] FK
[x] FM
[x] FO
[x] FR
[ ] GA
[ ] GB
[x] GD
[ ] GE
[ ] GF
[x] GG
[ ] GH
[x] GI
[X] GL
[ ] GM
[ ] GN
[ ] GOV - to few domain names
[x] GOV.ZA
[ ] GP
[ ] GQ
[ ] GR - webbased with captcha
[x] GS
[ ] GT  - webbased
[ ] GU
[ ] GW
[x] GY
[x] HK
[x] HM
[x] HN
[ ] HR - possible
[x] HT
[ ] HU - webbased with captcha
[x] ID
[x] IE
[X] IL
[x] IM
[x] IN
[x] INFO
[x] INT
[x] IO
[x] IQ
[X] IR
[X] IS
[x] IT
[x] IT Registrar WHOIS
[x] JE
[ ] JM
[ ] JO - Web based (http://www.dns.jo/Whois.aspx)
[x] JOBS
[x] JOBURG
[x] JP
[x] KE
[x] KG
[ ] KH
[x] KI
[ ] KM
[ ] KN
[ ] KP
[x] KR
[ ] KW
[ ] KY
[x] KZ
[x] LA
[ ] LB
[x] LC
[x] LI
[ ] LK (whois.nic.lk)
[ ] LR
[ ] LS
[x] LT
[x] LU
[x] LV
[x] LY
[ ] MA - possible
[ ] MC
[x] MD
[x] ME
[x] MG
[ ] MH
[ ] MIL - useless
[ ] MK
[ ] ML
[ ] MM
[x] MN
[ ] MO - near useless, better whois webbased but with captcha
[x] MOBI
[ ] MP - whois on port 43 broken
[ ] MQ
[ ] MR
[x] MS
[ ] MT (whois.nic.org.mt) with captcha
[x] MU
[x] MUSEUM
[ ] MV
[ ] MW
[x] MX
[x] MY
[ ] MZ
[x] NA
[x] NAME
[x] NAME Registrar WHOIS
[x] NC
[ ] NE
[x] NET
[x] NET.ZA
[x] NF
[x] NG
[ ] NI
[x] NL
[x] NL Registrar WHOIS
[x] NO
[ ] NP
[ ] NR
[x] NU
[x] NZ
[x] OM
[x] ORG
[x] ORG.ZA
[ ] PA
[x] PE
[ ] PF
[ ] PG
[ ] PH - webbased with captcha (http://www.dot.ph/whois)
[ ] PK - webbased
[x] PL
[x] PM
[ ] PN
[x] PR
[x] PRO
[x] PS
[x] PT
[x] PW
[ ] PY
[x] QA
[x] RE
[x] RO
[x] RS
[x] RU
[ ] RW
[ ] SA - possible
[x] SB
[x] SC
[ ] SD
[x] SE
[x] SG
[x] SH
[x] SI
[ ] SJ - no domains but it is NORID
[x] SK
[x] SKY
[ ] SL
[x] SM
[x] SN
[x] SO
[ ] SR
[x] ST
[x] SU
[ ] SV
[x] SX
[x] SY
[ ] SZ
[x] TC
[ ] TD
[x] TEL
[x] TF
[ ] TG
[x] TH
[ ] TJ
[x] TK
[x] TL
[x] TM
[x] TN
[x] TO  (Note: Fairly useless - only allows us to see nameservers and registered status)
[ ] TP
[x] TR
[x] TRAVEL
[ ] TT - webbased
[x] TV
[x] TW
[x] TZ
[x] UA
[x] UG
[x] UK
[x] US
[x] UY
[ ] UZ - possible
[ ] VA
[x] VC
[x] VE
[x] VG
[ ] VI
[ ] VN
[x] VU
[x] WEB.ZA
[x] WF
[x] WS
[x] XN--3E0B707E - .kr
[x] XN--45BRJ9C - .in
[x] XN--80AO21A - .kz
[x] XN--90A3AC - .rs
[ ] XN--CLCHC0EA0B2G2A9GCD - possible .sg
[x] XN--FIQS8S - .cn
[x] XN--FIQZ9S - .cn
[x] XN--FPCRJ9C3D - .in
[ ] XN--FZC2C9E2C - .lk
[x] XN--GECRJ9C - .in
[x] XN--H2BRJ9C - .in
[ ] XN--HGBK6AJ7F53BBA
[ ] XN--HLCJ6AYA9ESC7A
[x] XN--J6W193G - .hk
[x] XN--KPRW13D - .tw
[x] XN--KPRY57D - .tw
[x] XN--LGBBAT1AD8J - .dz
[x] XN--MGBAAM7A8H - .ae
[ ] XN--MGBAYH7GPA - .jo
[x] XN--MGBBH1A71E - .in
[ ] XN--MGBC0A9AZCG - .ma
[ ] XN--MGBERP4A5D4AR - possible .sa
[x] XN--O3CW4H - .th
[x] XN--OGBPF8FL - .sy
[ ] XN--P1AI - possible .ru
[ ] XN--PGBS0DH - .tn
[x] XN--S9BRJ9C - .in
[ ] XN--WGBH1C - .eg
[x] XN--WGBL6A - .qa
[ ] XN--XKC2AL3HYE2A -.lk
[x] XN--XKC2DL3A5EE0H - .in
[x] XN--YFRO4I67O - .sg
[x] XN--YGBI2AMMX - .ps
[x] XXX
[ ] YE
[x] YT
[ ] ZM
[ ] ZW

Special TLDs

[x] CentralNic (https://www.centralnic.com/names/domains)
[x] CO.NL
[x] CO.NO
[x] COM.CC
[x] ORG.CC
[x] EDU.CC
[x] NET.CC

gTLDs and thin registries sort by IANA ID (http://www.iana.org/assignments/registrar-ids/registrar-ids.xml)

[x] 2 (Network Solutions, LLC)
[x] 9 (Register.com, Inc.)
[x] 13 (Melbourne IT, Ltd)
[x] 14 (ORANGE)
[x] 15 (Corehub, S.R.L.)
[x] 30 (NameSecure LLC)
[x] 48 (eNom, Inc.)
[x] 49 (GMO Internet, Inc. d/b/a Onamae.com)
[x] 52 (Hostopia.com Inc. d/b/a Aplus.net)
[x] 65 (DomainPeople, Inc.)
[x] 66 (Enameco, LLC)
[x] 69 (Tucows Domains Inc.)
[x] 73 (DOMAININFO AB D/B/A DOMAININFO.COM)
[x] 74 (ONLINE SAS)
[x] 76 (NOMINALIA INTERNET S.L.)
[x] 79 (Easyspace Limited)
[x] 81 (Gandi SAS)
[x] 82 (OnlineNIC, Inc.)
[x] 83 (1&1 Internet AG)
[x] 85 (EPAG Domainservices GmbH)
[x] 86 (TierraNet Inc. d/b/a DomainDiscover)
[x] 87 (HANGANG Systems, Inc. d/b/a doregi.com)
[x] 88 (Namebay SAM)
[x] 91 (007Names, Inc.)
[x] 93 (GKG.NET, INC.)
[x] 99 (pairNIC INC)
[x] 104 (Domainsite.com, Inc)
[x] 106 (Ascio Technologies, Inc. - Denmark)
[x] 113 (CSL Computer Service Langenbach GmbH d/b/a joker.com)
[ ] 120 (Xin Net Technology Corporation)
[x] 123 (The Registry at Info Avenue, LLC d/b/a Spirit Communications)
[x] 128 (DOMAINREGISTRY.COM, INC.)
[x] 130 (Netpia.com, Inc.)
[x] 131 (Total Web Solutions Limited trading as TotalRegistrations)
[x] 134 (BB ONLINE UK LTD)
[x] 140 (Acens Technologies, S.L.U.)
[x] 141 (Cronon AG)
[x] 146 (GoDaddy.com, LLC)
[x] 151 (PSI-USA, Inc. dba Domain Robot)
[x] 168 (Register.it SPA)
[x] 226 (Deutsche Telekom AG)
[x] 228 (Moniker Online Services LLC)
[x] 240 (PlanetDomain Pty Ltd)
[x] 244 (Gabia, Inc.)
[x] 245 (123 Registration, Inc.)
[x] 249 (Visesh Infotecnics Ltd. D/B/A Signdomains.Com)
[x] 269 (Key-Systems GmbH)
[x] 291 (DNC Holdings, Inc.)
[x] 292 (MarkMonitor Inc.)
[x] 303 (PDR Ltd. d/b/a PublicDomainRegistry.com)
[x] 320 (TLDS L.L.C. d/b/a SRSPlus)
[x] 363 (Funpeas Media Ventures, LLC dba DomainProcessor.com)
[x] 378 (2030138 Ontario Inc. dba NamesBeyond.com and dba GoodLuckDomain.com)
[x] 379 (Arsys Internet, S.L. dba NICLINE.COM)
[x] 380 (Tuonome.it Srl d/b/a APIsrs.com)
[x] 381 (DomReg Ltd. d/b/a LIBRIS.COM)
[x] 401 (Misk.com, Inc.)
[x] 411 (Fabulous.com Pty Ltd.)
[x] 412 (DOMAIN-IT, INC.)
[x] 418 (CommuniGal Communication Ltd.)
[x] 420 (HiChina Zhicheng Technology Limited)
[x] 424 (Internetters Limited)
[x] 430 (Net Searchers International Ltd.)
[x] 431 (DreamHost, LLC)
[x] 433 (OVH sas)
[x] 440 (Wild West Domains, LLC)
[x] 444 (Inames Co. Ltd.)
[x] 447 (SafeNames Ltd.)
[x] 449 (Korea Information Certificate Authority, Inc. dba DomainCA.com)
[x] 450 (DOMAINNAME, INC)
[x] 455 (EnCirca, Inc.)
[x] 460 (WEB COMMERCE COMMUNICATIONS LIMITED DBA WEBNIC.CC)
[x] 463 (REGIONAL NETWORK INFORMATION CENTER, JSC DBA RU-CENTER)
[x] 469 (easyDNS Technologies, Inc.)
[x] 470 (NOM-IQ Ltd dba Com Laude)
[x] 471 (Bizcn.com, Inc.)
[x] 472 (Dynadot, LLC)
[x] 600 (Rebel.com)
[x] 602 (LCN.com Ltd)
[x] 604 (In2net Network Inc.)
[x] 607 (ANNULET LLC)
[x] 609 (NameKing.com Inc.)
[x] 612 (Blue Razor Domains, LLC)
[x] 618 (ENETICA PTY LTD)
[x] 625 (Name.com LLC)
[x] 634 (NetTuner Corp. dba Webmasters.com)
[x] 636 (BRANDON GRAY INTERNET SERVICES, INC. DBA NAMEJUICE.COM)
[x] 642 (LADAS DOMAINS LLC)
[x] 648 (Webagentur.at Internet Services GmbH d/b/a domainname.at)
[x] 670 ($$$ Private Label Internet Service Kiosk, Inc. dba "PLISK.com")
[x] 677 (NETREGISTRY PTY. LTD.)
[x] 687 (GONAME-WA.COM, INC.)
[x] 696 (Entorno Digital, S.A.)
[x] 710 (! ! ! $0 Cost Domain and Hosting Services, Inc.)
[x] 771 (NAMEPAL.COM #8026.)
[x] 814 (Internet.bs Corp.)
[x] 828 (Hetzner Online AG)
[x] 837 (FREEPARKING DOMAIN REGISTRARS, INC)
[x] 839 (REALTIME REGISTER B.V.)
[x] 841 (TIGER TECHNOLOGIES LLC)
[x] 886 (Domain.com, LLC)
[x] 888 (Pheenix, Inc.)
[x] 889 (DOMAINCLIP DOMAINS, INC)
[x] 900 (TPP WHOLESALE PTY LTD.)
[x] 913 (PocketDomain.com Inc.)
[x] 925 (Everyones Internet, LLC dba SoftLayer)
[x] 931 (UdomainName.com LLC)
[x] 940 (Above.com Pty Ltd.)
[x] 944 (IServeYourDomain.com LLC)
[x] 946 (FindYouADomain.com LLC)
[x] 947 (FINDYOUANAME.COM LLC)
[x] 955 (Launchpad, Inc.)
[x] 987 (Imperial Registrations, Inc.)
[x] 996 (DomainAdministration.com, LLC)
[x] 1001 (Domeneshop AS dba domainnameshop.com)
[x] 1003 (EKADOS, INC. D/B/A GROUNDREGISTRY.COM)
[x] 1005 (NetEarth One, Inc.)
[x] 1007 (NET 4 INDIA LIMITED)
[x] 1011 (101domain, inc.)
[x] 1019 (Threadagent.com, Inc.)
[x] 1040 (Dynamic Network Services, Inc.)
[x] 1052 (EuroDNS S.A.)
[x] 1068 (NAMECHEAP INC)
[x] 1076 (Domain Guardians, Inc.)
[x] 1090 (Active Registrar, Inc)
[x] 1111 (DomainContext, Inc.)
[x] 1114 (MEDIA ELITE HOLDINGS LIMITED)
[x] 1149 (Go China Domains, LLC)
[x] 1150 (Go Canada Domains, LLC)
[x] 1151 (Go Australia Domains, LLC)
[x] 1153 (GO FRANCE DOMAINS, LLC)
[x] 1154 (FastDomain Inc.)
[x] 1159 (Allearthdomains.com LLC)
[x] 1163 (BELMONTDOMAINS.COM LLC)
[x] 1165 (Biglizarddomains.com LLC)
[x] 1169 (Columbianames.com LLC)
[x] 1173 (Domainarmada.com LLC)
[x] 1176 (Domaincomesaround.com LLC)
[x] 1181 (Domaininthehole.com LLC)
[x] 1192 (Domainsoftheworld.net LLC)
[x] 1200 (Domaintimemachine.com LLC)
[x] 1201 (Domainyeti.com LLC)
[x] 1204 (EunamesOregon.com LLC)
[x] 1207 (EUTurbo.com LLC)
[x] 1208 (Flancrestdomains.com LLC)
[x] 1209 (Freshbreweddomains.com LLC)
[x] 1211 (Godomaingo.com LLC)
[x] 1215 (Imminentdomains.net LLC)
[x] 1220 (Nameemperor.com LLC)
[x] 1231 (Protondomains.com LLC)
[x] 1232 (Skykomishdomains.com LLC)
[x] 1239 (CPS-Datensysteme GmbH)
[x] 1250 (TRUNKOZ TECHNOLOGIES PVT LTD. D/B/A OWNREGISTRAR.COM)
[x] 1256 (INSTANTNAMES LLC)
[x] 1257 (Variomedia AG dba puredomain.com)
[x] 1290 (Mailclub SAS)
[x] 1291 (CRAZY DOMAINS FZ-LLC)
[x] 1316 (35 Technology Co., Ltd.)
[x] 1327 (VITALWERKS INTERNET SOLUTIONS LLC DBA NO-IP)
[x] 1328 (RegistryGate GmbH)
[x] 1331 (eName Technology Co., Ltd.)
[x] 1336 (Net-Chinese Co., Ltd.)
[x] 1341 (HAWTHORNEDOMAINS.COM LLC)
[x] 1344 (NAMEPANTHER.COM LLC)
[x] 1355 (Snappyregistrar.com LLC)
[x] 1369 (DISCOUNT DOMAINS LTD)
[x] 1371 (AB NAME ISP)
[x] 1376 (Instra Corporation Pty Ltd.)
[x] 1383 (Soluciones Corporativas IP, SLU)
[x] 1387 (1API GmbH)
[x] 1390 (Mesh Digital Limited)
[x] 1404 (WEB SITE SOURCE, INC)
[x] 1408 (united-domains AG)
[x] 1420 (InterNetworX Ltd. & Co. KG)
[x] 1429 (HEBEI GUOJI MAOYI (SHANGHAI) LTD DBA HEBEIDOMAINS.COM)
[x] 1441 (TurnCommerce, Inc. DBA NameBright.com)
[x] 1443 (Vautron Rechenzentrum AG)
[x] 1448 (Blacknight Internet Solutions Ltd.)
[x] 1449 (URL Solutions Inc.)
[x] 1454 (Nics Telekomünikasyon Ticaret Ltd. Şti.)
[x] 1463 (GLOBAL DOMAINS INTERNATIONAL, INC.)
[x] 1466 (LEXSYNERGY LIMITED)
[x] 1467 (REGISTER NV DBA REGISTER.EU)
[x] 1471 (Astutium Limited)
[x] 1472 (LIQUIDNET Ltd.)
[x] 1475 (April Sea Information Technology Corporation)
[x] 1479 (Namesilo, LLC)
[x] 1485 (JAPAN REGISTRY SERVICES CO., LTD.)
[x] 1488 (DEMYS LIMITED)
[x] 1489 (Megazone Corp., dba HOSTING.KR)
[x] 1500 (Tirupati Domains And Hosting Pvt. Ltd.)
[x] 1505 (Gransy s.r.o. d/b/a subreg.cz)
[x] 1536 (BoteroSolutions.com S.A.)
[x] 1540 (Domainwards.com LLC)
[x] 1544 (Name114, Inc.)
[x] 1555 (HANGZHOU AIMING NETWORK CO.,LTD)
[x] 1556 (Chengdu West Dimension Digital Technology Co., Ltd)
[x] 1562 (Hogan Lovells International LLP)
[x] 1564 (TLD Registrar Solutions Ltd.)
[x] 1572 (GlamDomains LLC)
[x] 1575 (ZOOMREGISTRAR LLC)
[x] 1579 (ProNamed LLC)
[x] 1581 (BINERO AB)
[x] 1587 (MIJN INTERNETOPLOSSING B.V.)
[x] 1590 (CHINANET TECHNOLOGY (SUZHOU) CO., LTD)
[x] 1606 (Registrar of domain names REG.RU LLC)
[x] 1616 (NAMETURN LLC)
[x] 1617 (PresidentialDomains LLC)
[x] 1659 (Uniregistrar Corp)
[x] 1677 (ACQUIREDNAMES LLC)
[x] 1685 (EchoDomain LLC)
[x] 1860 (Paragon Internet Group Ltd)
[x] 1864 (DYNADOT9 LLC)
[x] Novutec Inc.

3rd Party Libraries

We are using our own Domain Parser:

ChangeLog

See ChangeLog at https://github.com/novutec/WhoisParser/blob/master/CHANGELOG.md

Issues

Please report any issues via https://github.com/novutec/WhoisParser/issues

LICENSE and COPYRIGHT

Copyright (c) 2007 - 2013 Novutec Inc. (http://www.novutec.com)

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

http://www.apache.org/licenses/LICENSE-2.0

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.