Plasma\Utility

Complexity

Total Complexity

3

Size/Duplication

Total Lines	24
Duplicated Lines	0 %

Test Coverage

Coverage

88.89%

Importance

Changes

0

1 Method

Rating	Name	Duplication	Size	Complexity
A	parseParameters()	0	15	3

<?php
/**
 * Plasma Core component
 * Copyright 2018 PlasmaPHP, All Rights Reserved
 *
 * Website: https://github.com/PlasmaPHP
 * License: https://github.com/PlasmaPHP/core/blob/master/LICENSE
*/

namespace Plasma;

/**
 * Common utilities for components.
 */
class Utility {
    /**
     * Parses a query containing parameters into an array, and can replace them with a predefined replacement (can be a callable).
     * The callable is used to return numbered parameters (such as used in PostgreSQL), or any other kind of parameters supported by the DBMS.
     * @param string                $query
     * @param string|callable|null  $replaceParams  If `null` is passed, it will not replace the parameters.
     * @param string                $regex
     * @return array  `[ 'query' => string, 'parameters' => array ]`  The `parameters` array is an numeric array (= position, starting at 1), which map to the original parameter.
     */
    static function parseParameters(string $query, $replaceParams = '?', string $regex = '/(:[a-z]+)|\?|\$\d+/i'): array {
        $params = array();
        $position = 1;
        
        $query = \preg_replace_callback($regex, function (array $match) use ($replaceParams, &$params, &$position) {
            $params[($position++)] = $match[0];
            
            if($replaceParams !== null) {
                return (\is_callable($replaceParams) ? $replaceParams() : $replaceParams);
            }
            
            return $match[0];
        }, $query);
        
        return array('query' => $query, 'parameters' => $params);
    }
}