Completed
Push — master ( c15e27...f659ac )
by Alain
04:34
created
src/ConfigTrait.php 1 patch
Indentation   +160 added lines, -160 removed lines patch added patch discarded remove patch
@@ -25,164 +25,164 @@
 block discarded – undo
25 25
 trait ConfigTrait
26 26
 {
27 27
 
28
-    /**
29
-     * Reference to the Config object.
30
-     *
31
-     * @since 0.1.2
32
-     *
33
-     * @var ConfigInterface
34
-     */
35
-    protected $config;
36
-
37
-    /**
38
-     * Process the passed-in configuration file.
39
-     *
40
-     * @since 0.1.2
41
-     *
42
-     * @param ConfigInterface $config The Config to process.
43
-     * @param                 string  ... List of keys.
44
-     *
45
-     * @throws FailedToProcessConfigException If the arguments could not be parsed into a Config.
46
-     */
47
-    protected function processConfig(ConfigInterface $config)
48
-    {
49
-        if (func_num_args() > 1) {
50
-            try {
51
-                $keys = func_get_args();
52
-                array_shift($keys);
53
-                $config = $config->getSubConfig($keys);
54
-            } catch (Exception $exception) {
55
-                throw new FailedToProcessConfigException(
56
-                    sprintf(
57
-                        _('Could not process the config with the arguments "%1$s".'),
58
-                        print_r(func_get_args(), true)
59
-                    )
60
-                );
61
-            }
62
-        }
63
-        $this->config = $config;
64
-    }
65
-
66
-    /**
67
-     * Check whether the Config has a specific key.
68
-     *
69
-     * To get a value several levels deep, add the keys for each level as a comma-separated list.
70
-     *
71
-     * @since 0.1.2
72
-     * @since 0.1.5 Accepts list of keys.
73
-     *
74
-     * @param string|array $_ List of keys.
75
-     *
76
-     * @return bool Whether the key is known.
77
-     */
78
-    protected function hasConfigKey($_)
79
-    {
80
-        $keys = func_get_args();
81
-
82
-        return $this->config->hasKey($keys);
83
-    }
84
-
85
-    /**
86
-     * Get the Config value for a specific key.
87
-     *
88
-     * To get a value several levels deep, add the keys for each level as a comma-separated list.
89
-     *
90
-     * @since 0.1.2
91
-     * @since 0.1.5 Accepts list of keys.
92
-     *
93
-     * @param string|array $_ List of keys.
94
-     *
95
-     * @return mixed Value of the key.
96
-     */
97
-    protected function getConfigKey($_)
98
-    {
99
-        $keys = func_get_args();
100
-
101
-        return $this->config->getKey($keys);
102
-    }
103
-
104
-    /**
105
-     * Get the callable Config value for a specific key.
106
-     *
107
-     * If the fetched value is indeed a callable, it will be executed with the provided arguments, and the resultant
108
-     * value will be returned instead.
109
-     *
110
-     * @since 0.4.8
111
-     *
112
-     * @param string|array $key  Key or array of nested keys.
113
-     * @param array        $args Optional. Array of arguments to pass to the callable.
114
-     *
115
-     * @return mixed Resultant value of the key's callable.
116
-     */
117
-    protected function getConfigCallable($key, array $args = [])
118
-    {
119
-        $value = $this->config->getKey($key);
120
-
121
-        if (is_callable($value)) {
122
-            $value = $value(...$args);
123
-        }
124
-
125
-        return $value;
126
-    }
127
-
128
-    /**
129
-     * Get a (multi-dimensional) array of all the configuration settings.
130
-     *
131
-     * @since 0.1.4
132
-     *
133
-     * @return array All the configuration settings.
134
-     */
135
-    protected function getConfigArray()
136
-    {
137
-        return $this->config->getAll();
138
-    }
139
-
140
-    /**
141
-     * Get an array of all the keys that are known by the Config.
142
-     *
143
-     * @since 0.1.2
144
-     *
145
-     * @return array Array of strings containing all the keys.
146
-     */
147
-    protected function getConfigKeys()
148
-    {
149
-        return $this->config->getKeys();
150
-    }
151
-
152
-    /**
153
-     * Get a default configuration in case none was injected into the constructor.
154
-     *
155
-     * The name and path of the configuration needs to be set as a const called DEFAULT_CONFIG within the class
156
-     * containing the trait. The path needs to be relative to the location of the containing class file.
157
-     *
158
-     * @since 0.4.2
159
-     *
160
-     * @return ConfigInterface Configuration settings to use.
161
-     */
162
-    protected function fetchDefaultConfig()
163
-    {
164
-        $configFile = method_exists($this, 'getDefaultConfigFile')
165
-            ? $this->getDefaultConfigFile()
166
-            : __DIR__ . '/../config/defaults.php';
167
-
168
-        return $this->fetchConfig($configFile);
169
-    }
170
-
171
-    /**
172
-     * Get a configuration from a specified $file.
173
-     *
174
-     * If file is not accessible or readable, returns an empty Config.
175
-     *
176
-     * @since 0.4.2
177
-     *
178
-     * @return ConfigInterface Configuration settings to use.
179
-     */
180
-    protected function fetchConfig($configFile)
181
-    {
182
-        if (is_string($configFile) && ! is_readable($configFile)) {
183
-            $configFile = [];
184
-        }
185
-
186
-        return ConfigFactory::create($configFile);
187
-    }
28
+	/**
29
+	 * Reference to the Config object.
30
+	 *
31
+	 * @since 0.1.2
32
+	 *
33
+	 * @var ConfigInterface
34
+	 */
35
+	protected $config;
36
+
37
+	/**
38
+	 * Process the passed-in configuration file.
39
+	 *
40
+	 * @since 0.1.2
41
+	 *
42
+	 * @param ConfigInterface $config The Config to process.
43
+	 * @param                 string  ... List of keys.
44
+	 *
45
+	 * @throws FailedToProcessConfigException If the arguments could not be parsed into a Config.
46
+	 */
47
+	protected function processConfig(ConfigInterface $config)
48
+	{
49
+		if (func_num_args() > 1) {
50
+			try {
51
+				$keys = func_get_args();
52
+				array_shift($keys);
53
+				$config = $config->getSubConfig($keys);
54
+			} catch (Exception $exception) {
55
+				throw new FailedToProcessConfigException(
56
+					sprintf(
57
+						_('Could not process the config with the arguments "%1$s".'),
58
+						print_r(func_get_args(), true)
59
+					)
60
+				);
61
+			}
62
+		}
63
+		$this->config = $config;
64
+	}
65
+
66
+	/**
67
+	 * Check whether the Config has a specific key.
68
+	 *
69
+	 * To get a value several levels deep, add the keys for each level as a comma-separated list.
70
+	 *
71
+	 * @since 0.1.2
72
+	 * @since 0.1.5 Accepts list of keys.
73
+	 *
74
+	 * @param string|array $_ List of keys.
75
+	 *
76
+	 * @return bool Whether the key is known.
77
+	 */
78
+	protected function hasConfigKey($_)
79
+	{
80
+		$keys = func_get_args();
81
+
82
+		return $this->config->hasKey($keys);
83
+	}
84
+
85
+	/**
86
+	 * Get the Config value for a specific key.
87
+	 *
88
+	 * To get a value several levels deep, add the keys for each level as a comma-separated list.
89
+	 *
90
+	 * @since 0.1.2
91
+	 * @since 0.1.5 Accepts list of keys.
92
+	 *
93
+	 * @param string|array $_ List of keys.
94
+	 *
95
+	 * @return mixed Value of the key.
96
+	 */
97
+	protected function getConfigKey($_)
98
+	{
99
+		$keys = func_get_args();
100
+
101
+		return $this->config->getKey($keys);
102
+	}
103
+
104
+	/**
105
+	 * Get the callable Config value for a specific key.
106
+	 *
107
+	 * If the fetched value is indeed a callable, it will be executed with the provided arguments, and the resultant
108
+	 * value will be returned instead.
109
+	 *
110
+	 * @since 0.4.8
111
+	 *
112
+	 * @param string|array $key  Key or array of nested keys.
113
+	 * @param array        $args Optional. Array of arguments to pass to the callable.
114
+	 *
115
+	 * @return mixed Resultant value of the key's callable.
116
+	 */
117
+	protected function getConfigCallable($key, array $args = [])
118
+	{
119
+		$value = $this->config->getKey($key);
120
+
121
+		if (is_callable($value)) {
122
+			$value = $value(...$args);
123
+		}
124
+
125
+		return $value;
126
+	}
127
+
128
+	/**
129
+	 * Get a (multi-dimensional) array of all the configuration settings.
130
+	 *
131
+	 * @since 0.1.4
132
+	 *
133
+	 * @return array All the configuration settings.
134
+	 */
135
+	protected function getConfigArray()
136
+	{
137
+		return $this->config->getAll();
138
+	}
139
+
140
+	/**
141
+	 * Get an array of all the keys that are known by the Config.
142
+	 *
143
+	 * @since 0.1.2
144
+	 *
145
+	 * @return array Array of strings containing all the keys.
146
+	 */
147
+	protected function getConfigKeys()
148
+	{
149
+		return $this->config->getKeys();
150
+	}
151
+
152
+	/**
153
+	 * Get a default configuration in case none was injected into the constructor.
154
+	 *
155
+	 * The name and path of the configuration needs to be set as a const called DEFAULT_CONFIG within the class
156
+	 * containing the trait. The path needs to be relative to the location of the containing class file.
157
+	 *
158
+	 * @since 0.4.2
159
+	 *
160
+	 * @return ConfigInterface Configuration settings to use.
161
+	 */
162
+	protected function fetchDefaultConfig()
163
+	{
164
+		$configFile = method_exists($this, 'getDefaultConfigFile')
165
+			? $this->getDefaultConfigFile()
166
+			: __DIR__ . '/../config/defaults.php';
167
+
168
+		return $this->fetchConfig($configFile);
169
+	}
170
+
171
+	/**
172
+	 * Get a configuration from a specified $file.
173
+	 *
174
+	 * If file is not accessible or readable, returns an empty Config.
175
+	 *
176
+	 * @since 0.4.2
177
+	 *
178
+	 * @return ConfigInterface Configuration settings to use.
179
+	 */
180
+	protected function fetchConfig($configFile)
181
+	{
182
+		if (is_string($configFile) && ! is_readable($configFile)) {
183
+			$configFile = [];
184
+		}
185
+
186
+		return ConfigFactory::create($configFile);
187
+	}
188 188
 }
Please login to merge, or discard this patch.