README

MANTOOQ 阿拉伯数字拼写

涵盖所有关于 Laravel 的阿拉伯数字爱好者所需的功能，如数字发音、金额、反向转换、阿拉伯数字显示及转换

适用于所有 Laravel 版本的安装 🥳

1- 您可以通过 composer 安装此包

composer require zain4picker/mantooq

2- 您必须在您的 config/app.php 文件中注册服务提供者

'providers' => [
    // ...
    Picker\ArabicNumbers\ArabicNumbersServiceProvider::class,
];

3- 您必须在您的 App\Http\Kernel 文件中注册中间件

protected $middleware = [
    // ...
    Picker\ArabicNumbers\Http\Middleware\ConvertArabicDigitsToEnlishMiddleware::class
];

现在，任何包含阿拉伯指示符 [١،٢،٣،٤،٥،٦،٧،٨،٩،٠] 的请求都将自动转换为 [1,2,3,4,5,6,7,8,9,0] 🥳

排除字段

如果您想排除任何字段从转换请求，只需在中间件 ConvertArabicDigitsToEnlishMiddleware::class 中添加您想要排除的字段即可

        /**
         * The fields that should not be Transformed.
         *
         * @var array
         */
        protected $except = [
            'password', 'password_confirmation' ,'numbers','count'
        ];

使用方法

阿拉伯语中标准的金额读法，如 123 => { مئة و ثلاثة و عشرون ريالًا فقط لا غير }

您可以直接在阿拉伯语中获取整数金额的 Mantooq

    use Picker\ArabicNumbers\Numbers;

    $number = 64.56;
    Numbers::MantooqMoney($number); //It will Give SAR by default

    // RESULT {  أربعة و ستون ريالًا و ست و خمسون هللة فقط لا غير }


    [OR]


    $value = 64.56;
    Numbers::MantooqMoney($value,'EGP'); //You can pass $currency as the second @param

    // RESULT {  أربعة و ستون جنيهًا و ست و خمسون قرش فقط لا غير }

阿拉伯语中数字的标准读法，如 64 => { أربعة و ستون }

您可以直接在阿拉伯语中获取整数的 Mantooq

    use Picker\ArabicNumbers\Numbers;

    $number = 64;
    Numbers::MantooqNumber($number);

    // RESULT {  أربعة و ستون }

从阿拉伯语读法中提取数字（不是金额）😉 例如 { أربعة و ستون } => 64

您可以简单地反向阿拉伯语读法以直接获取整数

    use Picker\ArabicNumbers\Numbers;

    $string = "أربع و ستون فاصلة ست و خمسون";
    Numbers::NumberFromString($number);

    // RESULT 64.56

根据用户需求显示阿拉伯数字或英语数字，例如 657 => ٦٥٧

您可以选择以阿拉伯数字或英语数字显示任何值

    use Picker\ArabicNumbers\Numbers;

    $number = 64; // integar value
    Numbers::ShowInArabicDigits($number);

    // RESULT "٦٤.٥٦"


    [OR]


    use Picker\ArabicNumbers\Numbers;

    $value = "٦٤.٥٦"; // Can be Any Value STRING or INTEGAR
    Numbers::ShowInEnglishDigits($value);

    // RESULT "64.56"


    [EVEN 🥳 Any Value]


    use Picker\ArabicNumbers\Numbers;

    $value = "تاريخ اليوم : 22-10-2020"; // Can be Any Mix Value STRING with INTEGAR
    Numbers::ShowInArabicDigits($value);

    // RESULT {تاريخ اليوم : ٢٢-١٠-٢٠٢٠}