utopia-php / domains

Lite & fast micro PHP domain parsing library that is **easy to use**.

Utopia Domains

Utopia Domains library is a simple and lite library for parsing domain names structure. This library is aiming to be as simple and easy to learn and use. This library is maintained by the Appwrite team.

Although this library is part of the Utopia Framework project, it is completely dependency-free and can be used as standalone with any other PHP project or framework.

Getting Started

Install using composer:

composer require utopia-php/domains

<?php

require_once '../vendor/autoload.php';

use Utopia\Domains\Domain;

// demo.example.co.uk

$domain = new Domain('demo.example.co.uk');

$domain->get(); // demo.example.co.uk
$domain->getTLD(); // uk
$domain->getSuffix(); // co.uk
$domain->getRegisterable(); // example.co.uk
$domain->getName(); // example
$domain->getSub(); // demo
$domain->isKnown(); // true
$domain->isICANN(); // true
$domain->isPrivate(); // false
$domain->isTest(); // false

// demo.localhost

$domain = new Domain('demo.localhost');

$domain->get(); // demo.localhost
$domain->getTLD(); // localhost
$domain->getSuffix(); // ''
$domain->getRegisterable(); // ''
$domain->getName(); // demo
$domain->getSub(); // ''
$domain->isKnown(); // false
$domain->isICANN(); // false
$domain->isPrivate(); // false
$domain->isTest(); // true

Utopia Domains parser uses a public suffix PHP dataset auto-generated from the publicsuffix.org. The dataset get periodically updates from us, but you can also manually update it by cloning this library and running the import script with the import command:

php ./data/import.php

Library API

• get() - Return you full domain name.
• getTLD() - Return only the top-level-domain.
• getSuffix() - Return only the public suffix of your domain, for example: co.uk, ac.be, org.il, com, org.
• getRegisterable() - Return the registered or registrable domain, which is the public suffix plus one additional label.
• getName() - Returns only the registerable domain name. For example, blog.example.com will return 'example', and demo.co.uk will return 'demo'.
• getSub() - Returns the full sub domain path for you domain. For example, blog.example.com will return 'blog', and subdomain.demo.co.uk will return 'subdomain.demo'.
• isKnown() - Returns true if public suffix is know and false otherwise.
• isICANN() - Returns true if the public suffix is found in the ICANN DOMAINS section of the public suffix list.
• isPrivate() - Returns true if the public suffix is found in the PRIVATE DOMAINS section of the public suffix list.
• isTest() - Returns true if the domain TLD is 'locahost' or 'test' and false otherwise.

If you want to parse ordinary web urls then use $host = parse_url($return, PHP_URL_HOST); $domain = new Utopia\Domains\Domain($host); to get the domain object.

Using the Registrar API

<?php

use Utopia\Domains\Registrar;
use Utopia\Domains\Contact;
use Utopia\Domains\Registrar\OpenSRS;

$opensrs = new OpenSRS(
  'apikey', 
  'apisecret', 
  'username', 
  'password', 
  [
    'ns1.nameserver.com',
    'ns2.nameserver.com',
  ]
);


$reg = new Registrar($opensrs);

$contact = new Contact(
  'firstname',
  'lastname',
  'phone',
  'email',
  'address1',
  'address2',
  'address3',
  'city',
  'state',
  'country',
  'postalcode',
  'org',
  'owner',
);

$domain = 'yourname.com';

$available = $reg->available($domain);
$purchase = $reg->purchase($domain, $contact); 
$suggest = $reg->suggest(['yourname', 'yourname1.com'], ['com', 'net', 'org']);
$domainDetails = $reg->getDomain($domain);
$renew = $reg->renew($domain, 1);
$transfer = $reg->transfer($domain, [$contact]);

Library Registrar API

• available(string $domain): bool - Checks to see if a domain is available for registration.
• purchase(string $domain, array $contacts, array $nameservers = []): array - Purchase a domain name.
• suggest(array $query, array $tlds = [], $minLength = 1, $maxLength = 100): array - Suggest or search for domain names.
• getDomain(string $domain): array - Get domain details.
• renew(string $domain, int $years): array - Renew a domain name.
• transfer(string $domain, array $contacts, array $nameservers = []): array - Transfer a domain name.

System Requirements

Utopia Framework requires PHP 8.0 or later. We recommend using the latest PHP version whenever possible.

Authors

Eldad Fux

• https://twitter.com/eldadfux
• https://github.com/eldadfux

Copyright and license

The MIT License (MIT) http://www.opensource.org/licenses/mit-license.php

domains's Issues

🐛 Bug Report: getRegisterable() did no validation format

👟 Reproduction steps

    $domain_check = new Domain($data['domain']);
    var_dump($domain_check->get());
    var_dump($domain_check->getTLD());
    var_dump($domain_check->getSuffix());
    var_dump($domain_check->getRegisterable());
    var_dump($domain_check->getName());
    var_dump($domain_check->getSub());
    var_dump($domain_check->isKnown());
    var_dump($domain_check->isICANN());
    var_dump($domain_check->isPrivate());
    var_dump($domain_check->isTest());die();

string(16) "www.test-8__.com"
string(3) "com"
string(3) "com"
string(12) "test-8__.com"
string(8) "test-8__"
string(3) "www"
bool(true)
bool(true)
bool(false)
bool(false)

👍 Expected behavior

test-8__.com is not valid for Register
I think should add $domain_check->isRootDomain() to check if is a valid domain with Registerable

👎 Actual Behavior

1

🎲 Utopia Domain version

Version 0.2.x

💻 Operating system

Linux

🐘 PHP Version

PHP 8.0

🧱 Your Environment

No response

👀 Have you spent some time to check if this issue has been raised before?

• I checked and didn't find similar issue

🏢 Have you read the Code of Conduct?

• I have read the Code of Conduct

getRegisterable() doesn't always return the registerable domain only

Steps to reproduce

$domain = new Domain('http://facebook.com');
$domain2 = new Domain('http://www.facebook.com');

$domain->getRegisterable()); // 'http://facebook.com'
$domain2->getRegisterable()); // 'facebook.com'

Parsing blogspot.com subdomains fails

I dont think that this result is expected, also getRegisterable returns the complete domain name with the subdomain in it.
Example:

Utopia\Domains\Domain Object
(
    [domain:protected] => notcivil.blogspot.com
    [TLD:protected] =>
    [suffix:protected] =>
    [name:protected] =>
    [sub:protected] =>
    [parts:protected] => Array
        (
            [0] => notcivil
            [1] => blogspot
            [2] => com
        )

)

Invoked via

require_once(dirname(__FILE__) . "/vendor/autoload.php");
$domain = new \Utopia\Domains\Domain("notcivil.blogspot.com");

🐛 Bug Report: getSuffix() empty for some domains

👟 Reproduction steps

This occurs for domains with * in the suffix list: https://publicsuffix.org/list/public_suffix_list.dat
for example:

$domain = new Domain('example.com.jm');
$domain->getSuffix();

👍 Expected behavior

"com.jm"

👎 Actual Behavior

"" (empty)

🎲 Utopia Domain version

Version 0.2.x

💻 Operating system

Linux

🐘 PHP Version

PHP 7.4.x

🧱 Your Environment

No response

👀 Have you spent some time to check if this issue has been raised before?

• I checked and didn't find similar issue

🏢 Have you read the Code of Conduct?

• I have read the Code of Conduct

Upgrade our issue templates to use GitHub issue forms ✍️

Introduction

GitHub has recently rolled out a public beta for their issue forms feature. This would allow you to create interactive issue templates and validate them 🤯.

Appwrite currently uses the older issue template format. Your task is to create GitHub issue forms for this repository. Please use Appwrite's issue templates as a reference for this PR.

Tasks summary:

• Fork & clone this repository
• Prepare bug report issue form in .github/ISSUE_TEMPLATE/bug.yaml
• Prepare documentation issue form in .github/ISSUE_TEMPLATE/documentation.yaml
• Prepare feature request issue form in .github/ISSUE_TEMPLATE/feature.yaml
• Push changes to master and test issue forms on your fork
• Submit pull request

If you need any help, reach out to us on our Discord server.

Are you ready to work on this issue? 🤔 Let us know, and we will assign it to you 😊

Happy Appwriting!