cleaniquecoders / laravel-observers
一个可以用于Laravel应用程序的观察者类集合。
Requires
- php: ^8.1 | ^8.2 | ^8.3
- cleaniquecoders/laravel-helper: ^4.0
- hashids/hashids: ^4.0
- illuminate/support: ^9.0 | ^10.0 | ^11.0
Requires (Dev)
- laravel/pint: ^1.0
- mockery/mockery: ^1.1
- orchestra/testbench: 8.*
- pestphp/pest: ^2.0
- phpunit/phpunit: ^9.0 | ^10.0 | ^11.0
README
关于您的包
一个可以用于Laravel应用程序的观察者类集合。
安装
- 为了在您的Laravel项目中安装
cleaniquecoders/laravel-observers
,只需从您的终端运行composer require命令
$ composer require cleaniquecoders/laravel-observers
- 然后在您的
config/app.php
中将以下内容添加到提供者数组中
CleaniqueCoders\LaravelObservers\LaravelObserversServiceProvider::class,
- 在同一个
config/app.php
中将以下内容添加到别名数组中
'LaravelObservers' => CleaniqueCoders\LaravelObservers\LaravelObserversFacade::class,
使用方法
简单地将配置文件发布
$ php artisan vendor:publish --tag=laravel-observers
然后在config/observers.php
中打开并注册您想为其添加观察者的模型。
请注意,对每个观察者进行检查,以便了解使用它们的要求。
Hashid观察者
请确保您的模型表具有hashslug
列。您可以在迁移中使用Blueprint宏 - $table->hashslug(config('hashids.length'))
- 或者使用以下内容
$this->string('hashslug') ->length(config('hashids.length')) ->nullable() ->unique() ->index();
参考观察者
请确保您的模型表具有hashslug
列。您可以在迁移中使用Blueprint宏 - $table->reference()
- 或者使用以下内容
如果您使用Blueprint宏,可以通过传递第一个和第二个参数到宏来重写标签和长度
$table->reference('reference_no', 128);
默认情况下,长度为64
,使用的标签为reference
。
$table->string('reference', config('document.length')) ->nullable() ->unique() ->index();
测试
要运行测试,请在您的终端中输入vendor/bin/phpunit
。
要获取代码覆盖率,请确保安装PHP XDebug,然后运行以下命令
$ vendor/bin/phpunit -v --coverage-text --colors=never --stderr
贡献
感谢您考虑为cleaniquecoders/laravel-observers
做出贡献!
错误报告
为了鼓励积极的协作,强烈建议提交拉取请求,而不仅仅是错误报告。"错误报告"也可以以包含失败测试的拉取请求的形式发送。
但是,如果您提交错误报告,您的问题应包含标题和问题描述。您还应该包括尽可能多的相关信息和演示问题的代码示例。错误报告的目的是使您和他人能够轻松地复制错误并开发解决方案。
请记住,错误报告是希望有相同问题的其他人能够与您合作解决它而创建的。不要期望错误报告会自动看到任何活动或其他人会跳出来修复它。创建错误报告的目的是帮助您和他人开始解决问题的过程。
编码风格
cleaniquecoders/laravel-observers
遵循PSR-2编码标准和PSR-4自动加载标准。
您可以使用PHP CS Fixer来保持标准一致。PHP CS Fixer配置可以在.php_cs
中找到。
许可证
此软件包是开源软件,根据MIT许可证许可。