davidmarsmalow/indonesian-phone

Indonesian phone number toolkit for PHP.

v0.2.0 2026-05-20 08:22 UTC

Requires

• php: ^8.0
• ext-mbstring: *

Requires (Dev)

• pestphp/pest: ^4.7

MIT

• Kristoforus David Renaldy

• validation
• phone
• phone-number
• indonesian
• indonesia
• E164

Published on Packagist.org on 2026-05-20 08:29 UTC

README

Indonesian phone number toolkit for PHP.

Installation

composer require davidmarsmalow/indonesian-phone

Usage

use Davidmarsmalow\IndonesianPhone\Phone;

$phone = Phone::make('0812-3456-7890');

$phone->raw(); // 0812-3456-7890
$phone->normalize(); // 6281234567890
$phone->isValid();  // true
$phone->isMobile(); // true
$phone->isFixedLine(); // false
$phone->type(); // mobile
$phone->toE164(); // [phone]

Raw Value

raw() returns the original value passed to Phone::make().

Phone::make('0812-3456-7890')->raw(); // 0812-3456-7890

Normalization

normalize() removes non-numeric characters and converts local Indonesian numbers that start with 0 into country-code format.

Phone::make('0812-3456-7890')->normalize(); // 6281234567890
Phone::make('[phone]')->normalize(); // 6281234567890
Phone::make('[phone]')->normalize(); // 622112345678

Validation

isValid() returns true when the number is recognized as either a mobile or fixed-line Indonesian phone number.

Phone::make('0812-3456-7890')->isValid(); // true
Phone::make('[phone]')->isValid(); // true
Phone::make('12345')->isValid(); // false

Use isMobile() when you only want to accept Indonesian mobile numbers.

Phone::make('0812-3456-7890')->isMobile(); // true
Phone::make('[phone]')->isMobile(); // false

Use isFixedLine() when you only want to accept Indonesian fixed-line numbers.

Phone::make('[phone]')->isFixedLine(); // true
Phone::make('0812-3456-7890')->isFixedLine(); // false

Type Detection

type() returns the detected phone number type, or null when the number is invalid or unrecognized.

Phone::make('0812-3456-7890')->type(); // mobile
Phone::make('[phone]')->type(); // fixed_line
Phone::make('12345')->type(); // null

You can compare the result using the provided constants.

Phone::TYPE_MOBILE; // mobile
Phone::TYPE_FIXED_LINE; // fixed_line

E.164 Format

toE164() returns the phone number in E.164 format when valid, or null when invalid.

Phone::make('0812-3456-7890')->toE164(); // [phone]
Phone::make('[phone]')->toE164(); // [phone]
Phone::make('12345')->toE164(); // null

WhatsApp Link

Generate WhatsApp links directly from Indonesian phone numbers.

use Davidmarsmalow\IndonesianPhone\Phone;

Phone::make('0812-3456-7890')->toWhatsappLink();

// https://wa.me/6281234567890

With Prefilled Message

Phone::make('0812-3456-7890')
    ->toWhatsappLink('Hello World');

// https://wa.me/6281234567890?text=Hello+World

Invalid Number

Returns null when the phone number is invalid.

Phone::make('abc')->toWhatsappLink();

// null

Masking

mask() returns a masked normalized phone number when valid, or null when invalid`.

Phone::make('0812-3456-7890')->mask(); // 6281*****7890
Phone::make('[phone]')->mask(); // 6221****5678
Phone::make('12345')->mask(); // null

You can customize the visible digits and mask character.

Phone::make('0812-3456-7890')->mask(5, 4, '#'); // 62812####7890
Phone::make('0812-3456-7890')->mask(4, 4, '•'); // 6281•••••7890
Phone::make('0812-3456-7890')->mask(4, 4, '🔒'); // 6281🔒🔒🔒🔒🔒7890

You can also use emoji as the mask character because why not.

The mask character must be exactly one character. Unicode and emoji mask characters are supported through PHP's mbstring extension.

Testing

composer test