https://github.com/myerscode/laravel-domain-validator
Validate Domains names in Laravel using PHP Domain Parser.
https://github.com/myerscode/laravel-domain-validator
Last synced: 3 months ago
JSON representation
Validate Domains names in Laravel using PHP Domain Parser.
- Host: GitHub
- URL: https://github.com/myerscode/laravel-domain-validator
- Owner: myerscode
- License: mit
- Created: 2024-05-02T16:48:21.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2024-09-23T19:41:59.000Z (over 1 year ago)
- Last Synced: 2024-11-22T18:11:39.957Z (over 1 year ago)
- Language: PHP
- Size: 111 KB
- Stars: 2
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: readme.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# Laravel Domain Validator
> A Laravel package for validating domain properties
[](https://packagist.org/packages/myerscode/laravel-domain-validator)
[](https://packagist.org/packages/myerscode/laravel-domain-validator)
[](https://packagist.org/packages/myerscode/laravel-domain-validator)
[](https://codecov.io/gh/myerscode/laravel-domain-validator)
## Why is this useful?
It allows easy integration of the [PHP Domain Parser](https://github.com/jeremykendall/php-domain-parser) PHP Domain Parser
by [Jeremy Kendall](https://github.com/jeremykendall) into a Laravel app, in order to validate values against known
## Installation
The package can be installed via composer:
```bash
composer require myerscode/laravel-domain-validator
```
## Usage
Fetch data sets
```php
artisan domain-validator:cache
```
Cache the fetched data sets
```php
artisan domain-validator:cache
```
Do both together!
```php
artisan domain-validator:refresh
```
## Scheduling
It is recommended to schedule the refresh command, in order to remove the need of running the `domain-validator:refresh` command
every time you need to update your cache.
Keeping the sources of truth (the )
```php
// routes/console.php
Schedule::call('domain-validator:refresh')->daily();
// alternatively initialize a new command class
Schedule::call(new \Myerscode\Laravel\DomainValidator\Commands\RefreshCommand)->daily();
```
## Checks
Note: For developer experience, all strings passed will be sanitized to remove trailing slashes `/` and `http(s)://`.
Is the value recognized valid a valid TLD suffix recognized by the Internet Corporation for Assigned Names and
Numbers (ICANN) as....
### Has ICANN Suffix
> Tells whether the effective TLD has a matching rule in a Public Suffix List ICANN Section.
```php
hasICANNSuffix('myerscode.com') // true
hasICANNSuffix('cloudfront.net') // false
```
### Has Known Suffix
> Tells whether the effective TLD has a matching rule in a Public Suffix List.
For more information i go to the [Public Suffix section](#public-suffix)
```php
hasKnownSuffix('myerscode.co') // true
hasKnownSuffix('myerscode.corgi') // false
```
### Has Private Suffix
> Tells whether the effective TLD has a matching rule in a Public Suffix List Private Section.
```php
hasPrivateSuffix('myerscode.cloudfront.net') // true
hasPrivateSuffix('cloudfront.net') // false
```
### Is Domain
> Is the value parseable as to a valid domain
```php
isDomain('myerscode.com') // true
isDomain('.com') // false
```
### Is TLD
> Is the value a valid Top Level Domain
```php
isTld('.com') // true
isTld('.corgi') // false
```
## Issues
Bug reports and feature requests can be submitted on the [Github Issue Tracker](https://github.com/myerscode/laravel-domain-validator/issues).
## Contributing
We are very happy to receive pull requests to add functionality or fixes. Please read the Myerscode [contributing](https://github.com/myerscode/docs/blob/main/CONTRIBUTING.md) guide for information.
## License
The MIT License (MIT). Please see [License File](LICENSE) for more information.