README

为伊朗人设计的Laravel助手包

专为伊朗开发者设计的Laravel包

我总是有一系列代码，每次创建新项目时都会从头开始复制粘贴。后来我决定将其作为包发布，以便我们自己和同事可以方便地使用。现在，如果您认为这个包可以加快您的软件开发进程，那么您也可以使用它。如果您认为这个包缺少针对伊朗开发者的特定功能，请务必

分支并发出请求

😁。

功能

在Eloquent中存储和恢复波斯历日期
使用波斯历进行查询条件设置
用于修复阿拉伯文K和Y字母以及阿拉伯文和波斯数字的Midelier
生成波斯文slug的函数
手机号码和固定电话号码的验证器
包含城市和省份的伊朗数据库，以及路由绑定
根据卡号查找银行

安装
配置
存储和恢复波斯历日期
- 使用自定义属性
波斯历查询构建器
中间件
验证
工厂
省份和城市
- 路由绑定
slug
- 与Eloquent Sluggable包一起使用
根据卡号查找银行
由...

安装

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

composer require sanjabteam/baloot

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

php artisan vendor:publish --provider=Baloot\\BalootServiceProvider

配置

在文件

config/baloot.php

中，您可以更改配置。

geo: 如果您不想使用省份和城市功能，则将此部分的值设置为

false

以防止创建表。

存储和恢复波斯历日期

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

特质

Baloot\EloquentHelper

添加到您想添加的模型中。

use Baloot\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

有关更多信息，请参阅ورطا 文档。同时，通过设置日期也可以使用相同的方法。

$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 Baloot\EloquentHelper;

class User extends Model
{
    use EloquentHelper;

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

然后，您可以使用相同的方法访问它。

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

波斯历查询构建器

这些命令帮助您对date/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(); // همه کاربران به جز کاربران ایجاد شده در تاریخ مشخص

中间件

我在项目中遇到的一个问题是波斯数字。例如，有人在注册时用波斯数字输入密码，但在登录时用英文字母输入，然后中间说密码错误，其实不是这样。第二个问题是，比如管理员用波斯语输入一些内容，但网站上的用户使用阿拉伯语键盘和阿拉伯语的ك,ي搜索，然后在搜索时找不到东西，尽管实际上是有这些东西的。为了解决这个问题，只需要在文件

app/Http/Kernel.php

类中

\Baloot\Middleware\FixRequestInputs

将

middleware

数组添加进去

protected $middleware = [
    ...
    \Baloot\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(\Baloot\Database\CitiesTableSeeder::class); // سیدر شهر ها و استان ها
}

然后执行迁移后，运行种子。

php artisan migrate --seed

现在，您的城市和省份表格已填满，您可以使用以下两个模型来使用它们。

省份模型: Baloot\Models\Province

城市模型: Baloot\Models\City

示例

use Baloot\Models\City;

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

路由绑定

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

use Baloot\Models\Province;
use Baloot\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中，可以使用函数为地址生成slug，但如果向该函数提供波斯语，则会得到以下输出

Str::slug('test test')

输出

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")

"khonh-i-madrbzrgh"

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

类，类名根据此包进行。

peyman136 / baloot

维护者

详情

README

为伊朗人设计的Laravel助手包

安装

配置

存储和恢复波斯历日期

使用自定义属性

波斯历查询构建器

whereJalali

whereDateJalali

whereInMonthJalali

whereInYearJalali

whereBetweenJalali

中间件

验证

工厂

省份和城市

路由绑定

slug

与Eloquent Sluggable包一起使用

根据卡号查找银行

由...