132 lines
3.4 KiB
PHP
132 lines
3.4 KiB
PHP
<?php
|
|
|
|
/**
|
|
* `GROUP BY` keyword parser.
|
|
*/
|
|
|
|
namespace PhpMyAdmin\SqlParser\Components;
|
|
|
|
use PhpMyAdmin\SqlParser\Component;
|
|
use PhpMyAdmin\SqlParser\Parser;
|
|
use PhpMyAdmin\SqlParser\Token;
|
|
use PhpMyAdmin\SqlParser\TokensList;
|
|
|
|
/**
|
|
* `GROUP BY` keyword parser.
|
|
*
|
|
* @category Keywords
|
|
*
|
|
* @license https://www.gnu.org/licenses/gpl-2.0.txt GPL-2.0+
|
|
*/
|
|
class GroupKeyword extends Component
|
|
{
|
|
/**
|
|
* The expression that is used for grouping.
|
|
*
|
|
* @var Expression
|
|
*/
|
|
public $expr;
|
|
|
|
/**
|
|
* Constructor.
|
|
*
|
|
* @param Expression $expr the expression that we are sorting by
|
|
*/
|
|
public function __construct($expr = null)
|
|
{
|
|
$this->expr = $expr;
|
|
}
|
|
|
|
/**
|
|
* @param Parser $parser the parser that serves as context
|
|
* @param TokensList $list the list of tokens that are being parsed
|
|
* @param array $options parameters for parsing
|
|
*
|
|
* @return GroupKeyword[]
|
|
*/
|
|
public static function parse(Parser $parser, TokensList $list, array $options = array())
|
|
{
|
|
$ret = array();
|
|
|
|
$expr = new self();
|
|
|
|
/**
|
|
* The state of the parser.
|
|
*
|
|
* Below are the states of the parser.
|
|
*
|
|
* 0 --------------------[ expression ]-------------------> 1
|
|
*
|
|
* 1 ------------------------[ , ]------------------------> 0
|
|
* 1 -------------------[ ASC / DESC ]--------------------> 1
|
|
*
|
|
* @var int
|
|
*/
|
|
$state = 0;
|
|
|
|
for (; $list->idx < $list->count; ++$list->idx) {
|
|
/**
|
|
* Token parsed at this moment.
|
|
*
|
|
* @var Token
|
|
*/
|
|
$token = $list->tokens[$list->idx];
|
|
|
|
// End of statement.
|
|
if ($token->type === Token::TYPE_DELIMITER) {
|
|
break;
|
|
}
|
|
|
|
// Skipping whitespaces and comments.
|
|
if (($token->type === Token::TYPE_WHITESPACE) || ($token->type === Token::TYPE_COMMENT)) {
|
|
continue;
|
|
}
|
|
|
|
if ($state === 0) {
|
|
$expr->expr = Expression::parse($parser, $list);
|
|
$state = 1;
|
|
} elseif ($state === 1) {
|
|
if (($token->type === Token::TYPE_KEYWORD)
|
|
&& (($token->keyword === 'ASC') || ($token->keyword === 'DESC'))
|
|
) {
|
|
$expr->type = $token->keyword;
|
|
} elseif (($token->type === Token::TYPE_OPERATOR)
|
|
&& ($token->value === ',')
|
|
) {
|
|
if (! empty($expr->expr)) {
|
|
$ret[] = $expr;
|
|
}
|
|
$expr = new self();
|
|
$state = 0;
|
|
} else {
|
|
break;
|
|
}
|
|
}
|
|
}
|
|
|
|
// Last iteration was not processed.
|
|
if (! empty($expr->expr)) {
|
|
$ret[] = $expr;
|
|
}
|
|
|
|
--$list->idx;
|
|
|
|
return $ret;
|
|
}
|
|
|
|
/**
|
|
* @param GroupKeyword|GroupKeyword[] $component the component to be built
|
|
* @param array $options parameters for building
|
|
*
|
|
* @return string
|
|
*/
|
|
public static function build($component, array $options = array())
|
|
{
|
|
if (is_array($component)) {
|
|
return implode(', ', $component);
|
|
}
|
|
|
|
return trim($component->expr);
|
|
}
|
|
}
|