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

[fntneves/laravel-transactional-events

Transaction-aware Event Dispatcher for Laravel

3202.6M2](/packages/fntneves-laravel-transactional-events)[ipinfo/ipinfo

The official PHP library for IPinfo, the most reliable, accurate, and in-depth source of IP address data available anywhere. We process terabytes of data to produce our custom IP geolocation, company, carrier and IP type data sets. Visit our developer docs at https://ipinfo.io/developers.

2891.2M11](/packages/ipinfo-ipinfo)[craftcms/plugin-installer

Craft CMS Plugin Installer

283.3M4](/packages/craftcms-plugin-installer)[typo3/cms-recordlist

TYPO3 CMS Recordlist - Lists database records in the TYPO3 backend module (Web>List).

178.0M48](/packages/typo3-cms-recordlist)[broadway/uuid-generator

UUID generator for broadway/broadway.

202.1M11](/packages/broadway-uuid-generator)

PHPackages © 2026

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