Download the PHP package khakimjanovich/uz-phone without Composer

uz-phone

Strict Uzbek phone parsing for PHP. UzPhoneNumber wraps brick/phonenumber internally, adds Uzbekistan prefix data, and exposes a small Brick-style object API without leaking Brick classes.

Why

Most apps only need one thing from Uzbek phone input: parse it into a canonical object, identify its prefix type, and then decide what their own domain should accept. uz-phone keeps that surface small, strict, and framework-agnostic.

• Parses Uzbek phone numbers
• Normalizes to E.164: +998901234567
• Formats display output: +998 90 123 45 67
• Masks private output: +998 90 *** ** 67
• Returns prefix data with PHP backed enums
• Uses brick/phonenumber for phone-number parsing and formatting
• Keeps Uzbek prefix type and operator data in this package

Installation

Requires PHP 8.2 or newer.

Usage

Prefix Data

Prefix data reflects original numbering allocation, not a guaranteed current operator or location after number portability. Geographic PSTN prefixes return null from getOperator() because the ITU table names the region, not a specific operator.

Supported Input

All accepted input normalizes to +998901234567.

The parser is intentionally strict. It accepts digits, a leading +, spaces, parentheses, and hyphens. It rejects unknown prefixes, wrong country codes, unsupported separators, letters, overlong numbers, and incomplete numbers.

Uzbek Prefixes

Source: ITU Uzbekistan numbering plan update.

API

parse() throws ParseException when the input is not a valid Uzbek phone number. The exception exposes ParseErrorType through $exception->error_type.

UzPhoneNumber methods:

Parse error types:

Testing

License

MIT.