AbzarPHPOpen source · MIT

Persian details.
Taken care of.

The everyday essentials for Persian applications. Clean up text, check Iranian inputs, and handle money—with a consistent PHP toolkit.

Get started GitHub

composer require eram/abzar:^0.8@beta

REAL TASKS. ACTUAL LIBRARY OUTPUT.

See where Abzar fits.

Guided examples

Accept different formats. Keep one consistent number.

People type Persian digits, paste +98 numbers, or add spaces. Validate the input, then use a consistent value in your application.

Choose an example

Input

Customer contact details

Phone number entered by the customer: ۰۹۱۲ ۱۲۳ ۴۵۶۷

A sample contact field. Compare different ways of entering a number.

Abzar output

Returned by the library

From input to useful output.

Reveal the result to see what Abzar returns for this exact example.

PHP for this exact example

use Eram\Abzar\Validation\PhoneNumber;

$result = PhoneNumber::validate('۰۹۱۲ ۱۲۳ ۴۵۶۷');
$result->isValid();
$result->errorCodes();
$result->warningCodes();

$phone = PhoneNumber::tryFrom('۰۹۱۲ ۱۲۳ ۴۵۶۷');
$phone?->value();
$phone?->e164();

Input

Customer contact details

Phone number entered by the customer: +98 912 123 4567

A sample contact field. Compare different ways of entering a number.

Abzar output

Returned by the library

From input to useful output.

Reveal the result to see what Abzar returns for this exact example.

PHP for this exact example

use Eram\Abzar\Validation\PhoneNumber;

$result = PhoneNumber::validate('+98 912 123 4567');
$result->isValid();
$result->errorCodes();
$result->warningCodes();

$phone = PhoneNumber::tryFrom('+98 912 123 4567');
$phone?->value();
$phone?->e164();

Input

Customer contact details

Phone number entered by the customer: (021) 8888-7777

A sample contact field. Compare different ways of entering a number.

Abzar output

Returned by the library

From input to useful output.

Reveal the result to see what Abzar returns for this exact example.

PHP for this exact example

use Eram\Abzar\Validation\PhoneNumber;

$result = PhoneNumber::validate('(021) 8888-7777');
$result->isValid();
$result->errorCodes();
$result->warningCodes();

$phone = PhoneNumber::tryFrom('(021) 8888-7777');
$phone?->value();
$phone?->e164();

Input

Customer contact details

Phone number entered by the customer: 0912123456

A sample contact field. Compare different ways of entering a number.

Abzar output

Returned by the library

From input to useful output.

Reveal the result to see what Abzar returns for this exact example.

PHP for this exact example

use Eram\Abzar\Validation\PhoneNumber;

$result = PhoneNumber::validate('0912123456');
$result->isValid();
$result->errorCodes();
$result->warningCodes();

$phone = PhoneNumber::tryFrom('0912123456');
$phone?->value();
$phone?->e164();

Input

Customer contact details

Phone number entered by the customer: 09802002580

A sample contact field. Compare different ways of entering a number.

Abzar output

Returned by the library

From input to useful output.

Reveal the result to see what Abzar returns for this exact example.

Accepted, with a lookup warning

Consistent local value: 09802002580
International value · E.164: +989802002580
Readable display: 0980 200 2580

PHONE_NUMBER.UNKNOWN_OPERATOR

A missing operator lookup is a warning, not a reason to reject a structurally valid number.

PHP for this exact example

use Eram\Abzar\Validation\PhoneNumber;

$result = PhoneNumber::validate('09802002580');
$result->isValid();
$result->errorCodes();
$result->warningCodes();

$phone = PhoneNumber::tryFrom('09802002580');
$phone?->value();
$phone?->e164();

Validation checks structure. It does not send an SMS or establish ownership.

Read the guide

The same product, written two different ways.

Prepare both saved titles and queries the same way. Arabic letters and different digit scripts should not create an accidental mismatch.

Choose an example

Input

A product search

What the visitor searches for: كفش مدل ١٢
Product title in your catalog: کفش مدل ۱۲

Normalize both sides before comparing them.

Abzar output

Returned by the library

From input to useful output.

Reveal the result to see what Abzar returns for this exact example.

PHP for this exact example

use Eram\Abzar\Text\CharNormalizer;

$normalizer = new CharNormalizer();
$query = $normalizer->normalizeForSearch('كفش مدل ١٢');
$stored = $normalizer->normalizeForSearch('کفش مدل ۱۲');

$query === $stored; // true

Input

A product search

What the visitor searches for: کفش مدل 12
Product title in your catalog: کفش مدل ۱۲

Normalize both sides before comparing them.

Abzar output

Returned by the library

From input to useful output.

Reveal the result to see what Abzar returns for this exact example.

PHP for this exact example

use Eram\Abzar\Text\CharNormalizer;

$normalizer = new CharNormalizer();
$query = $normalizer->normalizeForSearch('کفش مدل 12');
$stored = $normalizer->normalizeForSearch('کفش مدل ۱۲');

$query === $stored; // true

Input

A product search

What the visitor searches for: کفش مدل ۱۳
Product title in your catalog: کفش مدل ۱۲

Normalize both sides before comparing them.

Abzar output

Returned by the library

From input to useful output.

Reveal the result to see what Abzar returns for this exact example.

PHP for this exact example

use Eram\Abzar\Text\CharNormalizer;

$normalizer = new CharNormalizer();
$query = $normalizer->normalizeForSearch('کفش مدل ۱۳');
$stored = $normalizer->normalizeForSearch('کفش مدل ۱۲');

$query === $stored; // false

This demonstrates normalized string equality, not fuzzy search, ranking, or a search engine.

Read the guide

Toman for the customer. Explicit rials in your code.

Calculate an invoice total, display it in Persian, and get the rial value for an integration that expects rials.

Choose an example

Input

A small invoice

Unit price: ۱۲۰،۰۰۰ تومان
Quantity: 3
Shipping: ۲۵،۰۰۰ تومان

3 items × 120,000 toman + 25,000 toman shipping.

Abzar output

Returned by the library

From input to useful output.

Reveal the result to see what Abzar returns for this exact example.

PHP for this exact example

use Eram\Abzar\Money\{Amount, Currency};

$price = Amount::fromToman(120_000);
$total = $price->times(3)
    ->add(Amount::fromToman(25_000));

Currency::format($total);
$total->inRials();
$total->toWords();

Input

Amount received in rials

Amount from a service using rials: 12,345 rials

The remaining 5 rials must not disappear when displaying toman.

Abzar output

Returned by the library

From input to useful output.

Reveal the result to see what Abzar returns for this exact example.

PHP for this exact example

use Eram\Abzar\Money\{Amount, Currency};

$amount = Amount::fromRials(12_345);
Currency::format($amount);
$amount->inRials();
$amount->toWords();

Amount handles arithmetic and units. It does not connect to a payment gateway.

Read the guide

Precomputed with Abzar’s PHP code. Choosing an example reveals its saved result; no PHP runs in your browser. Source snapshot

Fits into what you’re building.

Use Abzar in plain PHP or bring it into your framework. Start with one utility and reach for the others when you need them.

Explore the documentation

Requires: PHP 8.1+ · mbstring
Composer dependencies: None at runtime
License: MIT
Release channel: 0.8 · Beta

Persian details.
Taken care of.

See where Abzar fits.

Accept different formats. Keep one consistent number.

Input

Abzar output

From input to useful output.

Input

Abzar output

From input to useful output.

Input

Abzar output

From input to useful output.

Input

Abzar output

From input to useful output.

Input

Abzar output

From input to useful output.

The same product, written two different ways.

Input

Abzar output

From input to useful output.

Input

Abzar output

From input to useful output.

Input

Abzar output

From input to useful output.

Toman for the customer. Explicit rials in your code.

Input

Abzar output

From input to useful output.

Input

Abzar output

From input to useful output.

Text that reads naturally

Useful answers from your inputs

Amounts with their units attached

Fits into what you’re building.

Persian details.Taken care of.

See where Abzar fits.

Accept different formats. Keep one consistent number.

Input

Abzar output

From input to useful output.

Input

Abzar output

From input to useful output.

Input

Abzar output

From input to useful output.

Input

Abzar output

From input to useful output.

Input

Abzar output

From input to useful output.

The same product, written two different ways.

Input

Abzar output

From input to useful output.

Input

Abzar output

From input to useful output.

Input

Abzar output

From input to useful output.

Toman for the customer. Explicit rials in your code.

Input

Abzar output

From input to useful output.

Input

Abzar output

From input to useful output.

Text that reads naturally

Useful answers from your inputs

Amounts with their units attached

Fits into what you’re building.

Persian details.
Taken care of.