Download the PHP package olajideolamide/ci4-settings without Composer

CodeIgniter 4 Settings & Feature Flags Library

Database-backed application settings and feature flags for CodeIgniter 4, with dot-notation support, automatic type casting, and optional caching.

This package gives you a simple settings() helper and a small Settings library so you can store configuration in the database instead of hard-coding everything in config files.

Features

• Database-backed settings using a dedicated settings table
• Feature flags via a simple feature('flag_name') helper
• Dot-notation keys like app.name, mail.smtp.host, etc.
• Automatic type detection & casting
  • bool, int, float, string, json (arrays/objects)
• Nested settings & JSON
  • Store arrays/objects and access them via dot notation
• Optional caching via CodeIgniter’s cache system
• Convenience helpers
  • settings() – get/set/delete settings
  • feature() – check if a feature flag is enabled
• Smart delete
  • Can remove nested keys from JSON settings (e.g. remove app.mail.host from a stored app.mail JSON blob)

Requirements

• PHP 8.0+
• CodeIgniter 4.x
• A database supported by CodeIgniter 4

Installation

1. Install via Composer

2. Register the namespace (if needed)

In most Composer-based CodeIgniter 4 apps, Composer’s autoloader is already wired up.
If you are using modules and explicit namespaces, add the package namespace to app/Config/Autoload.php:

3. Run the migration

This package ships with a migration that creates the settings table.

Run:

This will create a table named settings with columns:

• id (INT, PK, auto-increment)
• key (VARCHAR, unique)
• value (TEXT)
• type (VARCHAR – string, bool, int, float, json, etc.)
• group (VARCHAR, nullable) – optional grouping for your own use
• is_feature (TINYINT(1)) – marks a setting as a feature flag
• created_at, updated_at (DATETIME, nullable)

4. Load the helper

To use the settings() and feature() helpers, load the helper:

Per controller / per use:

Globally (recommended):

In app/Config/Autoload.php:

Or in a base controller:

Quick Start

Once installed, migrated, and the helper is loaded, you can start using it immediately.

Get a setting

Set a setting

Check if a setting exists

Delete a setting

Access all settings

Feature Flags

Feature flags make it easy to toggle functionality on or off without redeploying code.

Enable a feature flag

Feature flags are stored as keys under the feature. namespace, for example: feature.new_checkout.

Check if a feature is enabled (helper)

You can also pass the full key:

Check with a default value

Under the hood, feature('something'):

• Ensures the key is prefixed with feature. if you didn’t add it
• Reads the setting
• Casts it to a boolean using common truthy representations: 1, true, yes, on (case-insensitive)

Dot-Notation & Nested Settings

This library supports dot-notation for keys, and can store arrays/objects as JSON.

Storing a nested array

Internally this is saved as:

• key = mail
• type = json
• value = JSON encoding of the array

Reading nested values

Updating part of a JSON setting

You can overwrite the whole array:

Or add nested configuration piece by piece using a more granular key:

When JSON values are loaded, they are decoded into arrays and merged into the full settings structure so that dot-paths like app.mail.host work as expected.

Type Handling

The library automatically detects and casts types based on the value you set.

Detection

When you call set($key, $value, ...), the library determines:

• bool → stored as '1' or '0', returned as bool
• int → stored as string, returned as int
• float → stored as string, returned as float
• array / object → stored as JSON (type = json), returned as array
• anything else → stored and returned as string

Casting on read

When you call get() or settings('key'):

• If type = bool it’s converted using a liberal boolean parser:
  • 1, true, yes, on → true
  • Anything else → false
• If type = int → (int)$value
• If type = float → (float)$value
• If type = json → json_decode() to an array
• Otherwise → raw string

Settings Helper & Library API

settings(?string $key = null, mixed $default = null)

• If no key is passed (settings()):
  • Returns an instance of Jide\Settings\Libraries\Settings
• If a key is passed (settings('app.name')):
  • Returns the setting value (typed) or $default if not found

Examples:

feature(string $flag, bool $default = false): bool

Convenience wrapper around Settings::featureEnabled().

• Accepts either new_checkout or feature.new_checkout
• Returns bool

Jide\Settings\Libraries\Settings methods

If you prefer to work with the library directly:

Available methods:

• get(string $key, $default = null): mixed
  Get a setting by key (supports dot notation).

• set(string $key, $value, ?string $group = null, bool $isFeature = false): bool
  Create or update a setting.

• all(): array
  Get all settings as a nested array.

• has(string $key): bool
  Check if a setting exists (supports dot notation).

• delete(string $key): bool
  Delete a setting by key.
  Also attempts to remove nested keys from JSON parent entries (e.g. app.mail.host inside app.mail).

• featureEnabled(string $flag, bool $default = false): bool
  Check if a feature flag is enabled.

Caching

This library uses a small config class to control caching:

By default:

• All settings are cached in memory on first request
• If CodeIgniter’s cache() function is available and $useCache is true:
  • The settings array is stored under $cacheKey for $cacheTTL seconds
• Any set() or delete() call automatically clears the cache

If you want to customise these values at runtime, you can instantiate the library with your own config:

Note: the helper('settings') uses new Settings() with the default config.
If you need a customised config, create your own Settings instance as above.

Building an Admin UI (Optional)

The table contains extra metadata to help you build an admin/settings UI:

• group – group related settings (e.g. mail, app, billing)
• is_feature – mark which rows are feature flags so you can list them separately

Example: only list feature flags:

License

This project is open-source software licensed under the MIT license.

Author

Olanrewaju “Jide” Olajide

• Package: olajideolamide/ci4-settings
• PRs, issues and suggestions are welcome!