Laravel的持续设置包
此软件包允许您以更持久的方式保存设置。您可以使用数据库和/或JSON文件来保存设置。您还可以覆盖Laravel配置。
- 驾驶员支持
- 辅助功能
- 刀片指令
- 覆盖配置值
- 加密
- 自定义文件,表和列
- 自动保存
- 额外的列
- 缓存支持
入门
1。安装
运行以下命令:
composer require akaunting/laravel-setting2。注册(laravel <5.5)
在config/app.php中注册服务提供商
Akaunting \ Setting \Provider::class,如果要使用立面,请添加别名。
' Setting ' => Akaunting \ Setting \Facade::class,3。发布
发布配置文件。
php artisan vendor:publish --tag=setting4。数据库
为数据库驱动程序创建表
php artisan migrate5。配置
您可以从config/setting.php文件更改应用程序的选项
用法
您可以使用辅助方法(例如setting('foo')或立面Setting::get('foo')
正面
Setting:: get ( ' foo ' , ' default ' );
Setting:: get ( ' nested.element ' );
Setting:: set ( ' foo ' , ' bar ' );
Setting:: forget ( ' foo ' );
$ settings = Setting:: all ();帮手
setting ( ' foo ' , ' default ' );
setting ( ' nested.element ' );
setting ([ ' foo ' => ' bar ' ]);
setting ()-> forget ( ' foo ' );
$ settings = setting ()-> all ();您可以调用save()方法来保存更改。
自动保存
如果在配置文件中启用auto_save选项,则在应用程序已更改时,每次应用程序都会自动保存设置。
刀片指令
您可以使用辅助方法或blade指令(例如@setting('foo')可以直接在刀片模板中获取设置
覆盖配置值
您可以通过将其添加到config/setting.php中的override选项中来轻松覆盖默认配置值,从而消除了修改默认配置文件的需求,并允许您在生产过程中更改上述值。前任:
' override ' => [
" app.name " => " app_name " ,
" app.env " => " app_env " ,
" mail.driver " => " app_mail_driver " ,
" mail.host " => " app_mail_host " ,
],左侧的值对应于相应的配置值(ex:config('app.name')),右侧的值是设置表/json文件中key的名称。
加密
如果您想加密给定键的值,则可以将键传递到config/setting.php中的encrypted_keys选项,其余的是使用Laravel的内置加密设施自动处理的。前任:
' encrypted_keys ' => [
" payment.key " ,
],JSON存储
您可以使用setting()->setPath($path)修改运行时使用的路径。
数据库存储
如果要使用数据库作为设置存储,则应运行php artisan migrate 。您可以在迁移目录中的create_settings_table文件中修改表字段。
额外的列
如果要在同一数据库中为多个用户/客户端存储设置,则可以通过指定额外的列来完成:
setting ()-> setExtraColumns ([ ' user_id ' => Auth:: user ()-> id ]);现在,当检索设置时, user_id = x现在将添加到数据库查询中,并且在保存新设置时,将填充user_id 。
如果您需要对哪些数据进行查询的更多微调控制,则可以使用setConstraint方法,该方法封闭了两个参数:
-
$query是查询构建器实例 $insert是一个布尔值,告诉您查询是否是插入物。如果是插入物,则通常不需要对$query做任何事情。
setting ()-> setConstraint ( function ( $ query , $ insert ) {
if ( $ insert ) return ;
$ query -> where ( /* ... */ );
});自定义驱动程序
该软件包使用引擎盖下的Laravel Manager类,因此很容易添加您自己的存储驱动程序。您需要做的就是扩展抽象Driver类,实现抽象方法并调用setting()->extend 。
class MyDriver extends Akaunting \ Setting \ Contracts \Driver
{
// ...
}
app ( ' setting.manager ' )-> extend ( ' mydriver ' , function ( $ app ) {
return $ app -> make ( ' MyDriver ' );
});ChangElog
有关更多信息,请参阅发行版,最近发生了什么变化。
贡献
拉力请求非常欢迎。您必须遵循PSR编码标准。
安全
如果发现任何与安全有关的问题,请发送电子邮件至security@akaunting.com,而不是使用问题跟踪器。
学分
- DenisDuliçi
- 所有贡献者
执照
麻省理工学院许可证(麻省理工学院)。请参阅许可证以获取更多信息。
通过命令行克隆项目: