MSISDN

DESCRIPTION

A lightweight PHP library which resolves mobile network operator, country data and subscriber number from MSISDN.

Synopsis

Library that returns MSISDN information

takes MSISDN as an input
returns MNO identifier, country dialling code, subscriber number and country identifier as defined with ISO 3166-1-alpha-2
library is exposed via REST API using Slim framework (official site and git repository)

Requirements

PHP 7.1 or higher

Installation

Requirements:

Git
Composer

Steps:

git clone ssh://git@github.com/mzzz47/msisdn

cd msisdn
run install.sh which takose care of composer and creates log folder and files

./install.sh

Web server setup for Slim is described here

Nginx example :

server {
    listen 80;
    server_name msisdn-ftw.net;
    
    #logs
    error_log /path/to/msisdn/logs/error.log;
    access_log /path/to/msisdn/logs/access.log;
    
    root /path/to/msisdn/api;
    index index.php;
    
    location / {
      try_files $uri /index.php$is_args$args;
    }

    location ~ \.php {
      try_files $uri =404;
      alias                   /srv/apps/msisdn/api/public/$1;
      
      fastcgi_split_path_info ^(.+\.php)(/.+)$;
      
      include fastcgi_params;
      fastcgi_param           SCRIPT_FILENAME $document_root$fastcgi_script_name;
      fastcgi_param           SCRIPT_NAME $fastcgi_script_name;
      fastcgi_index           index.php;
      # IP
      fastcgi_pass            127.0.0.1:9000;
      # Sockets (check the path to the socket file)
      #fastcgi_pass           unix:/var/run/php-fpm/php-fpm.sock;
    }
}

Usage

GET:

url: http://msisdn-ftw.net/v1/msisdn/447700900663

POST:

url: http://msisdn-ftw.net/v1/msisdn/
parameter:
{
  msisdn: '+44 7700 900663'
}

Response json:

{
  "CountryISO": "GB",
  "CountryPrefix": "44",
  "MobileNetworkCode": "77",
  "ProviderName": "BT Group",
  "SubscriberNumber": "00900663"
}

Tests

Composer will setup the test environent for you. Run tests using:

./vendor/bin/phpunit --bootstrap vendor/autoload.php tests

from within a project root folder

Author

Matej Županić

mazu0/msisdn