ngr-phone-validator

A PHP Libary to validate a nigerian phone number based on availabe public data., _(*1)

It utilizes some very common data to check if a Nigerian phone number is valid., _(*2)

It's very easy to setup and use., _(*3)

Using composer, _(*4)

composer require dammynex/ngr-phone-validator

Manually Download the zip package and require it, _(*5)

require_once 'path/to/dir/vendor/autoload.php';

Validating a phone number without exceptions, _(*6)

use Brainex\Tools\PhoneValidator;

$phone = (new PhoneValidator())
                //Phone number to validate
                ->setPhoneNumber('+2349061668519')
                //We do not want exceptions
                ->setThrowExceptions(false)
                //Do validation
                ->validate();

if($phone->isValid()) {
    echo 'The phone number is valid';
}

Validating a phone number using exceptions, _(*7)

use Brainex\Tools\PhoneValidator;
use Brainex\Exceptions\InvalidPhoneException;

try {
    $phone = (new PhoneValidator())
                ->setPhoneNumber('+2349061668519')
                ->validate();
} catch(InvalidPhoneException $e) {
    echo 'Invalid phone: ' . $e->getMessage();
}

When PhoneValidator::isValid() returns true, Other methods can be utilized., _(*8)

Method	Description
__toString()	Returns the phone number
getInternationalFormat()	Returns the international format of the specified phone number (eg. +2349061668519)
getInternationalFormatWithoutPlusPrefix()	Returns the international format with the plus sign (eg. 2349061668519)
getLength()	Returns the length of the phone number
getLocalFormat()	Returns the local format of specified phone number (eg. 09061668519)
getNetwork()	Returns the phone number's network
getPhoneNumber()	Returns the raw (unedited) specified phone number
getThrowExceptions()	Returns whether validator is assigned to throw exceptions
isOfLength(int $length)	Returns whether length of phone number matches a valid phone number length from the `Brainex\Tools\PhoneLengthParser` class
isNetwork(string $network)	Returns whether the phone number's network matches the specified `$network`. `$network` should be one from `Brainex\Tools\PhoneNetworkParser`
isValid()	Returns whether phone number is valid
isValidLength()	Return whether phone's length is parsed and valid
setPhoneNumber(string $phone)	Assign phone number to validator
setThrowExceptions()	Assign whether exceptions should be thrown
toJson()	Return phone number's data in json string
validate()	Initialize validation for the phone number