PHPackages                             buddysoft/yii2-setting - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. buddysoft/yii2-setting

ActiveYii2-extension[Database & ORM](/categories/database)

buddysoft/yii2-setting
======================

Simple and Configurable Setting rely on DB

v1.3.3(6y ago)070Apache Version 2.0PHPPHP >=5.6.15

Since Jun 5Pushed 6y ago1 watchersCompare

[ Source](https://github.com/liuwanwei/yii2-setting)[ Packagist](https://packagist.org/packages/buddysoft/yii2-setting)[ Docs](https://github.com/liuwanwei/yii2-setting)[ RSS](/packages/buddysoft-yii2-setting/feed)WikiDiscussions master Synced 4w ago

READMEChangelogDependencies (1)Versions (17)Used By (0)

使用数据库存储通用配置项
============

[](#使用数据库存储通用配置项)

简介
--

[](#简介)

为 Yii2 封装的一个配置项管理模块。

**特性：**

1. 支持从配置文件读取应用的默认配置项
2. 支持使用 Yii2 内置的各种 validators 对配置做验证
3. 内置配置项无法删除，意外删除后会自动用默认配置项填充
4. 提供配置页面对配置项进行管理

**适用环境：**

- PHP 5.6 及以上版本
- Yii2.0.7 及以上版本
- MySQL 5.6 及以上版本

使用方法
----

[](#使用方法)

**1.安装**

```
#composer require buddysoft/yii2-setting

```

**2.导入数据表**

```
#cd project_root
#./yii migrate --migrationPath=@buddysoft/setting/migrations

```

**3.创建配置文件**

示例文件位置： yii2-setting/migrations/settings.php

推荐拷贝配置文件到目标应用的 config 目录，以 Yii2 高级模板的 backend 应用为例：

```
#cd project_root
#cp vendor/buddysoft/yii2-setting/migrations/settings.php backend/config/bd_settings.php

```

导入口，可以对配置项进行修改、添加或删除。

**4.配置管理页面模块**

修改 backend/config/main.php

```
// 在文件顶部引入配置文件：

$bdSettings = require(__DIR__ . '/bd_settings.php');

// 在 modules 配置中增加 setting 模块的定义，用到的 bdSettings 变量，就是上面配置的内容。

'modules' => [
    'setting' => [
        'class' => 'buddysoft\setting\Module',
        'defaultSetting' =>  $bdSettings,
    ],
],

```

经过以上配置，就能在浏览中访问配置界面了:

>

跟 Yii2-admin 配合使用时，记得将 setting/setting/\* 访问权限添加给用户。

**5.在代码中使用配置项**

```
use buddysoft/setting/SettingHelper;
// 'sms-switch' 就是配置项的 key 值。
$intValue = SettingHelper::intValue('sms-switch');

```

配置项定义方法
-------

[](#配置项定义方法)

示例：

```
[
    'name' => '短信通道开关',
    'key' => 'sms-switch',
    'value' => '1', // 默认值
    'weight' => '0', // 后台配置界面显示顺序
    'description' => '是否打开短信验证，打开后...',
    'options' => [
        'validator' => 'in',
        'params' => [
            'range' => ['1', '0']
        ]
    ],
],

```

配置中使用 options 配置 validator 对 value 的合法性进行验证。

options 有两个属性：

- validator：配置项名字，诸如 integer, string, in 等
- params: validator 验证时使用的参数，参考 validators 的 public 属性

分类功能
----

[](#分类功能)

为了方便在后台管理所有配置项，所以给配置项增加了分类（category）属性，后台展示时，同一分类的配置项在一个 Tab 中展示。

注意：配置项不会根据分类进行隔离，所有配置项都在同一名字空间中。

###  Health Score

28

—

LowBetter than 52% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity8

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~51 days

Total

16

Last Release

2548d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/16d22936eaad779f55f92f099fe68ba14e67990b6c66b83dd278c7143004fc4d?d=identicon)[liuwanwei](/maintainers/liuwanwei)

---

Top Contributors

[![liuwanwei](https://avatars.githubusercontent.com/u/62382?v=4)](https://github.com/liuwanwei "liuwanwei (24 commits)")

### Embed Badge

![Health badge](/badges/buddysoft-yii2-setting/health.svg)

```
[![Health](https://phpackages.com/badges/buddysoft-yii2-setting/health.svg)](https://phpackages.com/packages/buddysoft-yii2-setting)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M2.9k](/packages/craftcms-cms)[bizley/migration

Migration generator for Yii 2.

296389.5k11](/packages/bizley-migration)[yii2tech/illuminate

Yii2 to Laravel Migration Package

11415.8k](/packages/yii2tech-illuminate)[mootensai/yii2-relation-trait

Yii 2 Models load with relation, & transaction save with relation

47229.1k9](/packages/mootensai-yii2-relation-trait)[nhkey/yii2-activerecord-history

Storage history of changes to ActiveRecord

46148.8k1](/packages/nhkey-yii2-activerecord-history)[dmstr/yii2-db

Database extensions

19656.2k6](/packages/dmstr-yii2-db)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)