PHPackages                             adnane/laravel-speaks-arabic - 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. adnane/laravel-speaks-arabic

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

adnane/laravel-speaks-arabic
============================

a light weight ,open-source laravel package . It facilitates dealing with arabic concepts in Laravel Framework using a set of classes and methods to make laravel speaks arabic!

1.0.3(5y ago)5547315MITPHP

Since Mar 24Pushed 4y ago1 watchersCompare

[ Source](https://github.com/adnane-ka/laravel-speaks-arabic)[ Packagist](https://packagist.org/packages/adnane/laravel-speaks-arabic)[ RSS](/packages/adnane-laravel-speaks-arabic/feed)WikiDiscussions main Synced 1w ago

READMEChangelog (3)DependenciesVersions (4)Used By (0)

لارافيل يتحدث العربي - Laravel Speaks Arabic
--------------------------------------------

[](#لارافيل-يتحدث-العربي---laravel-speaks-arabic)

[![Latest Version on Packagist](https://camo.githubusercontent.com/cfc1014fba00c752c69099226758a20ef99bffc67ee0e0729b86e9d258c63c95/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f61646e616e652f6c61726176656c2d737065616b732d6172616269632e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/adnane/laravel-speaks-arabic)[![MIT Licensed](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](LICENSE.md)[![Total Downloads](https://camo.githubusercontent.com/e49830148efdf4d12ea73dcb277f616e50be6e896067c736fbd0805578e52af0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f61646e616e652f6c61726176656c2d737065616b732d6172616269632e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/adnane/laravel-speaks-arabic)

**حزمة خفيفة الوزن تسهل التعامل مع المفاهيم العربية في لارافيل، بإستخدام مجموعة من الفئات، الأساليب والتوابع لجعل لارافل يتحدث العربي! مفاهيم من مثل السلاسل النصية العربي والتواريخ الهجرية وغيرها**

**مثال**

```
@toWords(12078437);
// اثنا عشر مليون و ثمان و سبعون ألف و أربع مئة و سبع و ثلاثون
```

التثبيت
-------

[](#التثبيت)

1. التثبيت عن طريق مدير الحزم composer

```
composer require adnane/laravel-speaks-arabic

```

2. قم بإضافة مزود خدمة الحزمة الى مصفوفة providers في ملف `config\app.php` كالتالي:

```
'providers' => [
    Adnane\Arabic\ArabicServiceProvider::class,
]
```

كيفية الاستعمال
---------------

[](#كيفية-الاستعمال)

- بعد التأكد من تثبيت الحزمة على نحو صحيح، سيمكنك تضمين الفئة الرئيسية `Adnane\Arabic\Arabic` واستعمال توابعها بشكل عادي

> قم بتغيير `method` إلى التابع المراد كـ: `Arabic::toWords(643646)` أو كـ: `arabic()->toWords(643646)`

```
use Adnane\Arabic\Arabic;
Arabic::method($params)

// او مباشرة عن طريق الدالة المساعدة
arabic()::method($params)
```

التوابع المتوفرة
----------------

[](#التوابع-المتوفرة)

**1.التعامل مع الأعداد**

```
/**
 * اعادة كتابة الاعداد كتابة لفظية انطلاقا من كتابة رمزية
 * يسمى أيضا "تفقيط"
 *
 * @return string
*/
Arabic::toWords(int $integer)

/**
 * اعادة كتابة الاعداد كتابة رمزية انطلاقا من كتابة لفظية
 * هو عكس العملية السابقة
 *
 * @return int
*/
Arabic::fromWords(string $str)

/**
 * جلب العدد الترتيبي انطلاقا من كتابة رمزية لعدد ما
 * مثال: أول، ثان، ثالث
 *
 * @return string
*/
Arabic::toOrdinal(int $int)

/**
 * اعادة كتابة الارقام الموجودة في سلسلة نصية ما
 * كأرقام هندية (۰ - ۱ - ۲ - ۳ - ٤ - ٥ - ٦ - ٧ - ۸ - ۹)
 *
 * @return string
*/
Arabic::toIndianNums(string $str)
```

**2.التعامل مع التواريخ والتواقيت**

```
/**
 * تحويل تاريخ مكتوب بالتقويم الميلادي
 * الى تاريخ مكتوب بالتقويم الهجري
 * مكتوبا بصيغة معينة
 *
 * (الصيغ المدعومة : f , s , n )
 * @return string
*/
Arabic::toHijri(string $format = 'f' ,string $date)

/**
 * تحويل تاريخ مكتوب بالتقوم الهجري
 * الى تاريخ مكتوب بالتقويم الميلادي
 *
 * @return string
*/
Arabic::fromHijri(string $date /*Y/m/d*/);

/**
 * جلب فرق التوقيت بين وقتين او تاريخين.
 * تمرير المعامل details بالقيمة true
 * سيقوم باعادة فرق تفصيلي بين هاذين التوقيتين
 *
 * @return string
*/
Arabic::toRelative(string $date ,string $date2 = null ,boolean $detailed = false);

/**
 * جلب توقيت ما انطلاقا من فرق مرفق
 * مثال:
 * Arabic::fromRelative('زد سنة')
 * @return string
*/
Arabic::fromRelative(string $relative);
```

**3. التعامل مع السلاسل النصية**

```
/**
 * ازالة التشكيل من سلسلة نصية ما
 *
 * @return string
*/
Arabic::removeHarakat(string $str)

/**
 * اعادة كتابة سلسلة نصية ما مكتوبة باللغة الانجليزية
 * الى المرافق لها بلوحة مفاتيح عربية
 * يمكن استعمال هاته الوظيفة في تحسين عمليات البحث داخل الموقع
 *
 * @return string
*/
Arabic::toKeyboardInput(string $str)

/**
 * اعادة كتابة سلسلة نصية عربية ما
 * بحروف انجليزية
 * يمكن استعمال هاته الوظيفة في انشاء روابط صديقة البحث
 * @return string
*/
Arabic::toSpelled(string $str)

/**
 * المكافئ للدالة str_word_count في PHP
 * من المهم جدا ملاحظة ان دالة ال PHP
 * str_word_count
 * لا تدعم اللغى العربية
 * ولذلك ان هاته الوظيفة تعتبرا بديلا عنها في اللغة العريبة
 * @return int
*/
Arabic::countWords(string $str);

/**
 * التحقق من ما ان كانت سلسلة نصية ما تحوي على الأقل حرفا عربيا واحدا
 * @return boolean
*/
Arabic::containsAr(string $str);
```

أمثلة عن عدة استعمالات
----------------------

[](#أمثلة-عن-عدة-استعمالات)

```
Arabic::toWords(56)
//  ست وخمسون

Arabic::fromWords("ثمان مئة و خمسة")
//  805

Arabic::toOrdinal(12)
//  الثاني عشر

Arabic::toIndianNums("ولد عليه الصلاة في 12 ربيع الأول")
//  ولد عليه الصلاة في ۱۲ ربيع الاول

Arabic::toHijri('f' ,'2021/12/12')
//  الثامن من جمادى الأولى من السنة الهجرية ألف و أربع مئة و ثلاث و أربعون

Arabic::fromHijri('1442/01/08')
// 8/27/2020

Arabic::toRelative('2010/01/10')
//  منذ أحد عشر سنة

Arabic::toRelative('2010/01/10' ,'2008/01/10')
//  ثلاث سنين

Arabic::toRelative('2010/01/10' ,'2008/01/10' ,true)
// [ "y" => 3 , "m" => 39 ,"w" => 156 , "d" => 1096 ,"h" => 26304 ,"mn" => 1578240 ,"s" => 94694400 ]

Arabic::fromRelative('زد سنة')
// 2022/03/28

Arabic::fromRelative('قل ست اشهر')
//  2020/09/28

Arabic::removeHarakat('لا حسَدَ إلَّا في اثنتيْنِ: رجلٌ آتاهُ اللهُ مالًا، فسلَّطَهُ على هلَكتِه في الحقِّ، ورجلٌ آتاهُ اللهُ الحِكمةَ، فهوَ يقضِي بِها، ويُعلِّمُها')
//  لا حسد إلا في اثنتين: رجل آتاه الله مالا، فسلطه على هلكته في الحق، ورجل آتاه الله الحكمة، فهو يقضي بها، ويعلمها

Arabic::toKeyboardInput('dl;k hsjulhg ihji hg]hgm td jpsdk ulgdhj hgfpe fl,ru!')
// يمكن استعمال هاته الدالة في تحسين عمليات البحث بموقع!

Arabic::toSpelled("قد تساعد هاته الدالة في عمل slugs أو تحسين عمليات البحث")
// qd tsaaad haath āldaalt fii aml slugs āoo thsiin amliiāt ālbhth

Arabic::countWords("هاته الدالة هي المكافئة لاخرى بالبي اتش بي غير ان هاته لا تتجاهل ترميز اليو تي اف ايت")
// 18

Arabic::containsAr("this method checks if a given string contains arabic words or charachters , for example : if we mentioned لارفيل يتحدث عربي it will return true!")
// true
```

الاستعمال في ملفات blade
------------------------

[](#الاستعمال-في-ملفات-blade)

> قم بتغيير `method` إلى التابع المراد كـ: `Arabic::toWords(643646)` أو كـ: `arabic()->toWords(643646)`

```
{{ Arabic::method($input) }}

// أو

{{ arabic()->method($input) }}
```

كما سيمكنك استعمال متغيرات القالب التالية لشيفرة أنظف

```
@toWords(4367)
@toOrdinal(564)
@toIndianNums(ولد عليه الصلاة في 12 ربيع الأول)
@toHijri(2020/12/12)
@toRelative(2019/12/01)
@removeHarakat(فهوَ يقضِي بِها، ويُعلِّمُها)
```

المساهمة
--------

[](#المساهمة)

**لا تتردد في المساهمة أو مساعدتنا في جعل Laravel يتحدث اللغة العربية بشكل أفضل من خلال فتح مناقشة أو إضافة بعض الطرق الإضافية أو إصلاح خطأ أو المساعدة في تحسين بعض الأساليب!**

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity28

Limited adoption so far

Community13

Small or concentrated contributor base

Maturity54

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 92.5% 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 ~23 days

Total

3

Last Release

1834d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/32fd3105946c7423fd448a5030df5993ae5ceca855de748881f30d5a17928cb3?d=identicon)[adnanekadri](/maintainers/adnanekadri)

---

Top Contributors

[![adnane-ka](https://avatars.githubusercontent.com/u/74255401?v=4)](https://github.com/adnane-ka "adnane-ka (37 commits)")[![muath-ye](https://avatars.githubusercontent.com/u/34031333?v=4)](https://github.com/muath-ye "muath-ye (3 commits)")

---

Tags

arabic-conceptsarabic-numbershijri-dateslaravel-framework

### Embed Badge

![Health badge](/badges/adnane-laravel-speaks-arabic/health.svg)

```
[![Health](https://phpackages.com/badges/adnane-laravel-speaks-arabic/health.svg)](https://phpackages.com/packages/adnane-laravel-speaks-arabic)
```

###  Alternatives

[joedixon/laravel-translation

A tool for managing all of your Laravel translations

717911.4k11](/packages/joedixon-laravel-translation)[illuminate/translation

The Illuminate Translation package.

6936.4M495](/packages/illuminate-translation)[lajax/yii2-translate-manager

Translation management extension for Yii 2

227578.8k13](/packages/lajax-yii2-translate-manager)[larswiegers/laravel-translations-checker

Make sure your laravel translations are checked and are included in all languages.

256423.2k2](/packages/larswiegers-laravel-translations-checker)[inpsyde/multilingual-press

Simply THE multisite-based free open source plugin for your multilingual websites.

2414.0k1](/packages/inpsyde-multilingual-press)[statikbe/laravel-chained-translator

The Laravel Chained Translator can combine several translators that can override each others translations.

36149.4k6](/packages/statikbe-laravel-chained-translator)

PHPackages © 2026

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