thechiddx3/telcodetect

Instantly identify which Nigerian mobile network a phone number belongs to, by NCC-assigned prefix.

dev-main 2026-02-19 15:54 UTC

Requires

• php: ^8.1

MIT

• TheChiddx3

README

Instantly identify which Nigerian mobile network a phone number belongs to, by NCC-assigned prefix.

Results may be inaccurate for ported numbers.
Nigeria's Mobile Number Portability (MNP) scheme allows subscribers to switch networks while keeping their original number. A number with an MTN prefix (e.g. 0803) may therefore be actively used on Glo, Airtel, or any other network after porting. TelcoDetect has no way to detect this — it can only report the network originally assigned to the prefix.

Use results as a best-effort suggestion, not a guarantee.

Features

• Detects MTN, Glo, Airtel, 9mobile, and Ntel
• Supports multiple number formats: 080XXXXXXXX, +23480XXXXXXXX, 23480XXXXXXXX
• No external dependencies

Package Structure

Telcodetect/
├── src/
│   └── TelcoDetect.php   ← Core package (Detector, Network, PrefixRegistry, Normaliser)
├── logos/                ← Network logo images
│   ├── mtn.png
│   ├── glo.png
│   ├── airtel.png
│   ├── 9mobile.png
│   └── ntel.png
├── index.php             ← Web demo / usage example
└── README.md

Usage

require_once 'src/TelcoDetect.php';

use TelcoDetect\Detector;
use TelcoDetect\UnknownNetworkException;

$detector = new Detector();

// Returns a DetectionResult object
$result = $detector->detect('08031234567');

echo $result->network->name;   // "MTN Nigeria"
echo $result->prefix;          // "0803"
echo $result->normalised;      // "08031234567"

// Safe version — returns null instead of throwing
$result = $detector->tryDetect('00000000000');
// $result === null

Requirements

• PHP 8.1+
• MAMP / Apache / any PHP-capable web server

License

MIT