VariableParser::getVariable() - Code Metrics - Inspection of "Variables context" - m1/Env - Measure and Improve Code Quality continuously with Scrutinizer

Completed

Pull Request — master (#6)

by Bogdan

created 2017-07-23 16:48 UTC

VariableParser::getVariable() A

↳ Parent: VariableParser

Complexity

Conditions	3
Paths	3

Size

Total Lines	12
Code Lines	6

Duplication

Lines	0
Ratio	0 %

Code Coverage

Tests	0
CRAP Score	12

Importance

Changes

Metric	Value
dl	0
loc	12
ccs	0
cts	0
cp	0
rs	9.4285
c	0
b	0
f	0
cc	3
eloc	6
nc	3
nop	1
crap	12

<?php

/**
 * This file is part of the m1\env library
 *
 * (c) m1 <[email protected]>
 *
 * For the full copyright and license information, please view the LICENSE
 * file that was distributed with this source code.
 *
 * @package     m1/env
 * @version     2.0.0
 * @author      Miles Croxford <[email protected]>
 * @copyright   Copyright (c) Miles Croxford <[email protected]>
 * @license     http://github.com/m1/env/blob/master/LICENSE.md
 * @link        http://github.com/m1/env/blob/master/README.md Documentation
 */

namespace M1\Env\Parser;

use M1\Env\Exception\ParseException;

/**
 * The value parser for Env
 *
 * @since 1.1.0
 */
class VariableParser extends AbstractParser
{
    /**
     * The regex to get variables '$(VARIABLE)' in .env
     * Unescaped: ${(.*?)}
     *
     * @var string REGEX_ENV_VARIABLE
     */
    const REGEX_ENV_VARIABLE = '\\${(.*?)}';

    /**
     * The symbol for the assign default value parameter expansion
     *
     * @var string SYMBOL_ASSIGN_DEFAULT_VALUE
     */
    const SYMBOL_ASSIGN_DEFAULT_VALUE = '=';

    /**
     * The symbol for the default value parameter expansion
     *
     * @var string SYMBOL_DEFAULT_VALUE
     */
    const SYMBOL_DEFAULT_VALUE = '-';

    /**
     * Variables context
     *
     * @var array
     */
    private $context;

    /**
     * {@inheritdoc}
     *
     * @param \M1\Env\Parser $parser The parent parser
     * @param array $context Variables context
     */
    public function __construct($parser, array $context = array())
    {
        parent::__construct($parser);

        $this->context = $context;
    }

    /**
     * Parses a .env variable
     *
     * @param string $value         The value to parse
     * @param bool   $quoted_string Is the value in a quoted string
     *
     * @return string The parsed value
     */
    public function parse($value, $quoted_string = false)
    {
        $matches = $this->fetchVariableMatches($value);

        if (is_array($matches)) {
            if ($this->parser->string_helper->isVariableClone($value, $matches, $quoted_string)) {
                return $this->fetchVariable($value, $matches[1][0], $matches, $quoted_string);
            }

            $value = $this->doReplacements($value, $matches, $quoted_string);
        }

        return $value;
    }

    /**
     * Get variable matches inside a string
     *
     * @param string $value The value to parse
     *
     * @return array The variable matches
     */
    private function fetchVariableMatches($value)
    {
        preg_match_all('/' . self::REGEX_ENV_VARIABLE . '/', $value, $matches);

        if (!is_array($matches) || !isset($matches[0]) || empty($matches[0])) {
            return false;
        }

        return $matches;
    }

    /**
     * Parses a .env variable
     *
     * @param string $value The value to parse
     * @param string $variable_name The variable name to get
     * @param array $matches The matches of the variables
     * @param bool $quoted_string Is the value in a quoted string
     *
     * @return string The parsed value
     * @throws \M1\Env\Exception\ParseException If the variable can not be found
     */
    private function fetchVariable($value, $variable_name, $matches, $quoted_string)
    {
        if ($this->hasParameterExpansion($variable_name)) {
            $replacement = $this->fetchParameterExpansion($variable_name);
        } elseif ($this->hasVariable($variable_name)) {
            $replacement = $this->getVariable($variable_name);
        } else {
            throw new ParseException(
                sprintf('Variable has not been defined: %s', $variable_name),
                $value,
                $this->parser->line_num
            );
        }

        if ($this->parser->string_helper->isBoolInString($replacement, $quoted_string, count($matches[0]))) {
            $replacement = ($replacement) ? 'true' : 'false';
        }

        return $replacement;
    }

    /**
     * Checks to see if the variable has a parameter expansion
     *
     * @param string $variable The variable to check
     *
     * @return bool Does the variable have a parameter expansion
     */
    private function hasParameterExpansion($variable)
    {
        if ((strpos($variable, self::SYMBOL_DEFAULT_VALUE) !== false) ||
            (strpos($variable, self::SYMBOL_ASSIGN_DEFAULT_VALUE) !== false)
        ) {
            return true;
        }

        return false;
    }

    /**
     * Fetches and sets the parameter expansion
     *
     * @param string $variable_name The parameter expansion inside this to fetch
     *
     * @return string The parsed value
     */
    private function fetchParameterExpansion($variable_name)
    {
        $parameter_type = $this->fetchParameterExpansionType($variable_name);

        list($parameter_symbol, $empty_flag) = $this->fetchParameterExpansionSymbol($variable_name, $parameter_type);
        list($variable, $default) = $this->splitVariableDefault($variable_name, $parameter_symbol);

        $value = $this->getVariable($variable);

        return $this->parseVariableParameter(
            $variable,
            $default,
            $this->hasVariable($variable),
            $empty_flag && empty($value),
            $parameter_type
        );
    }

    /**
     * Fetches the parameter expansion type
     *
     * @param string $variable_name The parameter expansion type to get from this
     *
     * @return string The parameter expansion type
     */
    private function fetchParameterExpansionType($variable_name)
    {
        if (strpos($variable_name, self::SYMBOL_ASSIGN_DEFAULT_VALUE) !== false) {
            return 'assign_default_value';
        }

        return 'default_value'; // self::DEFAULT_VALUE_SYMBOL
    }

    /**
     * Fetches the parameter type symbol
     *
     * @param string $variable_name The variable
     * @param string $type          The type of parameter expansion
     *
     * @return array The symbol and if there is a empty check
     */
    private function fetchParameterExpansionSymbol($variable_name, $type)
    {
        $class = new \ReflectionClass($this);
        $symbol = $class->getConstant('SYMBOL_'.strtoupper($type));
        $pos = strpos($variable_name, $symbol);

        $check_empty = substr($variable_name, ($pos - 1), 1) === ":";

        if ($check_empty) {
            $symbol = sprintf(":%s", $symbol);
        }

        return array($symbol, $check_empty);
    }

    /**
     * Splits the parameter expansion into variable and default
     *
     * @param string $variable_name    The variable name to split
     * @param string $parameter_symbol The parameter expansion symbol
     *
     * @throws \M1\Env\Exception\ParseException If the parameter expansion if not valid syntax
     *
     * @return array The split variable and default value
     */
    private function splitVariableDefault($variable_name, $parameter_symbol)
    {
        $variable_default = explode($parameter_symbol, $variable_name, 2);

        if (count($variable_default) !== 2 || empty($variable_default[1])) {
            throw new ParseException(
                'You must have valid parameter expansion syntax, eg. ${parameter:=word}',
                $variable_name,
                $this->parser->line_num
            );
        }

        return array(trim($variable_default[0]), trim($variable_default[1]));
    }


    /**
     * Parses and sets the variable and default if needed
     *
     * @param string $variable The variable to parse
     * @param string $default  The default value
     * @param bool   $exists   Does the variable exist
     * @param bool   $empty    Is there the variable empty if exists and the empty flag is set
     * @param string $type     The type of parameter expansion
     *
     * @return string The parsed value
     */
    private function parseVariableParameter($variable, $default, $exists, $empty, $type)
    {
        if ($exists && !$empty) {
            return $this->getVariable($variable);
        }

        return $this->assignVariableParameterDefault($variable, $default, $empty, $type);
    }

    /**
     * Parses and sets the variable parameter to default
     *
     * @param string $variable The variable to parse
     * @param string $default  The default value
     * @param bool   $empty    Is there the variable empty if exists and the empty flag is set
     * @param string $type     The type of parameter expansion
     *
     * @return string The parsed default value
     */
    private function assignVariableParameterDefault($variable, $default, $empty, $type)
    {
        $default = $this->parser->value_parser->parse($default);

        if ($type === "assign_default_value" && $empty) {
            $this->parser->lines[$variable] = $default;
        }

        return $default;
    }

    /**
     * Checks to see if a variable exists
     *
     * @param string $variable The variable name to get
     *
     * @return bool
     */
    private function hasVariable($variable)
    {
        if (array_key_exists($variable, $this->parser->lines)) {
            return true;
        }

        if (array_key_exists($variable, $this->context)) {
            return true;
        }

        return false;
    }

    /**
     * Get variable value
     *
     * @param string $variable
     *
     * @return mixed
     */
    private function getVariable($variable)
    {
        if (array_key_exists($variable, $this->parser->lines)) {
            return $this->parser->lines[$variable];
        }

        if (array_key_exists($variable, $this->context)) {
            return $this->context[$variable];
        }

        return null;
    }

    /**
     * Do the variable replacements
     *
     * @param string $value         The value to throw an error with if doesn't exist
     * @param array  $matches       The matches of the variables
     * @param bool   $quoted_string Is the value in a quoted string
     *
     * @return string The parsed value
     */
    public function doReplacements($value, $matches, $quoted_string)
    {
        $replacements = array();

        for ($i = 0; $i <= (count($matches[0]) - 1); $i++) {
            $replacement = $this->fetchVariable($value, $matches[1][$i], $matches, $quoted_string);
            $replacements[$matches[0][$i]] = $replacement;
        }

        if (!empty($replacements)) {
            $value = strtr($value, $replacements);
        }

        return $value;
    }
}


1		<?php
2
3		/**
4		* This file is part of the m1\env library
5		*
6		* (c) m1 <[email protected]>
7		*
8		* For the full copyright and license information, please view the LICENSE
9		* file that was distributed with this source code.
10		*
11		* @package m1/env
12		* @version 2.0.0
13		* @author Miles Croxford <[email protected]>
14		* @copyright Copyright (c) Miles Croxford <[email protected]>
15		* @license http://github.com/m1/env/blob/master/LICENSE.md
16		* @link http://github.com/m1/env/blob/master/README.md Documentation
17		*/
18
19		namespace M1\Env\Parser;
20
21		use M1\Env\Exception\ParseException;
22
23		/**
24		* The value parser for Env
25		*
26		* @since 1.1.0
27		*/
28		class VariableParser extends AbstractParser
29		{
30		/**
31		* The regex to get variables '$(VARIABLE)' in .env
32		* Unescaped: ${(.*?)}
33		*
34		* @var string REGEX_ENV_VARIABLE
35		*/
36		const REGEX_ENV_VARIABLE = '\\${(.*?)}';
37
38		/**
39		* The symbol for the assign default value parameter expansion
40		*
41		* @var string SYMBOL_ASSIGN_DEFAULT_VALUE
42		*/
43		const SYMBOL_ASSIGN_DEFAULT_VALUE = '=';
44
45		/**
46		* The symbol for the default value parameter expansion
47		*
48		* @var string SYMBOL_DEFAULT_VALUE
49		*/
50		const SYMBOL_DEFAULT_VALUE = '-';
51
52		/**
53		* Variables context
54		*
55		* @var array
56		*/
57		private $context;
58
59		/**
60	36	* {@inheritdoc}
61		*
62	36	* @param \M1\Env\Parser $parser The parent parser
63		* @param array $context Variables context
64	36	*/
65	18	public function __construct($parser, array $context = array())
66	18	{
67		parent::__construct($parser);
68
69	9	$this->context = $context;
70	9	}
71
72	30	/**
73		* Parses a .env variable
74		*
75		* @param string $value The value to parse
76		* @param bool $quoted_string Is the value in a quoted string
77		*
78		* @return string The parsed value
79		*/
80		public function parse($value, $quoted_string = false)
81		{
82	36	$matches = $this->fetchVariableMatches($value);
83
84	36	if (is_array($matches)) {
85		if ($this->parser->string_helper->isVariableClone($value, $matches, $quoted_string)) {
86	36	return $this->fetchVariable($value, $matches[1][0], $matches, $quoted_string);
87	27	}
88
89		$value = $this->doReplacements($value, $matches, $quoted_string);
90	18	}
91
92		return $value;
93		}
94
95		/**
96		* Get variable matches inside a string
97		*
98		* @param string $value The value to parse
99		*
100		* @return array The variable matches
101		*/
102		private function fetchVariableMatches($value)
103	18	{
104		preg_match_all('/' . self::REGEX_ENV_VARIABLE . '/', $value, $matches);
105	18
106	9	if (!is_array($matches) \|\| !isset($matches[0]) \|\| empty($matches[0])) {
107	6	return false;
108	12	}
109	9
110		return $matches;
111		}
112	12
113	6	/**
114	6	* Parses a .env variable
115		*
116	12	* @param string $value The value to parse
117		* @param string $variable_name The variable name to get
118		* @param array $matches The matches of the variables
119		* @param bool $quoted_string Is the value in a quoted string
120		*
121		* @return string The parsed value
122		* @throws \M1\Env\Exception\ParseException If the variable can not be found
123		*/
124		private function fetchVariable($value, $variable_name, $matches, $quoted_string)
125		{
126	18	if ($this->hasParameterExpansion($variable_name)) {
127		$replacement = $this->fetchParameterExpansion($variable_name);
128	18	} elseif ($this->hasVariable($variable_name)) {
129	18	$replacement = $this->getVariable($variable_name);
130	18	} else {
131	9	throw new ParseException(
132		sprintf('Variable has not been defined: %s', $variable_name),
133		$value,
134	12	$this->parser->line_num
135		);
136		}
137
138		if ($this->parser->string_helper->isBoolInString($replacement, $quoted_string, count($matches[0]))) {
139		$replacement = ($replacement) ? 'true' : 'false';
140		}
141
142		return $replacement;
143		}
144	9
145		/**
146	9	* Checks to see if the variable has a parameter expansion
147		*
148	9	* @param string $variable The variable to check
149	9	*
150		* @return bool Does the variable have a parameter expansion
151	6	*/
152	6	private function hasParameterExpansion($variable)
153	6	{
154	6	if ((strpos($variable, self::SYMBOL_DEFAULT_VALUE) !== false) \|\|
155	6	(strpos($variable, self::SYMBOL_ASSIGN_DEFAULT_VALUE) !== false)
156		) {
157	6	return true;
158		}
159
160		return false;
161		}
162
163		/**
164		* Fetches and sets the parameter expansion
165		*
166		* @param string $variable_name The parameter expansion inside this to fetch
167	9	*
168		* @return string The parsed value
169	9	*/
170	9	private function fetchParameterExpansion($variable_name)
171		{
172		$parameter_type = $this->fetchParameterExpansionType($variable_name);
173	6
174		list($parameter_symbol, $empty_flag) = $this->fetchParameterExpansionSymbol($variable_name, $parameter_type);
175		list($variable, $default) = $this->splitVariableDefault($variable_name, $parameter_symbol);
176
177		$value = $this->getVariable($variable);
178
179		return $this->parseVariableParameter(
180		$variable,
181		$default,
182		$this->hasVariable($variable),
183		$empty_flag && empty($value),
184	9	$parameter_type
185		);
186	9	}
187	9
188	9	/**
189		* Fetches the parameter expansion type
190	9	*
191		* @param string $variable_name The parameter expansion type to get from this
192	9	*
193	9	* @return string The parameter expansion type
194	9	*/
195		private function fetchParameterExpansionType($variable_name)
196	9	{
197		if (strpos($variable_name, self::SYMBOL_ASSIGN_DEFAULT_VALUE) !== false) {
198		return 'assign_default_value';
199		}
200
201		return 'default_value'; // self::DEFAULT_VALUE_SYMBOL
202		}
203
204		/**
205		* Fetches the parameter type symbol
206		*
207		* @param string $variable_name The variable
208		* @param string $type The type of parameter expansion
209	9	*
210		* @return array The symbol and if there is a empty check
211	9	*/
212		private function fetchParameterExpansionSymbol($variable_name, $type)
213	9	{
214	3	$class = new \ReflectionClass($this);
215	3	$symbol = $class->getConstant('SYMBOL_'.strtoupper($type));
216	3	$pos = strpos($variable_name, $symbol);
217	3
218	3	$check_empty = substr($variable_name, ($pos - 1), 1) === ":";
219
220		if ($check_empty) {
221	6	$symbol = sprintf(":%s", $symbol);
222		}
223
224		return array($symbol, $check_empty);
225		}
226
227		/**
228		* Splits the parameter expansion into variable and default
229		*
230		* @param string $variable_name The variable name to split
231		* @param string $parameter_symbol The parameter expansion symbol
232		*
233		* @throws \M1\Env\Exception\ParseException If the parameter expansion if not valid syntax
234		*
235		* @return array The split variable and default value
236	6	*/
237		private function splitVariableDefault($variable_name, $parameter_symbol)
238	6	{
239	6	$variable_default = explode($parameter_symbol, $variable_name, 2);
240
241		if (count($variable_default) !== 2 \|\| empty($variable_default[1])) {
242	6	throw new ParseException(
243		'You must have valid parameter expansion syntax, eg. ${parameter:=word}',
244		$variable_name,
245		$this->parser->line_num
246		);
247		}
248
249		return array(trim($variable_default[0]), trim($variable_default[1]));
250		}
251
252
253		/**
254		* Parses and sets the variable and default if needed
255	6	*
256		* @param string $variable The variable to parse
257	6	* @param string $default The default value
258		* @param bool $exists Does the variable exist
259	6	* @param bool $empty Is there the variable empty if exists and the empty flag is set
260	6	* @param string $type The type of parameter expansion
261	6	*
262		* @return string The parsed value
263	6	*/
264		private function parseVariableParameter($variable, $default, $exists, $empty, $type)
265		{
266		if ($exists && !$empty) {
267		return $this->getVariable($variable);
268		}
269
270		return $this->assignVariableParameterDefault($variable, $default, $empty, $type);
271		}
272
273		/**
274		* Parses and sets the variable parameter to default
275		*
276		* @param string $variable The variable to parse
277	15	* @param string $default The default value
278		* @param bool $empty Is there the variable empty if exists and the empty flag is set
279	15	* @param string $type The type of parameter expansion
280	9	*
281	6	* @return string The parsed default value
282		*/
283		private function assignVariableParameterDefault($variable, $default, $empty, $type)
284	3	{
285	3	$default = $this->parser->value_parser->parse($default);
286	3
287	3	if ($type === "assign_default_value" && $empty) {
288	3	$this->parser->lines[$variable] = $default;
289		}
290
291	12	return $default;
292		}
293
294		/**
295		* Checks to see if a variable exists
296		*
297		* @param string $variable The variable name to get
298		*
299		* @return bool
300		*/
301		private function hasVariable($variable)
302		{
303	9	if (array_key_exists($variable, $this->parser->lines)) {
304		return true;
305	9	}
306
307	9	if (array_key_exists($variable, $this->context)) {
308	9	return true;
309	9	}
310	9
311		return false;
312	9	}
313	9
314	9	/**
315		* Get variable value
316	9	*
317		* @param string $variable
318		*
319		* @return mixed
320		*/
321		private function getVariable($variable)
322		{
323		if (array_key_exists($variable, $this->parser->lines)) {
324		return $this->parser->lines[$variable];
325		}
326
327		if (array_key_exists($variable, $this->context)) {
328		return $this->context[$variable];
329		}
330
331		return null;
332		}
333
334		/**
335		* Do the variable replacements
336		*
337		* @param string $value The value to throw an error with if doesn't exist
338		* @param array $matches The matches of the variables
339		* @param bool $quoted_string Is the value in a quoted string
340		*
341		* @return string The parsed value
342		*/
343		public function doReplacements($value, $matches, $quoted_string)
344		{
345		$replacements = array();
346
347		for ($i = 0; $i <= (count($matches[0]) - 1); $i++) {
348		$replacement = $this->fetchVariable($value, $matches[1][$i], $matches, $quoted_string);
349		$replacements[$matches[0][$i]] = $replacement;
350		}
351
352		if (!empty($replacements)) {
353		$value = strtr($value, $replacements);
354		}
355
356		return $value;
357		}
358		}
359

m1 / Env

GitHub Access Token became invalid

Pull Request — master (#6)

VariableParser::getVariable() A

Complexity

Size

Duplication

Code Coverage

Importance

Duplication Side-by-Side

Filter issues like