PHPackages                             persian-tools/php-persian-tools - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. persian-tools/php-persian-tools

ActiveLibrary[Utility & Helpers](/categories/utility)

persian-tools/php-persian-tools
===============================

An anthology of a variety of tools for Persian language in PHP.

25143[1 issues](https://github.com/persian-tools/php-persian-tools/issues)[2 PRs](https://github.com/persian-tools/php-persian-tools/pulls)PHPCI failing

Since Mar 25Pushed 2y ago3 watchersCompare

[ Source](https://github.com/persian-tools/php-persian-tools)[ Packagist](https://packagist.org/packages/persian-tools/php-persian-tools)[ RSS](/packages/persian-tools-php-persian-tools/feed)WikiDiscussions master Synced 5d ago

READMEChangelogDependenciesVersions (2)Used By (0)

 [![](./images/logo.png)](./images/logo.png)

Persian Tools PHP
=================

[](#persian-tools-php)

PersianTools PHP is a standalone, library-agnostic PHP Library that enables some of the Persian features for use in the PHP.

[![Latest Stable Version](https://camo.githubusercontent.com/9c55589866d8fc4058bc34c59ab058170df8fd3733b6740bf688d443fd8cf7b3/68747470733a2f2f706f7365722e707567782e6f72672f7065727369616e2d746f6f6c732f7068702d7065727369616e2d746f6f6c732f762f737461626c65)](https://packagist.org/packages/persian-tools/php-persian-tools)[![Total Downloads](https://camo.githubusercontent.com/186f68ec8d52959f03a03eb504c009412f4e88de50b860bdc74c39de5a42f99a/68747470733a2f2f706f7365722e707567782e6f72672f7065727369616e2d746f6f6c732f7068702d7065727369616e2d746f6f6c732f646f776e6c6f616473)](https://packagist.org/packages/persian-tools/php-persian-tools)[![Build Status](https://github.com/persian-tools/php-persian-tools/workflows/Continuous%20Integration/badge.svg)](https://github.com/persian-tools/php-persian-tools/actions)[![Code Style](https://camo.githubusercontent.com/b2f19fadf7beac42d779ce6c3e4693e2ccaf8f54a602dec70db6e112fa9bbdcf/68747470733a2f2f6769746875622e7374796c6563692e696f2f7265706f732f3231343139373338332f736869656c643f7374796c653d666c6174)](https://github.styleci.io/repos/214197383)[![Code Coverage](https://camo.githubusercontent.com/8e6b25aa69706351e1432dd61dc96009d9a2978567c45b693081b4c792cc182a/68747470733a2f2f636f6465636f762e696f2f67682f7065727369616e2d746f6f6c732f7068702d7065727369616e2d746f6f6c732f6272616e63682f6d61737465722f67726170682f62616467652e7376673f73616e6974697a653d74727565)](https://codecov.io/gh/persian-tools/php-persian-tools)[![License](https://camo.githubusercontent.com/78f5a9c00ff59b0d2a646a135d501b9d7fabb15ed8374a19977725c44b1a612e/68747470733a2f2f706f7365722e707567782e6f72672f7065727369616e2d746f6f6c732f7068702d7065727369616e2d746f6f6c732f6c6963656e7365)](https://packagist.org/packages/persian-tools/php-persian-tools)[![PRs Welcome](https://camo.githubusercontent.com/c9a2815a79194ae5a6562d00ad07d1414a1028810e78ca60af7eef4c48328c75/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5052732d77656c636f6d652d6f72616e67652e737667)](https://github.com/persian-tools/php-persian-tools)[![status](https://camo.githubusercontent.com/f4c00d717de8968e4a6b6511bdc3c64b90fff8f3b8a6875263e033abe31562b0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f756e6465725f646576656c6f706d656e742d6c69676874626c75652e737667)](https://camo.githubusercontent.com/f4c00d717de8968e4a6b6511bdc3c64b90fff8f3b8a6875263e033abe31562b0/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f756e6465725f646576656c6f706d656e742d6c69676874626c75652e737667)

---

Features
--------

[](#features)

- Adding ordinal suffixes
- Converting Persian words to number
- Converting Persian numbers to word
- Adding and removing separator to/from numbers
- Converting Persian numbers to Arabic / English numbers and reverse
- Checking a string has/is Persian
- Validating Iranians national id
- Finding city and province names by national id
- Calculating bills
- Checking IBAN of the bank account (*SHEBA*)
- Validating ATM card number
- Finding name of banks by ATM card number
- Getting information from vehicle plate
- Fixing and decoding URLs with whitespace

Getting started
---------------

[](#getting-started)

You can install the package via composer:

```
composer require persian-tools/php-persian-tools
```

Usage
-----

[](#usage)

```
// soon ...
```

Testing
-------

[](#testing)

```
composer test
```

Changelog
---------

[](#changelog)

Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.

Contributing
------------

[](#contributing)

Thank you for your interest in [contributing](CONTRIBUTING.md)! Please feel free to put up a PR for any issue or feature request.

### Security

[](#security)

If you discover any security related issues, please email [ali\_4286@live.com](mailto:ali_4286@live.com) instead of using the issue tracker.

Credits
-------

[](#credits)

- [Ali Torki](https://github.com/ali-master)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

21

—

LowBetter than 19% of packages

Maintenance19

Infrequent updates — may be unmaintained

Popularity16

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity32

Early-stage or recently created project

 Bus Factor1

Top contributor holds 90.9% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

### Community

Maintainers

![](https://www.gravatar.com/avatar/8b3b38fb2c7f00f927b5a43b63d82afb44e4b884714b1b5d5da3eb4502100d84?d=identicon)[faridfr](/maintainers/faridfr)

---

Top Contributors

[![faridfr](https://avatars.githubusercontent.com/u/9497923?v=4)](https://github.com/faridfr "faridfr (10 commits)")[![amir9480](https://avatars.githubusercontent.com/u/16279288?v=4)](https://github.com/amir9480 "amir9480 (1 commits)")

### Embed Badge

![Health badge](/badges/persian-tools-php-persian-tools/health.svg)

```
[![Health](https://phpackages.com/badges/persian-tools-php-persian-tools/health.svg)](https://phpackages.com/packages/persian-tools-php-persian-tools)
```

###  Alternatives

[silverstripe/crontask

Module for running tasks with a standard cron timeschedule

24754.1k25](/packages/silverstripe-crontask)[shipsaas/laravel-inbox-process

Inbox pattern process implementation for your Laravel Applications

132.1k](/packages/shipsaas-laravel-inbox-process)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)