layershifter/tld-database

Database abstraction for Public Suffix List

Monday, July 16, 2018
by LayerShifter
Repository
1 Watchers
18 Stars
300,204 Installations

PHP
2 Dependents
0 Suggesters
2 Forks
0 Open issues
65 Versions
21 % Grown

The README.md

DEPRECATED

Please use https://github.com/jeremykendall/php-domain-parser., _(*1)

, _(*2)

TLDDatabase

, _(*3)

Abstraction layer for Public Suffix List in PHP. Used by TLDExtract., _(*4)

Main idea of library provide easy and fast access to actual database of Public Suffix List. Library always supplied with actual database., _(*5)

This package is compliant with PSR-1, PSR-2, PSR-4. If you notice compliance oversights, please send a patch via pull request., _(*6)

Requirements

The following versions of PHP are supported:, _(*7)

PHP 5.5
PHP 5.6
PHP 7.0
PHP 7.1
HHVM

Basic usage

First of all you need load Store class., _(*8)

$store = new \LayerShifter\TLDDatabase\Store();

For check existence of entry in database you need use isExists method:, _(*9)

$store->isExists(string $suffix) : bool;

$store->isExists('com'); // true
$store->isExists('comcom'); // false

Note: suffix must be without leading dot., _(*10)

For get type of suffix you need use getType method:, _(*11)

For check existence of entry in database you need use isExists method:, _(*12)

$store->isExists(string $suffix): int;

$store->getType('com'); // \LayerShifter\TLDDatabase\Store::TYPE_ICANN = 1
$store->getType('s3.amazonaws.com'); // \LayerShifter\TLDDatabase\Store::TYPE_PRIVATE = 2

If entry doesn't exists method will throw exception, else it will return one of integer constants: - \LayerShifter\TLDDatabase\Store::TYPE_ICANN; - \LayerShifter\TLDDatabase\Store::TYPE_PRIVATE;, _(*13)

For direct check of type you can use isICANN or isPrivate method., _(*14)

$store->isICANN(string $suffix) : bool;

$store->isICANN'com'); // true
$store->isICANN('s3.amazonaws.com'); // false

$store->isPrivate(string $suffix) : bool;

$store->isPrivate('com'); // false
$store->isPrivate('s3.amazonaws.com'); // true

Advanced usage

There are some cool features for developers., _(*15)

Custom database

If you need operate with custom (non-packaged) database you simply need to add argument to Store constructor., _(*16)

$store = new \LayerShifter\TLDDatabase\Store(string $filename);
$store = new \LayerShifter\TLDDatabase\Store(__DIR__ . '/cache/datatabase.php');

Update

If you use custom database you need update it :wink: So, you can use Update class., _(*17)

$update = new \LayerShifter\TLDDatabase\Update(string $filename);
$update = new \LayerShifter\TLDDatabase\Update(__DIR__ . '/cache/datatabase.php');

$update->run();

HTTP-adapter

Basically library uses cURL adapter for updates, but you can use custom adapter., _(*18)

class customHttp implements \LayerShifter\TLDDatabase\Http\AdapterInterface {
    public function get() {} 
}

$update = new \LayerShifter\TLDDatabase\Update(__DIR__ . '/cache/datatabase.php', 'customHttp');
$update->run();

Install

Via Composer, _(*19)

``` bash $ composer require layershifter/tld-database, _(*20)


## Testing
``` bash
$ composer test

Versioning

Library uses SemVer versioning. Where: - major makes incompatible API changes; - minor adds functionality, fully backwards-compatible; - patch is update of database from Public Suffix List., _(*21)

Database has every week update cycle., _(*22)

Contributing

Please see CONTRIBUTING and CONDUCT for details., _(*23)

License

This library is released under the Apache 2.0 license. Please see License File for more information., _(*24)

The Versions

16/07 2018

dev-master

9999999-dev

Database abstraction for Public Suffix List

library tld-database

Database abstraction for Public Suffix List

layershifter/tld-database

The README.md

DEPRECATED

TLDDatabase

Requirements

Basic usage

Advanced usage

Custom database

Update

HTTP-adapter

Install

Versioning

Contributing

License

The Versions

dev-master

The Requires

The Development Requires

by Alexander Fedyashov

1.0.61

The Requires

The Development Requires

by Alexander Fedyashov

1.0.60

The Requires

The Development Requires

by Alexander Fedyashov

1.0.59

The Requires

The Development Requires

by Alexander Fedyashov

1.0.58

The Requires

The Development Requires

by Alexander Fedyashov

1.0.57

The Requires

The Development Requires

by Alexander Fedyashov

1.0.56

The Requires

The Development Requires

by Alexander Fedyashov

1.0.55

The Requires

The Development Requires

by Alexander Fedyashov

1.0.54

The Requires

The Development Requires

by Alexander Fedyashov

1.0.53

The Requires

The Development Requires

by Alexander Fedyashov

1.0.52

The Requires

The Development Requires

by Alexander Fedyashov

dev-chore/php7.2

The Requires

The Development Requires

by Alexander Fedyashov

1.0.51

The Requires

The Development Requires

by Alexander Fedyashov

1.0.50

The Requires

The Development Requires

by Alexander Fedyashov

1.0.49

The Requires

The Development Requires

by Alexander Fedyashov

1.0.48

The Requires

The Development Requires