README

为伊朗人提供的 Laravel 辅助包

功能

用于修复阿拉伯语字母 K 和 Y，以及阿拉伯语和波斯语数字的 Mid娄
提供波斯语 Slag 函数
在 Eloquent 中保存和检索农历日期
在查询中使用农历日期进行条件判断
验证手机号码和固定电话号码
验证身份证号码、银行卡和 IBAN 号码
验证伊朗邮政编码
包含伊朗城市和省份数据库，以及路由绑定
根据卡号查找银行

安装
配置
保存和检索农历日期
- 使用自定义属性
农历查询构建器
Mid娄
验证
思考
省份和城市
- 路由绑定
Slag
- 与 Eloquent Sluggable 包一起使用
根据卡号查找银行
由...

安装

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

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

农历查询构建器

这些命令可以帮助您在日期/日期时间类型的列上设置农历条件。

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(); // همه کاربران به جز کاربران ایجاد شده در تاریخ مشخص

Mid娄

项目中的一个常见问题是数字的波斯化。例如，用户在注册时使用波斯数字输入密码，然后在登录时使用英语数字输入密码，然后说密码错误。第二个问题是，例如管理员以波斯语 K 和 Y 输入内容，但网站用户使用阿拉伯语键盘以 ك,ي 阿拉伯语进行搜索，因此在搜索时找不到内容。要解决这个问题，只需在文件

app/Http/Kernel.php

类

\PBHelper\Middleware\FixRequestInputs

将中间件数组

添加到中间件

即可。

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

Slag

正如您所知，在Laravel中，可以使用函数为地址创建slug，但如果您向此函数提供波斯语，则它将尝试将其转换为英语，但此包的str_to_slug函数可以轻松管理波斯字母。

Str::slug('test test')

输出

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

"khonh-i-madrbzrgh"

然后使用此函数

输出

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

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

与 Eloquent Sluggable 包一起使用

只需在文件中添加

config/sluggable.php

部分

method

按照以下方式编写。

'method' => 'str_to_slug',

根据卡号查找银行

要使用卡号查找银行，请使用此函数。

find_bank_by_card_number("6037697531")