PHPackages                             zare/laravel-persian - 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. [Localization & i18n](/categories/localization)
4. /
5. zare/laravel-persian

ActiveLibrary[Localization & i18n](/categories/localization)

zare/laravel-persian
====================

A Laravel package for Persian localization including number conversion, Jalali date, validation, and Persian number formatting

V1.0.1(7mo ago)03MITPHPPHP ^8.0

Since Sep 10Pushed 7mo agoCompare

[ Source](https://github.com/Digitaltoman/zare-laravel-persian)[ Packagist](https://packagist.org/packages/zare/laravel-persian)[ RSS](/packages/zare-laravel-persian/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (2)Dependencies (3)Versions (3)Used By (0)

Zare Laravel Persian 🇮🇷
=======================

[](#zare-laravel-persian-)

[![GitHub release](https://camo.githubusercontent.com/5485877b2e43a407bda6dd84c4c7a025744c04b029b39ec1f8954810187f7c90/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f4469676974616c746f6d616e2f7a6172652d6c61726176656c2d7065727369616e)](https://camo.githubusercontent.com/5485877b2e43a407bda6dd84c4c7a025744c04b029b39ec1f8954810187f7c90/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f4469676974616c746f6d616e2f7a6172652d6c61726176656c2d7065727369616e)[![GitHub issues](https://camo.githubusercontent.com/174dafb002341f29026a57e65a4a77e2f1bd996f50b059c4024d931747ba832f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f4469676974616c746f6d616e2f7a6172652d6c61726176656c2d7065727369616e)](https://camo.githubusercontent.com/174dafb002341f29026a57e65a4a77e2f1bd996f50b059c4024d931747ba832f/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6973737565732f4469676974616c746f6d616e2f7a6172652d6c61726176656c2d7065727369616e)[![GitHub license](https://camo.githubusercontent.com/48db34f783d41c9660d518eb7311909f4735ce16ecf887bb23d646f33d15cdc0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f4469676974616c746f6d616e2f7a6172652d6c61726176656c2d7065727369616e)](https://camo.githubusercontent.com/48db34f783d41c9660d518eb7311909f4735ce16ecf887bb23d646f33d15cdc0/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f4469676974616c746f6d616e2f7a6172652d6c61726176656c2d7065727369616e)[![Laravel](https://camo.githubusercontent.com/5266e8ebce3500ef5257b49eac09f79cce7bf59b2d24a498e29a9422c5f393f5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d382b2d4646324432303f6c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/5266e8ebce3500ef5257b49eac09f79cce7bf59b2d24a498e29a9422c5f393f5/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f4c61726176656c2d382b2d4646324432303f6c6f676f3d6c61726176656c266c6f676f436f6c6f723d7768697465)[![PHP](https://camo.githubusercontent.com/2d7a58d6202395e2b84e34e90c02dbedd618cd04d0a4fac8f9d353f9b86ce298/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e302b2d3737374242343f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)](https://camo.githubusercontent.com/2d7a58d6202395e2b84e34e90c02dbedd618cd04d0a4fac8f9d353f9b86ce298/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f5048502d382e302b2d3737374242343f6c6f676f3d706870266c6f676f436f6c6f723d7768697465)

> یک پکیج جامع و هوشمند برای **فارسی‌سازی کامل پروژه‌های لاراول** ✨
> A complete Laravel package for **Persian localization**, including **number conversion, Jalali date, validation, and more**.

---

✨ ویژگی‌ها | Features
---------------------

[](#-ویژگی‌ها--features)

ویژگی (Feature)توضیح (Description)وضعیت (Status)🔢 **تبدیل خودکار اعداد**Persian/English number auto conversion✅ فعال📅 **تاریخ شمسی (جلالی)**Full support for Jalali calendar✅ فعال✅ **اعتبارسنجی ایرانی**National code, Mobile, Postal Code validation✅ فعال🔤 **اعداد به حروف**Number-to-Words (Persian money & text)✅ فعال⚡ **نصب خودکار**Auto-registration (no manual config needed)✅ فعال🌐 **چندزبانه**Multi-language (Persian + English)✅ فعال---

🚀 نصب | Installation
--------------------

[](#-نصب--installation)

### روش ۱: Composer (توصیه‌شده) | Method 1: Composer (Recommended)

[](#روش-۱-composer-توصیه‌شده--method-1-composer-recommended)

```
composer require zare/laravel-persian
```

---

### روش ۲: نصب دستی | Method 2: Manual Installation

[](#روش-۲-نصب-دستی--method-2-manual-installation)

```
git clone https://github.com/Digitaltoman/zare-laravel-persian.git
```

---

### اضافه کردن به composer.json:

[](#اضافه-کردن-به-composerjson)

Add to your composer.json:

```
{
    "require": {
        "zare/laravel-persian": "*"
    }
}
```

---

⚙️ تنظیمات | Configuration
--------------------------

[](#️-تنظیمات--configuration)

انتشار فایل کانفیگ: Publish config file:

```
php artisan vendor:publish --provider="Zare\\LaravelPersian\\ZareServiceProvider" --tag="zare-persian-config"
```

فایل config/zare-persian.php شامل تنظیمات زیر است:

```
return [
    'enabled' => true,
    'auto_convert' => true,
    'locales' => ['fa', 'persian', 'فارسی'],

    'middleware' => [
        'normalize_input' => true,   // Convert Persian input → English
        'localize_output' => true,   // Convert English output → Persian
    ],

    'validation' => [
        'auto_register' => true,
    ],
];

```

---

📦 استفاده | Usage
-----------------

[](#-استفاده--usage)

### 1. تبدیل اعداد | Number Conversion

[](#1-تبدیل-اعداد--number-conversion)

```
use Zare\LaravelPersian\Support\Converter;

$persian = Converter::englishToPersian('1234567890'); // ۱۲۳۴۵۶۷۸۹۰
$english = Converter::persianToEnglish('۱۲۳۴۵۶۷۸۹۰'); // 1234567890

```

### 2. تاریخ شمسی | Jalali Dates

[](#2-تاریخ-شمسی--jalali-dates)

```
use Zare\LaravelPersian\Support\Jalali;

echo Jalali::toJalali(now(), 'Y/m/d'); // ۱۴۰۲/۱۰/۱۵
echo Jalali::fromJalali('1402/10/15'); // 2024-01-05

```

### 3. اعتبارسنجی ایرانی | Validation

[](#3-اعتبارسنجی-ایرانی--validation)

```
$request->validate([
    'mobile' => 'required|persian_mobile',
    'national_code' => 'required|national_code',
    'postal_code' => 'required|persian_postal_code',
]);

```

### 4. اعداد به حروف | Number To Words

[](#4-اعداد-به-حروف--number-to-words)

```
use Zare\LaravelPersian\Support\NumberToWords;

echo NumberToWords::toPersianWords(1250000);
// "یک میلیون و دویست و پنجاه هزار"

echo NumberToWords::toPersianMoney(1250000);
// "یک میلیون و دویست و پنجاه هزار تومان"

```

---

🖥️ استفاده در Blade | Blade Usage
---------------------------------

[](#️-استفاده-در-blade--blade-usage)

تعداد کاربران: {{ to\_persian\_numbers($userCount) }}

تاریخ امروز: {{ to\_jalali(now()) }}

مبلغ: {{ number\_to\_persian\_words($amount) }}

---

🤝 مشارکت | ---
--------------

[](#-مشارکت-----)

🤝 مشارکت (Contributing)
-----------------------

[](#-مشارکت-contributing)

اگر مایل به مشارکت هستید:

1. پروژه را Fork کنید
2. Branch جدید ایجاد کنید
3. Pull Request ارسال کنید

💖 اسپانسرها و حامیان (Sponsors & Supporters)
------------------------------------------------

[](#-اسپانسرها-و-حامیان-sponsors--supporters)

این پروژه با حمایت **[راه و چاره](https://rahochare.ir)** توسعه داده می‌شود.
اگر تمایل دارید اسپانسر شوید، لطفاً با ما تماس بگیرید.

📞 پشتیبانی (Support)
--------------------

[](#-پشتیبانی-support)

- 🌐 وبسایت: [rahochare.ir](https://rahochare.ir)
- 📧 ایمیل:
- 🐛 گزارش مشکلات: [Issues](../../issues)

---

###  Health Score

30

—

LowBetter than 64% of packages

Maintenance62

Regular maintenance activity

Popularity3

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity41

Maturing project, gaining track record

 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 ~10 days

Total

2

Last Release

234d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/db50f5a7fd2fe2fa4d509c27081dfba43d411f170f9e400ffe8e32d76fe59684?d=identicon)[Digitaltoman](/maintainers/Digitaltoman)

---

Top Contributors

[![Digitaltoman](https://avatars.githubusercontent.com/u/99523816?v=4)](https://github.com/Digitaltoman "Digitaltoman (33 commits)")

---

Tags

farsilaravellocalizationpersian-languagephp-package

### Embed Badge

![Health badge](/badges/zare-laravel-persian/health.svg)

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

###  Alternatives

[livewire/livewire

A front-end framework for Laravel.

23.5k75.5M1.8k](/packages/livewire-livewire)[laravel/mcp

Rapidly build MCP servers for your Laravel applications.

71510.9M66](/packages/laravel-mcp)[laravel-doctrine/orm

An integration library for Laravel and Doctrine ORM

8425.3M87](/packages/laravel-doctrine-orm)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[galahad/laravel-addressing

Laravel package providing addressing functionality

70316.6k](/packages/galahad-laravel-addressing)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)

PHPackages © 2026

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