Persistent settings package for Hyperf

v1.0.0 2021-07-05 08:03 UTC

This package is auto-updated.

Last update: 2022-07-06 04:38:09 UTC


Build Status Latest Stable Version Total Downloads License

This package allows you to save settings in a more persistent way. You can use the database and/or json file to save your settings.


  1. Require the gokure/hypref-settings package in your composer.json and update your dependencies:
composer require gokure/hypref-settings
  1. Publish the config and migration files:
php bin/hyperf.php vendor:publish gokure/hypref-settings


$store = $container->get(\Gokure\Settings\SettingManager::class)->getDriver();

$store->set('foo', 'bar');
$store->get('foo', 'default value');
$stores = $store->all();

Call $store->save() explicitly to save changes made.

You can also to use the setting() helper:

// Get the `default` store instance

// Get values
setting('foo', 'default value');

// Set values
setting(['foo' => 'bar']);
setting(['foo.bar' => 'baz']);
setting()->set('foo', 'bar');

// Method chaining
setting(['foo' => 'bar'])->save();


You can change config/autoload/settings.php

return [
    'default' => [
         * Default Store Driver
         * This option controls the default setting connection that gets used while
         * using this setting library.
         * Supported: `FileSystemStore::class` and `DatabaseStore::class`
        'driver' => Gokure\Settings\FileSystemStore::class,

         * FileSystem Store
         * This option used when the driver is set `FileSystemStore::class`, and
         * make sure the path is writable.
        'path' => BASE_PATH . '/runtime/settings.json',

         * Database Store
         * This option used when the driver is set DatabaseStore::class.
        'database' => [
            // If set to null, the default connection will be used.
            'connection' => null,
            // Table name.
            'table' => 'settings',
            // Column names in database store.
            'key_column' => 'key',
            'value_column' => 'value',

Auto Saving

if you add the middleware Gokure\Settings\SaveMiddleware to your middlewares list in config/autoload/middlewares.php, settings will be saved automatically at the end of all HTTP requests, but you'll still need to call $store->save() explicitly in commands, queue workers etc.

FileSystem Store

You can modify the path used on run-time using $store->setPath($path).

Database Store

If you want to use the database as settings storage then you should run the php bin/hyperf.php migrate. You can modify the table fields from the create_settings_table file in the migrations directory.

Extra Columns

If you want to store settings for multiple users/clients in the same database you can do so by specifying extra columns:

$store->setExtraColumns(['user_id' => 1]);

where user_id = 1 will now be added to the database query when settings are retrieved, and when new settings are saved, the user_id will be populated.

If you need more fine-tuned control over which data gets queried, you can use the setConstraint method which takes a closure with two arguments:

  • $query is the query builder instance
  • $insert is a boolean telling you whether the query is an insert or not. If it is an insert, you usually don't need to do anything to $query.
$store->setConstraint(function($query, $insert) {
	if (!$insert) {
	    $query->where(/* ... */);


Released under the MIT License, see LICENSE.