PHPackages                             wazemaki/yii2-settings-handler - 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. [Utility & Helpers](/categories/utility)
4. /
5. wazemaki/yii2-settings-handler

ActiveYii2-extension[Utility & Helpers](/categories/utility)

wazemaki/yii2-settings-handler
==============================

Flexible database-backed settings handler for Yii2 applications with admin UI

029PHP

Since Mar 24Pushed 1mo agoCompare

[ Source](https://github.com/wazemaki/yii2-settings-handler)[ Packagist](https://packagist.org/packages/wazemaki/yii2-settings-handler)[ RSS](/packages/wazemaki-yii2-settings-handler/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (1)Used By (0)

Yii2 Settings Handler
=====================

[](#yii2-settings-handler)

Database-backed settings manager with admin UI for Yii2 applications.

Installation
------------

[](#installation)

```
composer require wazemaki/yii2-settings-handler
```

Setup
-----

[](#setup)

### 1. Run Migration

[](#1-run-migration)

```
cp vendor/wazemaki/yii2-settings-handler/migrations/*.php migrations/
php yii migrate
```

### 2. Copy Config Example

[](#2-copy-config-example)

```
cp vendor/wazemaki/yii2-settings-handler/settings-config.php config/settings-config.php
```

### 3. Configure Component

[](#3-configure-component)

Add to `config/common.php`:

```
'components' => [
    'settings' => [
        'class' => 'wazemaki\settings\SettingsHandler',
        'definitions' => require(__DIR__ . '/settings-config.php'),
    ],
],

'controllerMap' => [
    'settings' => 'wazemaki\settings\controllers\SettingsController',
],
```

Usage
-----

[](#usage)

### Admin UI

[](#admin-ui)

Navigate to: `/settings`

### In Code

[](#in-code)

```
// Get value
$value = Yii::$app->settings->get('site_name');

// Set value
Yii::$app->settings->set('site_name', 'My Site');

// Reset to default
Yii::$app->settings->delete('site_name');

// Clear settings cache
Yii::$app->settings->deleteCache();
```

Definition Options
------------------

[](#definition-options)

See `settings-config.php` for examples.

OptionDescription`label`Display label`dataType``string`, `integer`, `boolean`, `float``inputType``text`, `textarea`, `checkbox`, `number`, `select`, `password`, `email`, `url`, `delimiter``defaultValue`Default value`options`Array or closure for select dropdowns`hint`Help text`emptyMeansDefault`Treat empty as defaultLicense
-------

[](#license)

MIT

###  Health Score

20

—

LowBetter than 14% of packages

Maintenance59

Moderate activity, may be stable

Popularity7

Limited adoption so far

Community2

Small or concentrated contributor base

Maturity11

Early-stage or recently created project

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.

### Community

Maintainers

![](https://www.gravatar.com/avatar/1db044ad3d3ea2009ff07886713b9acacdea94033c68c137b0e19a8740c0f3e4?d=identicon)[wazemaki](/maintainers/wazemaki)

### Embed Badge

![Health badge](/badges/wazemaki-yii2-settings-handler/health.svg)

```
[![Health](https://phpackages.com/badges/wazemaki-yii2-settings-handler/health.svg)](https://phpackages.com/packages/wazemaki-yii2-settings-handler)
```

###  Alternatives

[rs/laravel-version-control

Foundations for making your app version controlled. Provides migration, blueprint and base models. Will make your app GxP compliant if you exclusively use the VC models and table structure as set out in this package.

1227.5k](/packages/rs-laravel-version-control)[mad-web/laravel-seoable

Easy to map your eloquent fields to seo properties

407.6k](/packages/mad-web-laravel-seoable)

PHPackages © 2026

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