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

21

—

LowBetter than 19% of packages

Maintenance60

Regular maintenance activity

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

[aristath/ari-color

A PHP library for color manipulation in themes and plugins

6128.6k](/packages/aristath-ari-color)[symfony/ux-notify

Native notification integration for Symfony

1274.7k](/packages/symfony-ux-notify)[thestringler/manipulator

An OOP approach to string manipulation.

345.5k2](/packages/thestringler-manipulator)[hauntd/yii2-vote

Votes, likes, favorites.

383.1k](/packages/hauntd-yii2-vote)

PHPackages © 2026

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