money wrapper

غلاف MoneyPHP

قاعدة على غلاف المال

هذا غلاف للمال.

هذا المجمع:

1. توفير مساعد مالي - money()
2. مخصص لـ Laravel Framework، ولكن يمكن استخدامه خارج Laravel Framework أيضًا.
3. توفير الاستخدام الشائع مثل:

• لسهولة القراءة البشرية - 1.00 رينجيت ماليزي، 345.00 رينجيت ماليزي
• للعرض المشترك - 1.00، 345.00
• للجهاز (التنسيق المقصود للتخزين في قاعدة البيانات - عدد صحيح) - 100، 34500
• تحويل سعر الصرف الثابت - 1 دولار > 3.87 رينجيت ماليزي

تثبيت

1. من أجل تثبيت wujunze/money-wrapper في مشروع Laravel الخاص بك، ما عليك سوى تشغيل الأمر Composer require من جهازك الطرفي:

 $ composer require wujunze/money-wrapper

2. ثم في config/app.php الخاص بك أضف ما يلي إلى مصفوفة الموفرين:

 wujunze  MoneyWrapper MoneyWrapperServiceProvider::class,

3. في نفس config/app.php أضف ما يلي إلى مصفوفة الأسماء المستعارة:

 ' MoneyWrapper ' => wujunze  MoneyWrapper MoneyWrapperFacade::class,

4. نشر تكوين money wrapper :

 $ php artisan vendor:publish --tag=money-wrapper-config

قد ترغب في إضافة المزيد من تفاصيل العملة بناءً على البلد. راجع قسم المساهمات أدناه للحصول على التفاصيل.

الاستخدام

الحصول على money wrapper

بشكل افتراضي، سيتم استخدام عملة رينغيت ماليزيا MYR.

يمكنك التجاوز إما عن طريق ملف .env أو تمرير رمز البلد Alpha 2 عند الاتصال بمساعد money() .

 $ money = money (); // by default it will use MY
$ moneyUsd = money ( ' US ' ); // pass the country code - ISO Alpha 2

يمكنك إضافة المزيد من العملات بعد نشر ملف تكوين money wrapper وإضافة المزيد من العملات المدعومة.

يرجى الرجوع إلى رمز البلد ورمز العملة السريع والرمز في قائمة العملات.

الحصول على تنسيق المال

 echo money ()-> toHuman ( 100 ); // RM 1.00, useful for human readability
echo money ()-> toCommon ( 100 ); // 1.00
echo money ()-> toMachine ( ' 1.00 ' ); // 100, always store in database as integer. 

تحويل السعر الثابت

 $ fixedExchange = [
    ' MYR ' => [
        ' USD ' => 3.87 ,
    ],
];
echo money ()-> convertFixedRate ( $ fixedExchange , 100 , ' USD ' )-> getAmount (); // 387

نوع البيانات الموصى به المستخدم في قاعدة البيانات هو عدد صحيح كبير

المساهمات

تحديث قائمة العملات ( config/currency.php ) المتوفرة بناءً على المصادر التالية:

1. استخدم رمز البلد ISO Alpha 2 للمفتاح كما هو محدد في قائمة البلدان.
2. الرجوع إلى قائمة العملات للعملة المتاحة.
3. استخدم الرمز كما هو مذكور في www.xe.com.

وسيكون الهيكل على النحو التالي:

[
	' MYR ' => [
		' swift_code ' => ' MYR ' ,
		' symbol ' => ' RM '
	]
]

رخصة

هذه الحزمة عبارة عن برامج مفتوحة المصدر مرخصة بموجب ترخيص MIT.