haroldkerry/msisdn-network-detector

Detects mobile network providers for given MSISDNs

v3.0.0 2026-02-25 11:06 UTC

MIT

• Harold Kerry

README

A PHP library for cleaning MSISDNs and detecting mobile network providers based on number prefixes.

Supported Kenyan Networks

• Safaricom
• Airtel
• Telkom
• Equitel

Non-Kenyan numbers are automatically classified a International

Installation

You can install via Composer:

composer require haroldkerry/msisdn-network-detector

Usage Example

use HaroldKerry\MsisdnNetworkDetector\NetworkDetector;

$detector = new NetworkDetector();

/**
 * Detect Network (Recommended)
 */



$network = $detector->detectNetwork('[phone]');
echo "Network: " . $network; 
// Safaricom, Airtel, Telkom, Equitel, // Unknown Kenyan Network, or International

/**
 * Clean an MSISDN
 */

$cleaned = $detector->cleanMsisdn('[phone]');
echo $cleaned; // 0700000000 (for Kenyan numbers) // 255700000000 (for international numbers)

/**
 * Detect Multiple MSISDNs
 */
$msisdns = [ '[phone]', '0735110000', '[phone]' ];
$results = $detector->detectMultipleNetworks($msisdns);

print_r($results); // [ '[phone]' => 'Safaricom', '0735110000' => 'Airtel', '[phone]' => 'International' ]

Kenyan Number Rules

A number is treated as Kenyan if it starts with:

+254 254 or 0

Valid Kenyan numbers are normalized to:

07XXXXXXXX

If the prefix does not match any known network, the result will be:

Unknown Kenyan Network

International Numbers

Any number that does not match Kenyan formats will:

Be cleaned (digits only)

Be returned as International during detection

Contributing

Contributions are welcome via Pull Requests. Please fork the repository and submit a PR to the main branch.