zare/laravel-persian

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

Maintainers

Details

github.com/Digitaltoman/zare-laravel-persian

Source

Issues

Installs: 3

Dependents: 0

Suggesters: 0

Security: 0

Stars: 0

Watchers: 0

Forks: 0

Open Issues: 0

pkg:composer/zare/laravel-persian

V1.0.1 2025-09-20 10:25 UTC

Requires

MIT d05768df7f04c00d716810caeacc015a31510f27

  • Zare <in66zare.woop@gmail.com>

This package is auto-updated.

Last update: 2025-12-20 11:04:47 UTC

README

GitHub release GitHub issues GitHub license Laravel PHP

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

✨ ویژگی‌ها | 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

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

composer require zare/laravel-persian

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

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

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

Add to your composer.json:

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

⚙️ تنظیمات | 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

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

use Zare\LaravelPersian\Support\Converter;

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

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

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

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

use Zare\LaravelPersian\Support\NumberToWords;

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

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

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

تعداد کاربران: {{ to_persian_numbers($userCount) }}

تاریخ امروز: {{ to_jalali(now()) }}

مبلغ: {{ number_to_persian_words($amount) }}

🤝 مشارکت | ---

🤝 مشارکت (Contributing)

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

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

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

این پروژه با حمایت راه و چاره توسعه داده می‌شود.
اگر تمایل دارید اسپانسر شوید، لطفاً با ما تماس بگیرید.

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