README

Bangladesh phone number toolkit — normalize, validate, format, detect operator and number type. Zero dependencies.

composer require jarir-ahmed/bd-phone

Quick Start

use JarirAhmed\BdPhone\BdPhone;

// Normalize to E.164
BdPhone::normalize('01712345678');      // +8801712345678
BdPhone::normalize('+8801712345678');   // +8801712345678
BdPhone::normalize('008801712345678');  // +8801712345678

// Validate
BdPhone::validate('01712345678');       // true
BdPhone::validate('01112345678');       // false (invalid prefix)

// Format
BdPhone::format('01712345678', 'local');       // 01712 345678
BdPhone::format('01712345678', 'local_dash');  // 01712-345678
BdPhone::format('01712345678', 'intl');        // +880 1712 345678
BdPhone::format('01712345678', 'intl_dash');   // +880-1712-345678
BdPhone::format('01712345678', 'e164');        // +8801712345678

// Detect operator
BdPhone::getOperator('01712345678');    // Grameenphone
BdPhone::getOperator('01812345678');    // Robi
BdPhone::getOperator('01912345678');    // Banglalink
BdPhone::getOperator('01512345678');    // Teletalk

// Number type
BdPhone::getNumberType('01712345678');  // mobile

// Full info
BdPhone::info('01712345678');
// [
//   'normalized'    => '+8801712345678',
//   'valid'         => true,
//   'operator'      => 'Grameenphone',
//   'type'          => 'mobile',
//   'local'         => '01712 345678',
//   'international' => '+880 1712 345678',
// ]

Supported Operators

API

normalize(string $number): string

Convert to E.164 format (+8801XXXXXXXXX). Returns empty string if unparseable.

validate(string $number): bool

Check if the number is a valid Bangladeshi phone number with a known operator prefix.

format(string $number, string $format): string

Format into one of: e164, local, local_dash, intl, intl_dash.

getOperator(string $number): ?string

Detect mobile operator. Returns null if unknown.

getNumberType(string $number): ?string

Identify type: mobile, or null if unknown.

info(string $number): array

Return all data as an associative array.

Testing

composer install
composer test

License

MIT

jarir-ahmed-bd-phone