cyb3rk1d/zambia_mobile_networks

Identify Zambian mobile networks (Airtel, MTN, Zamtel) from a phone number. Framework-agnostic core with optional Laravel service provider and facade.

v0.1.0 2026-08-25 14:06 UTC

Requires

• php: ^8.1

Requires (Dev)

• illuminate/container: ^12.0
• illuminate/support: ^10.0 || ^11.0 || ^12.0
• phpunit/phpunit: ^10.5 || ^11.0

Suggests

• illuminate/support: Enables the Laravel service provider and facade (^10.0 || ^11.0 || ^12.0).

MIT

• cyb3rk1d

• mobile
• phone
• laravel
• msisdn
• airtel
• mtn
• Zambia
• zamtel

Published on Packagist.org on 2026-08-25 14:10 UTC

README

Identify Zambian mobile networks (Airtel, MTN, Zamtel, Zed Mobile) from a phone number. Framework-agnostic core, with an optional Laravel service provider and facade.

Prefixes

Network	Local	With country code (260)
Airtel	097, 077, 057	26097, 26077, 26057
MTN	096, 076, 056	26096, 26076, 26056
Zamtel	095, 075, 055	26095, 26075, 26055
Zed Mobile	098	26098

Install

composer require cyb3rk1d/zambia_mobile_networks

Usage

Plain PHP

use Cyb3rk1d\ZambiaMobileNetworks\ZambiaMobileNetworks;
use Cyb3rk1d\ZambiaMobileNetworks\Network;

$networks = new ZambiaMobileNetworks();

$networks->detect('0971234567');      // Network::Airtel
$networks->detect('260761234567');    // Network::Mtn
$networks->detect('[phone]'); // Network::Zamtel
$networks->detect('0911234567');      // null

$networks->detect('0971234567')->label(); // "Airtel"
$networks->supports('0971234567', Network::Airtel); // true

$networks->networks();               // [Network::Airtel, Network::Mtn, Network::Zamtel, Network::Zed]
$networks->logo(Network::Mtn);       // "data:image/png;base64,..."
$networks->logo(Network::Mtn, '/path/to/logo.png'); // encode your own image

Laravel

The service provider and facade are auto-discovered.

use Cyb3rk1d\ZambiaMobileNetworks\Facades\ZambiaMobileNetworks;
use Cyb3rk1d\ZambiaMobileNetworks\Network;

ZambiaMobileNetworks::detect('0971234567'); // Network::Airtel
ZambiaMobileNetworks::supports('0961234567', Network::Mtn); // true
ZambiaMobileNetworks::networks(); // [Network::Airtel, Network::Mtn, Network::Zamtel, Network::Zed]
ZambiaMobileNetworks::logo(Network::Zed); // "data:image/png;base64,..."

Or resolve from the container:

app(\Cyb3rk1d\ZambiaMobileNetworks\ZambiaMobileNetworks::class)->detect('0951234567');

Test

composer install
vendor/bin/phpunit

License

MIT