laravel setting

Delphi源码 2025-08-08

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
  • 所有贡献者

执照

麻省理工学院许可证(麻省理工学院)。请参阅许可证以获取更多信息。

下载源码

通过命令行克隆项目:

git clone https://github.com/akaunting/laravel-setting.git