2017 © Pedro Peláez
 

library msisdn-ph

An MSISDN identification and cleaner library for Philippine telco subscribers

image

coreproc/msisdn-ph

An MSISDN identification and cleaner library for Philippine telco subscribers

  • Friday, October 27, 2017
  • by coreproc
  • Repository
  • 3 Watchers
  • 19 Stars
  • 3,325 Installations
  • PHP
  • 5 Dependents
  • 0 Suggesters
  • 7 Forks
  • 1 Open issues
  • 10 Versions
  • 19 % Grown

The README.md

MsisdnPH - PHP

Latest Version on Packagist ![Software License][ico-license] Build Status ![Coverage Status][ico-scrutinizer] Quality Score ![Total Downloads][ico-downloads], (*1)

Easily validate and manipulate Philippine mobile numbers., (*2)

Table of contents

Install

Run the following command at the root of your project (assuming you have Composer and a composer.json file already), (*3)

composer require coreproc/msisdn-ph "^1.0"

Usage

Validate the mobile number

$mobileNumber = '09171231234';

if (Msisdn::validate($mobileNumber)) {
    echo 'Valid mobile number';
} else {
    echo 'Invalid mobile number';
}

The validate method cleans the given mobile number and validates it so even if the mobile number is malformed or has other characters within it, it will still return true as long as the number is really valid:, (*4)

$validMobileNumber = '+639171231234';
$validMobileNumber = '+63-917-123-1234';
$validMobileNumber = '0917-123-1234';
$validMobileNumber = '0917.123.1234';
$validMobileNumber = '63 917 123 12 34 ';

Instantiate an MSISDN object

You can instantiate an MSISDN object and get a standardized format of your mobile number and even get the telco attached to the mobile number using this object., (*5)

$mobileNumber = '09171231234';

$msisdn = new Msisdn($mobileNumber);

The MSISDN object will throw an InvalidMsisdnException if you give it an invalid mobile number, so it's best to either catch the exception OR validate it before creating an MSISDN object., (*6)

$invalidMobileNumber = '0917-123-123';

try {
   $msisdn = new Msisdn($invalidMobileNumber);
} catch (InvalidMsisdnException $e) {
   echo 'The number is invalid';
   return;
}

OR, (*7)

$invalidMobileNumber = '0917-123-123';

if (Msisdn::validate($invalidMobileNumber)) {
    $msisdn = new Msisdn($invalidMobileNumber);
} else {
   echo 'Invalid mobile number';
   return;
}

Return a standardized format of your mobile number

When you've instantiated an Msisdn object, you can return the mobile number in any format you want., (*8)

$mobileNumber = '09171231234';

$msisdn = new Msisdn($mobileNumber);

echo $msisdn->get(); // will return 09171231234

echo $msisdn->get(true); // will return +639171231234

echo $msisdn->get(false, '-'); // will return 0917-123-1234

echo $msisdn->get(true, '-'); // will return +63-917-123-1234

echo $msisdn->get(true, '.'); // will return +63.917.123.1234

Get the telco operator of a mobile number

You can also get the telco operator of the given mobile number - this is based on the included prefixes we have gathered from the telcos., (*9)

We cannot guarantee that this list is updated so use with a grain of salt., (*10)

If you want to add to the prefixes, you can find the list inside the src/prefixes directory., (*11)

$mobileNumber = '09171231234';

$msisdn = new Msisdn($mobileNumber);

echo $msisdn->getOperator(); // will return Globe

Get the prefix of a mobile number

You might just want to get the prefix of a mobile number., (*12)

$mobileNumber = '09171231234';

$msisdn = new Msisdn($mobileNumber);

echo $msisdn->getPrefix(); // will return 917

Validating mobile numbers using Laravel 5.1

You can easily integrate this into Laravel's validator class by adding the line below to the default AppServiceProvider located in the app/Providers directory., (*13)

Inside the boot() method, add the following line:, (*14)

Validator::extend('msisdn', function ($attribute, $value, $parameters) {
    return Coreproc\MsisdnPh\Msisdn::validate($value);
});

Credits

About CoreProc

CoreProc is a software development company that provides software development services to startups, digital/ad agencies, and enterprises., (*15)

Learn more about us on our website., (*16)

License

The MIT License (MIT). Please see License File for more information., (*17)

The Versions

27/10 2017

dev-master

9999999-dev http://github.com/coreproc/msisdn-ph-php

An MSISDN identification and cleaner library for Philippine telco subscribers

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by Chris Bautista

smart globe sun msisdn msisdn philippines

07/06 2017

1.1.1

1.1.1.0 http://github.com/coreproc/msisdn-ph-php

An MSISDN identification and cleaner library for Philippine telco subscribers

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by Chris Bautista

smart globe sun msisdn msisdn philippines

07/06 2017

dev-update-prefix-operator

dev-update-prefix-operator http://github.com/coreproc/msisdn-ph-php

An MSISDN identification and cleaner library for Philippine telco subscribers

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by Chris Bautista

smart globe sun msisdn msisdn philippines

14/02 2016

1.1.0

1.1.0.0 http://github.com/coreproc/msisdn-ph-php

An MSISDN identification and cleaner library for Philippine telco subscribers

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by Chris Bautista

smart globe sun msisdn msisdn philippines

24/08 2015

1.0.1

1.0.1.0 http://github.com/coreproc/msisdn-ph-php

An MSISDN identification and cleaner library for Philippine telco subscribers

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

The Development Requires

by Chris Bautista

smart globe sun msisdn msisdn philippines

20/08 2015

1.0.0

1.0.0.0 http://github.com/coreproc/msisdn-ph-php

An MSISDN identification and cleaner library for Philippine telco subscribers

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

by Chris Bautista

smart globe sun msisdn msisdn philippines

22/11 2014

0.1.x-dev

0.1.9999999.9999999-dev http://github.com/coreproc/msisdn-ph-php

An MSISDN identification and cleaner library for Philippine telco subscribers

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

by Chris Bautista

smart globe sun msisdn msisdn philippines

22/11 2014

0.1.2

0.1.2.0 http://github.com/coreproc/msisdn-ph-php

An MSISDN identification and cleaner library for Philippine telco subscribers

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

by Chris Bautista

smart globe sun msisdn msisdn philippines

21/11 2014

0.1.1

0.1.1.0 http://github.com/coreproc/msisdn-ph-php

An MSISDN identification and cleaner library for Philippine telco subscribers

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

by Chris Bautista

smart globe sun msisdn msisdn philippines

21/11 2014

0.1

0.1.0.0 http://github.com/coreproc/msisdn-ph-php

An MSISDN identification and cleaner library for Philippine telco subscribers

  Sources   Download

MIT

The Requires

  • php >=5.3.0

 

by Chris Bautista

smart globe sun msisdn msisdn philippines