zipavlin/phony

A helper class for parsing, normalizing and displaying Slovene phone numbers

1.2.0 2022-09-15 03:38 UTC

MIT

• Žiga Pavlin

README

A phone number parser tailored for Slovene number format.

Install

$ composer require zipavlin/phony

Quick start

use Zipavlin\Phony;
$phony = new Phony()

echo $phony->from('041 123-456')->toDisplay(); // [phone]
echo $phony->from('041 123 456')->toFormat('00386 0{area}/{number:2}-{number:2}-{number}'); // 00386 041/12-34-56
echo $phony->from('01 1234-567')->toDisplay(); // [phone]

Methods

method name	attribute	description
from	$input	Create new instance from unformatted phone number string
toParsed		Return phone number as parsed object
toNormal		Return phone number as short normalized string
toHref		Return phone number as href link
toFull		Return phone number as full trimmed string
toDisplay		Return phone number as fully formatted string
toFormat	$format	Return phone number formatted with $format string
toObject	$format	Return object with all phone number info
toRender	$attributes, $format	Renders a attribute

Format string

$format attribute can be either string or array [string, string], where first format string is used for mobile numbers and second one is used for stationary phone numbers.

Format tokens

• {area} - area code without leading zero
• {number} - rest of phone number

Both tokens have an optional characters-count parameter: {area:2} and {number:3} respectively.

Format example

Working with phone number 041 123456 {area}/{number:5}-{number} would return 41/12345-6
{area:1}-{area:1} {number} would return 4-1 123456
0{area}/{number:3} {number:6} would return 041/123 456