> $db * @property-read string $disable_update * @property-read string $environment * @property-read array $extensions_enabled * @property-read string $mailer * @property-read string $smtp * @property string $title */ class Minz_Configuration { /** * The list of configurations. */ private static $config_list = array(); /** * Add a new configuration to the list of configuration. * * @param string $namespace the name of the current configuration * @param string $config_filename the filename of the configuration * @param string $default_filename a filename containing default values for the configuration * @param object $configuration_setter an optional helper to set values in configuration */ public static function register($namespace, $config_filename, $default_filename = null, $configuration_setter = null) { self::$config_list[$namespace] = new Minz_Configuration( $namespace, $config_filename, $default_filename, $configuration_setter ); } /** * Parse a file and return its data. * * @param string $filename the name of the file to parse. * @return array of values * @throws Minz_FileNotExistException if the file does not exist or is invalid. */ public static function load($filename) { $data = @include($filename); if (is_array($data)) { return $data; } else { throw new Minz_FileNotExistException($filename); } } /** * Return the configuration related to a given namespace. * * @param string $namespace the name of the configuration to get. * @return Minz_Configuration object * @throws Minz_ConfigurationNamespaceException if the namespace does not exist. */ public static function get($namespace) { if (!isset(self::$config_list[$namespace])) { throw new Minz_ConfigurationNamespaceException( $namespace . ' namespace does not exist' ); } return self::$config_list[$namespace]; } /** * The namespace of the current configuration. * Unused. * @phpstan-ignore-next-line */ private $namespace = ''; /** * The filename for the current configuration. */ private $config_filename = ''; /** * The filename for the current default values, null by default. */ private $default_filename = null; /** * The configuration values, an empty array by default. */ private $data = array(); /** * An object which help to set good values in configuration. */ private $configuration_setter = null; /** * List of enabled extensions. */ private $extensions_enabled = []; public function removeExtension($ext_name) { unset($this->extensions_enabled[$ext_name]); $legacyKey = array_search($ext_name, $this->extensions_enabled, true); if ($legacyKey !== false) { //Legacy format FreshRSS < 1.11.1 unset($this->extensions_enabled[$legacyKey]); } } public function addExtension($ext_name) { if (!isset($this->extensions_enabled[$ext_name])) { $this->extensions_enabled[$ext_name] = true; } } /** * Create a new Minz_Configuration object. * * @param string $namespace the name of the current configuration. * @param string $config_filename the file containing configuration values. * @param string $default_filename the file containing default values, null by default. * @param object $configuration_setter an optional helper to set values in configuration */ private function __construct($namespace, $config_filename, $default_filename = null, $configuration_setter = null) { $this->namespace = $namespace; $this->config_filename = $config_filename; $this->default_filename = $default_filename; $this->_configurationSetter($configuration_setter); if ($this->default_filename != null) { $this->data = self::load($this->default_filename); } try { $this->data = array_replace_recursive( $this->data, self::load($this->config_filename) ); } catch (Minz_FileNotExistException $e) { if ($this->default_filename == null) { throw $e; } } } /** * Set a configuration setter for the current configuration. * @param object $configuration_setter the setter to call when modifying data. It * must implement an handle($key, $value) method. */ public function _configurationSetter($configuration_setter) { if (is_callable(array($configuration_setter, 'handle'))) { $this->configuration_setter = $configuration_setter; } } public function configurationSetter() { return $this->configuration_setter; } /** * Check if a parameter is defined in the configuration * * @return bool */ public function hasParam(string $key) { return isset($this->data[$key]); } /** * Return the value of the given param. * * @param string $key the name of the param. * @param mixed $default default value to return if key does not exist. * @return mixed value corresponding to the key. * @throws Minz_ConfigurationParamException if the param does not exist */ public function param($key, $default = null) { if (isset($this->data[$key])) { return $this->data[$key]; } elseif (!is_null($default)) { return $default; } else { Minz_Log::warning($key . ' does not exist in configuration'); return null; } } /** * A wrapper for param(). */ public function __get($key) { return $this->param($key); } /** * Set or remove a param. * * @param string $key the param name to set. * @param mixed $value the value to set. If null, the key is removed from the configuration. */ public function _param($key, $value = null) { if (!is_null($this->configuration_setter) && $this->configuration_setter->support($key)) { $this->configuration_setter->handle($this->data, $key, $value); } elseif (isset($this->data[$key]) && is_null($value)) { unset($this->data[$key]); } elseif (!is_null($value)) { $this->data[$key] = $value; } } /** * A wrapper for _param(). */ public function __set($key, $value) { $this->_param($key, $value); } /** * Save the current configuration in the configuration file. */ public function save() { $back_filename = $this->config_filename . '.bak.php'; @rename($this->config_filename, $back_filename); if (file_put_contents($this->config_filename, "data, true) . ';', LOCK_EX) === false) { return false; } // Clear PHP cache for include if (function_exists('opcache_invalidate')) { opcache_invalidate($this->config_filename); } return true; } }