README

这是一个为伊朗人设计的 Laravel 助手包

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

我以前有一系列代码，每次创建新项目时都从零开始复制粘贴。后来我决定将其打包成一个包，这样我就可以和我同事轻松使用。现在如果你认为这个包能加快你的软件开发流程，你也可以使用它。如果你认为这个包缺少一些对伊朗开发者特别有用但尚未包含的功能，请务必

创建一个分支和 pull request

😁.

功能

在 Vueqnt 中保存和恢复农历日期
基于农历查询的条件判断
用于修复阿拉伯文和波斯文字母以及阿拉伯文和波斯文数字的 Medilware
生成波斯文缩略词的函数
验证手机号码和固定电话号码
包含伊朗城市和省份的数据库，附带路由绑定
根据卡号查找银行

安装
配置
保存和恢复农历日期
- 使用自定义属性
农历查询构建器
Medilware
验证
工厂
省份和城市
- 路由绑定
缩略词
- 与 Eloquent Sluggable 包一起使用
根据卡号查找银行
由

安装

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

composer require sanjabteam/baloot

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

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

配置

在文件中

config/baloot.php

您可以更改配置。

geo：如果您不想使用省份和城市功能，请将此部分设置为

false

以防止创建相关表。

保存和恢复农历日期

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

特派团

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

有关更多信息，请参阅 Verta 的[文档](https://github.com/hekmatinasser/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 Baloot\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(); // همه کاربران به جز کاربران ایجاد شده در تاریخ مشخص

Medilware

在项目中遇到的一个问题是波斯数字。例如，有人在注册时用波斯数字设置密码，但在登录时却用英文数字，然后说密码错误，但实际上并不是这样。第二个问题是，例如管理员输入了一些包含波斯语字母的字符，但一个用户在使用阿拉伯语键盘搜索时使用阿拉伯语字母和ک,ي，在搜索时找不到任何东西，尽管实际上是可以找到的。为了解决这个问题，只需在文件

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

缩略词

正如您所知，在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")