add support for FileHandler

Author: michalsn

src/Commands/ClearSettings.php

@@ -7,18 +7,61 @@
 
 class ClearSettings extends BaseCommand
 {
-    protected $group       = 'Housekeeping';
+    protected $group       = 'Settings';
     protected $name        = 'settings:clear';
-    protected $description = 'Clears all settings from the database.';
+    protected $description = 'Clears all settings from persistent storage.';
 
     public function run(array $params)
     {
-        if (CLI::prompt('This will delete all settings from the database. Are you sure you want to continue?', ['y', 'n'], 'required') !== 'y') {
+        $config   = config('Settings');
+        $handlers = $this->getHandlerNames($config);
+
+        if ($handlers === null) {
+            CLI::write('No handlers available to clear in the config file.');
+
+            return;
+        }
+
+        if (CLI::prompt('This will delete all settings from ' . $handlers . '. Are you sure you want to continue?', ['y', 'n'], 'required') !== 'y') {
             return;
         }
 
         service('settings')->flush();
 
-        CLI::write('Settings cleared from the database.', 'green');
+        CLI::write('Settings cleared from ' . $handlers . '.', 'green');
+    }
+
+    /**
+     * Gets a human-readable list of handler names.
+     *
+     * @param mixed $config
+     */
+    private function getHandlerNames($config): ?string
+    {
+        if ($config->handlers === []) {
+            return null;
+        }
+
+        $handlerNames = [];
+
+        foreach ($config->handlers as $handler) {
+            // Get writeable handlers only (those that can be flushed)
+            if (isset($config->{$handler}['writeable']) && $config->{$handler}['writeable'] === true) {
+                $handlerNames[] = $handler;
+            }
+        }
+
+        if ($handlerNames === []) {
+            return null;
+        }
+
+        if (count($handlerNames) === 1) {
+            return $handlerNames[0] . ' handler';
+        }
+
+        // Multiple handlers: "database and file"
+        $last = array_pop($handlerNames);
+
+        return implode(', ', $handlerNames) . ' and ' . $last . ' handlers';
     }
 }

src/Config/Settings.php

@@ -5,6 +5,7 @@
 use CodeIgniter\Config\BaseConfig;
 use CodeIgniter\Settings\Handlers\ArrayHandler;
 use CodeIgniter\Settings\Handlers\DatabaseHandler;
+use CodeIgniter\Settings\Handlers\FileHandler;
 
 class Settings extends BaseConfig
 {
@@ -34,4 +35,13 @@ class Settings extends BaseConfig
         'group'     => null,
         'writeable' => true,
     ];
+
+    /**
+     * File handler settings.
+     */
+    public $file = [
+        'class'     => FileHandler::class,
+        'path'      => WRITEPATH . 'settings',
+        'writeable' => true,
+    ];
 }

src/Handlers/ArrayHandler.php

@@ -115,4 +115,18 @@ protected function forgetStored(string $class, string $property, ?string $contex
             unset($this->contexts[$context][$class][$property]);
         }
     }
+
+    /**
+     * Retrieves all stored properties for a specific class and context.
+     *
+     * @return array<string,array> Format: ['property' => ['value', 'type']]
+     */
+    protected function getAllStored(string $class, ?string $context): array
+    {
+        if ($context === null) {
+            return $this->general[$class] ?? [];
+        }
+
+        return $this->contexts[$context][$class] ?? [];
+    }
 }