README

针对伊朗人的Laravel辅助包

功能

用于修复阿拉伯语K和Y字母、波斯语和阿拉伯语数字的Midelware
生成波斯语斯莱格（Slug）的函数
在Eloquent中存储和恢复波斯历日期
对波斯历查询进行条件设置
手机号码和固定电话号码验证器
身份证、银行卡和IBAN号码验证器
伊朗邮编验证器
伊朗城市和省份数据库以及路由绑定
根据卡号查找银行

安装
配置
存储和恢复波斯历日期
- 使用自定义属性
波斯历查询构建器
Midelware
验证
模型
省份和城市
- 路由绑定
斯莱格（Slug）
- 与Eloquent Sluggable包一起使用
根据卡号查找银行
制作

安装

您需要Laravel 6或更高版本才能安装此包。在您的Laravel项目中使用Composert安装此包。

composer require salamzadeh/pb-helper

然后，使用以下命令创建配置文件。

php artisan vendor:publish --provider=PBHelper\\PBHelperServiceProvider

配置

在文件中

config/pb-helper.php

您可以修改配置。

iran_province: 如果不希望使用省份和城市功能，请将此部分值设置为false，以避免创建相应的表格。

存储和恢复波斯历日期

此包允许您轻松地将Laravel模型中的日期转换为Verta类。要开始

特性

PBHelper\EloquentHelper

添加到您想添加的模型。

use PBHelper\EloquentHelper;

class User extends Model
{
    use EloquentHelper; // trait
}

之后，您可以轻松地以波斯历的形式访问属性。只需向所需字段添加后缀

_fa

即可。

$user = User::where(...)->first();
$user->created_at_fa // به صورت کلاس Hekmatinasser\Verta\Verta
$user->created_at_fa_f // 1390/1/1
$user->created_at_fa_ft // 1390/1/1 12:00
$user->created_at_fa_ftt // 1390/1/1 12:00:00
$user->updated_at_fa->format("%B %d %Y") // فروردین 01 1390

有关更好的管理，请参阅Verta文档。此外，通过设置日期也可以使用此方法。

$user->created_at_fa = Verta::createJalaliDate(1390, 1, 1);
dd($user->created_at); // Illuminate\Support\Carbon { date: 2011-03-21 }
$user->created_at_fa = "1392/1/1";
dd($user->created_at); // Illuminate\Support\Carbon { date: 2013-03-21 }
$user->created_at_fa = "1395/1/1 14:22:11";
dd($user->created_at); // Illuminate\Support\Carbon { date: 2016-03-20 14:22:11 }

使用自定义属性

如果您想有一个除

created_at, updated_at

以外的自定义字段，它支持此功能，只需将其转换为日期类型即可。

use PBHelper\EloquentHelper;

class User extends Model
{
    use EloquentHelper;

    protected $casts = [
        'birth_date' => 'date',
        // یا
        'released_at' => 'datetime'
    ];
}

然后您可以以相同的方式访问它。

$user->birth_date_fa; // Hekmatinasser\Verta\Verta

波斯历查询构建器

这些命令帮助您在波斯历日期/datetime类型的列上设置条件。

whereJalali

特定日期和时间的条件

User::whereJalali('created_at', '1399/01/15 14:00:00')->get();
// یا
User::whereJalali('created_at', Verta::createJalali(1399,01,15, 14, 0, 0))->get();
// شرط با عملگر
User::whereJalali('created_at', '>', '1399/01/15 14:00:00')->get();

whereDateJalali

特定日期的条件

User::whereDateJalali('created_at', '1399/01/15')->get();
// یا
User::whereDateJalali('created_at', Verta::createJalaliDate(1399,01,15))->get();
// شرط با عملگر
User::whereDateJalali('created_at', '>', '1399/01/15')->get();

whereInMonthJalali

特定年份中的特定月份的条件

User::whereInMonthJalali('created_at', 3)->get(); // فقط کاربران ایجاد شده در خرداد ماه سال جاری

User::whereInMonthJalali('created_at', 3, 1397)->get(); // فقط کاربران ایجاد شده در خرداد ماه سال 1397

whereInYearJalali

特定年份的条件

User::whereInYearJalali('created_at')->get(); // فقط کاربران ایجاد شده در سال جاری

User::whereInYearJalali('created_at', 1397)->get(); //فقط کاربران ایجاد شده در سال 1397

whereBetweenJalali

特定日期范围内的条件

User::whereBetweenJalali('created_at', ['1400/03/26 12:00:00', '1400/05/26 12:00:00'])->get(); // فقط کاربران ایجاد شده بین دو تاریخ مشخص شده
// یا
User::whereBetweenJalali('created_at', [Verta::createJalali(1400,01,15, 14, 0, 0), Verta::createJalali(1399,01,15, 14, 0, 0)])->get(); 
// شرط با Not
User::whereNotBetweenJalali('created_at', ['1400/03/26 12:00:00', '1400/05/26 12:00:00'])->get(); // همه کاربران به جز کاربران ایجاد شده در تاریخ مشخص

Midelware

在项目中遇到的一个问题是阿拉伯数字。例如，用户在注册时使用阿拉伯数字设置密码，然后在登录时使用英语数字设置，结果密码错误。第二个问题是，管理员用K和Y输入内容，但用户使用阿拉伯语键盘和ک,ي进行搜索，结果在搜索中找不到内容。要解决这个问题，只需在文件中进行更改

app/Http/Kernel.php

将类

\PBHelper\Middleware\FixRequestInputs

添加到数组

middleware

即可。

protected $middleware = [
    ...
    \PBHelper\Middleware\FixRequestInputs::class,
];

这样，您就可以永远告别波斯数字和阿拉伯字母的问题了。

验证

iran_phone: 用于输入伊朗固定电话号码

iran_mobile: 用于验证伊朗手机号码

如果需要接受不带零的电话号码，请按照以下格式输入：iran_mobile:true。否则，如果没有输入零，号码将不会被验证。

用于

public function test(Request $request)
{
    $request->validate([
        'mobile1' => 'required|iran_mobile',
        'phone' => 'required|iran_phone',
        'mobile2' => 'required|iran_mobile:true', // وارد کردن صفر در اول شماره اختیاری
    ]);
}

这部分需要改进

iran_national_code: 身份证验证码

模型

已经实施了一些改进，例如段落已进行波斯语化。

CustomImage

customImage($path, $width, $height, $prefix)

这个图像来自网站

https://picsum.photos

为您提供。

$path: 存储文件夹 $width: 图片宽度 $height: 图片高度 $prefix: 默认只提供图片名称，您可以使用这个来添加一个前缀到图片名称

示例

'image' => $faker->customImage(public_path('uploads/fake'), 640, 480, 'fake/')

如果您需要一个图片数组

$faker->customImages(public_path('uploads/fake'), 640, 480, $faker->numberBetween(1, 3), 'fake/')

第四个参数将接收您需要的图片数量。

iranMobile

为您生成一个伊朗手机号码

$faker->iranMobile

iranPhone

为您生成一个伊朗固定电话号码

$faker->iranPhone

省份和城市

为了开始，在

DatabaseSeeder.php

添加以下部分。

public function run()
{
    $this->call(\PBHelper\Database\CitiesTableSeeder::class); // سیدر شهر ها و استان ها
}

然后在迁移后执行种子。

php artisan migrate --seed

现在您的城市和省份表格已填充，您可以使用以下两个模型进行使用。

省份模型: PBHelper\Models\Province

城市模型: PBHelper\Models\City

示例

use PBHelper\Models\City;

City::where('name', 'آمل')->first()

路由绑定

如果您想在地址中使用省份和城市，请使用此方法。

use PBHelper\Models\Province;
use PBHelper\Models\City;

Route::get('test/{province}/{city}', function (Province $province, City $city) {
    abort_if($city->province_id != $province->id, 404);
    // ...
});

然后打开以下地址。

/test/27/1068

现在您可以访问省份和城市。

如果您想使您的地址

SEO友好

可以使用

slug

在省份和城市中使用。这些slug是由

Eloquent Sluggable

生成的。因此，以这种方式打开地址。

/test/مازندران/آمل.

如果只想用ID打开，或者只想用slug，或者两种都不接受，那么在这种情况下，请使用以下代替

province, city

使用。

city_by_id: 通过ID获取城市

city_by_slug: 通过slug获取城市

province_by_id: 通过ID获取省份

province_by_slug: 通过slug获取省份

省份: Province

城市: City

斯莱格（Slug）

正如您所知，在Laravel中，可以使用函数

Str::slug('test test')

创建一个用于地址的slug，但如果将波斯语传递给此函数

Str::slug('خونه ی مادربزرگه')

输出

"khonh-i-madrbzrgh"

它试图将其转换为英文，但使用此包中的 str_to_slug 函数可以轻松管理波斯字母

str_to_slug('خونه ی مادربزرگه')

"خونه-ی-مادربزرگه"

与Eloquent Sluggable包一起使用

只需在文件中更改

config/sluggable.php

部分

method

如下所示。

'method' => 'str_to_slug',

根据卡号查找银行

使用此函数通过卡号查找银行。

find_bank_by_card_number("6037697531")

输出

[
    "class" => "bsi",
    "name" => "بانک صادرات ایران",
    "card_prefix" => "603769",
]

类，类名基于此包。

سalamzadeh / pb-helper

维护者

详细信息