PHPackages                             pishran/persian-string - 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. pishran/persian-string

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

pishran/persian-string
======================

Convert Arabic/English/etc numbers and characters to Persian numbers and characters.

v1.3(8mo ago)57.4k↓42.9%11MITPHPPHP ^7.2|^8.0|^8.1|^8.2|^8.3|^8.4|^8.5CI failing

Since Jan 3Pushed 8mo ago1 watchersCompare

[ Source](https://github.com/pishran/persian-string)[ Packagist](https://packagist.org/packages/pishran/persian-string)[ Docs](https://github.com/pishran/persian-string)[ RSS](/packages/pishran-persian-string/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (5)Dependencies (1)Versions (6)Used By (1)

Persian String
==============

[](#persian-string)

تبدیل حروف، اعداد و کاراکترهای عربی، انگلیسی و ... به حروف، اعداد و کاراکترهای فارسی

```
$persianString = new PersianString();

$persianString->convert('یك متن «تقریبا» فارسي, که شامل برخی حروف، اعداد 1 و ٤ و سایر کاراکترهای غیر فارسی مي باشد');

// یک متن «تقریبا» فارسی، که شامل برخی حروف، اعداد ۱ و ۴ و سایر کاراکترهای غیر فارسی می باشد
```

روش نصب
-------

[](#روش-نصب)

برای نصب و استفاده از این پکیج می توانید از کمپوسر استفاده کنید:

`composer require pishran/persian-string`

مستندات
-------

[](#مستندات)

```
use Pishran\PersianString\PersianString;

$persianString = new PersianString(bool $withEmptyRules = false)

$persianString->convert(string $string): string

$persianString->getRules(): array

$persianString->addRule(string $key, string $value): void
$persianString->addRules(array $rules): void

$persianString->replaceRule(string $key, string $value): void
$persianString->replaceRules(array $rules): void

$persianString->deleteRule(string $key, string $value): void
$persianString->deleteRules(array $rules): void

$persianString->resetRules(): void
$persianString->forceResetRules(): void
```

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance59

Moderate activity, may be stable

Popularity28

Limited adoption so far

Community12

Small or concentrated contributor base

Maturity82

Battle-tested with a long release history

 Bus Factor1

Top contributor holds 100% 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.

###  Release Activity

Cadence

Every ~619 days

Total

5

Last Release

262d ago

PHP version history (4 changes)1.0PHP ^7.2

v1.1PHP ^7.2|^8.0

v1.2PHP ^7.2|^8.0|^9.0

v1.3PHP ^7.2|^8.0|^8.1|^8.2|^8.3|^8.4|^8.5

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/8607021?v=4)[Farid Aghili](/maintainers/FaridAghili)[@FaridAghili](https://github.com/FaridAghili)

---

Top Contributors

[![FaridAghili](https://avatars.githubusercontent.com/u/8607021?v=4)](https://github.com/FaridAghili "FaridAghili (9 commits)")

---

Tags

persianphpstringstringpersian

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/pishran-persian-string/health.svg)

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

###  Alternatives

[nette/utils

🛠 Nette Utils: lightweight utilities for string & array manipulation, image handling, safe JSON encoding/decoding, validation, slug or strong password generating etc.

2.1k430.4M1.7k](/packages/nette-utils)[danielstjules/stringy

A string manipulation library with multibyte support

2.4k26.3M192](/packages/danielstjules-stringy)[kwn/number-to-words

Multi language standalone PHP number to words converter. Fully tested, open for extensions and new languages.

4375.4M23](/packages/kwn-number-to-words)[coduo/php-to-string

Simple library that converts PHP value into strings

27013.4M14](/packages/coduo-php-to-string)[opis/string

Multibyte strings as objects

7626.6M9](/packages/opis-string)[paquettg/string-encode

Facilitating the process of altering string encoding in PHP.

699.1M43](/packages/paquettg-string-encode)

PHPackages © 2026

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