Laravel的持续设置包
此软件包允许您以更持久的方式保存设置。您可以使用数据库和/或JSON文件来保存设置。您还可以覆盖Laravel配置。
- 驾驶员支持
- 辅助功能
- 刀片指令
- 覆盖配置值
- 加密
- 自定义文件,表和列
- 自动保存
- 额外的列
- 缓存支持
入门
1。安装
运行以下命令:
composer require akaunting/laravel-setting
2。注册(laravel <5.5)
在config/app.php中注册服务提供商
Akaunting \\ Setting \\Provider::class,
如果要使用立面,请添加别名。
\' Setting \' => Akaunting \\ Setting \\Facade::class,
3。发布
发布配置文件。
php artisan vendor:publish --tag=setting
4。数据库
为数据库驱动程序创建表
php artisan migrate
5。配置
您可以从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
- 所有贡献者
执照
麻省理工学院许可证(麻省理工学院)。请参阅许可证以获取更多信息。
