| @@ 29-130 (lines=102) @@ | ||
| 26 | * @version 2.0.0 |
|
| 27 | * @since 2.0.0 added |
|
| 28 | */ |
|
| 29 | trait GroupTrait |
|
| 30 | { |
|
| 31 | use AbstractTrait; |
|
| 32 | ||
| 33 | /** |
|
| 34 | * {@inheritDoc} |
|
| 35 | */ |
|
| 36 | public function group($col) |
|
| 37 | { |
|
| 38 | // support multiple group by |
|
| 39 | if (func_num_args() > 1) { |
|
| 40 | $col = func_get_args(); |
|
| 41 | } |
|
| 42 | return $this->realGroup($col); |
|
| 43 | } |
|
| 44 | ||
| 45 | /** |
|
| 46 | * {@inheritDoc} |
|
| 47 | */ |
|
| 48 | public function groupDesc($col) |
|
| 49 | { |
|
| 50 | // support multiple group by |
|
| 51 | if (func_num_args() > 1) { |
|
| 52 | $col = func_get_args(); |
|
| 53 | } |
|
| 54 | return $this->realGroup($col, 'DESC'); |
|
| 55 | } |
|
| 56 | ||
| 57 | /** |
|
| 58 | * {@inheritDoc} |
|
| 59 | */ |
|
| 60 | public function groupTpl(/*# string */ $template, $col, array $params = []) |
|
| 61 | { |
|
| 62 | $template = $this->positionedParam($template, $params); |
|
| 63 | return $this->realGroup(new Template($template, $col), '', true); |
|
| 64 | } |
|
| 65 | ||
| 66 | /** |
|
| 67 | * {@inheritDoc} |
|
| 68 | */ |
|
| 69 | public function groupRaw(/*# string */ $rawString, array $params = []) |
|
| 70 | { |
|
| 71 | $rawString = $this->positionedParam($rawString, $params); |
|
| 72 | return $this->realGroup($rawString, '', true); |
|
| 73 | } |
|
| 74 | ||
| 75 | /** |
|
| 76 | * real group by |
|
| 77 | * @param string|string[]|Template $col column[s] |
|
| 78 | * @param string $suffix ''|ASC|DESC |
|
| 79 | * @param bool $rawMode |
|
| 80 | * @return $this |
|
| 81 | * @access protected |
|
| 82 | */ |
|
| 83 | protected function realGroup( |
|
| 84 | $col, |
|
| 85 | /*# sting */ $suffix = '', |
|
| 86 | /*# bool */ $rawMode = false |
|
| 87 | ) { |
|
| 88 | ||
| 89 | if (is_array($col)) { |
|
| 90 | $this->multipleGroup($col, $suffix); |
|
| 91 | } else { |
|
| 92 | $clause = &$this->getClause('GROUP BY'); |
|
| 93 | $part = [$col, $this->isRaw($col, $rawMode)]; |
|
| 94 | if (!empty($suffix)) { |
|
| 95 | $part[] = $suffix; |
|
| 96 | } |
|
| 97 | $clause[] = $part; |
|
| 98 | } |
|
| 99 | return $this; |
|
| 100 | } |
|
| 101 | ||
| 102 | /** |
|
| 103 | * Multitple groupbys |
|
| 104 | * |
|
| 105 | * @param array $cols |
|
| 106 | * @param string $suffix |
|
| 107 | * @access protected |
|
| 108 | */ |
|
| 109 | protected function multipleGroup(array $cols, /*# string */ $suffix) |
|
| 110 | { |
|
| 111 | foreach ($cols as $col) { |
|
| 112 | $this->realGroup($col, $suffix); |
|
| 113 | } |
|
| 114 | } |
|
| 115 | ||
| 116 | /** |
|
| 117 | * Build GROUP BY |
|
| 118 | * |
|
| 119 | * @param string $prefix |
|
| 120 | * @param array $settings |
|
| 121 | * @return string |
|
| 122 | * @access protected |
|
| 123 | */ |
|
| 124 | protected function buildGroup( |
|
| 125 | /*# string */ $prefix, |
|
| 126 | array $settings |
|
| 127 | )/*# : string */ { |
|
| 128 | return $this->buildClause('GROUP BY', $prefix, $settings); |
|
| 129 | } |
|
| 130 | } |
|
| 131 | ||
| @@ 31-130 (lines=100) @@ | ||
| 28 | * @version 2.0.0 |
|
| 29 | * @since 2.0.0 added |
|
| 30 | */ |
|
| 31 | trait OrderTrait |
|
| 32 | { |
|
| 33 | use AbstractTrait; |
|
| 34 | ||
| 35 | /** |
|
| 36 | * {@inheritDoc} |
|
| 37 | */ |
|
| 38 | public function order($col) |
|
| 39 | { |
|
| 40 | if (func_num_args() > 1) { |
|
| 41 | $col = func_get_args(); |
|
| 42 | } |
|
| 43 | return $this->realOrder($col, 'ASC'); |
|
| 44 | } |
|
| 45 | ||
| 46 | /** |
|
| 47 | * {@inheritDoc} |
|
| 48 | */ |
|
| 49 | public function orderDesc($col) |
|
| 50 | { |
|
| 51 | if (func_num_args() > 1) { |
|
| 52 | $col = func_get_args(); |
|
| 53 | } |
|
| 54 | return $this->realOrder($col, 'DESC'); |
|
| 55 | } |
|
| 56 | ||
| 57 | /** |
|
| 58 | * {@inheritDoc} |
|
| 59 | */ |
|
| 60 | public function orderTpl(/*# string */ $template, $col, array $params = []) |
|
| 61 | { |
|
| 62 | $template = $this->positionedParam($template, $params); |
|
| 63 | return $this->realOrder(new Template($template, $col), '', true); |
|
| 64 | } |
|
| 65 | ||
| 66 | /** |
|
| 67 | * {@inheritDoc} |
|
| 68 | */ |
|
| 69 | public function orderRaw(/*# string */ $rawString, array $params = []) |
|
| 70 | { |
|
| 71 | $rawString = $this->positionedParam($rawString, $params); |
|
| 72 | return $this->realOrder($rawString, '', true); |
|
| 73 | } |
|
| 74 | ||
| 75 | /** |
|
| 76 | * Real orderby |
|
| 77 | * |
|
| 78 | * @param string|string[]|Template $col |
|
| 79 | * @param string $suffix 'ASC' or 'DESC' |
|
| 80 | * @param bool $rawMode |
|
| 81 | * @return $this |
|
| 82 | * @access protected |
|
| 83 | */ |
|
| 84 | protected function realOrder( |
|
| 85 | $col, |
|
| 86 | /*# sting */ $suffix = 'ASC', |
|
| 87 | /*# bool */ $rawMode = false |
|
| 88 | ) { |
|
| 89 | if (is_array($col)) { |
|
| 90 | $this->multipleOrder($col, $suffix); |
|
| 91 | } else { |
|
| 92 | $clause = &$this->getClause('ORDER BY'); |
|
| 93 | $part = [$col, $this->isRaw($col, $rawMode)]; |
|
| 94 | if (!empty($suffix)) { |
|
| 95 | $part[] = $suffix; |
|
| 96 | } |
|
| 97 | $clause[] = $part; |
|
| 98 | } |
|
| 99 | return $this; |
|
| 100 | } |
|
| 101 | ||
| 102 | /** |
|
| 103 | * Multitple orderbys |
|
| 104 | * |
|
| 105 | * @param array $cols |
|
| 106 | * @param string $suffix 'ASC' or 'DESC' |
|
| 107 | * @access protected |
|
| 108 | */ |
|
| 109 | protected function multipleOrder(array $cols, /*# sting */ $suffix) |
|
| 110 | { |
|
| 111 | foreach ($cols as $col) { |
|
| 112 | $this->realOrder($col, $suffix); |
|
| 113 | } |
|
| 114 | } |
|
| 115 | ||
| 116 | /** |
|
| 117 | * Build ORDER BY |
|
| 118 | * |
|
| 119 | * @param string $prefix |
|
| 120 | * @param array $settings |
|
| 121 | * @return string |
|
| 122 | * @access protected |
|
| 123 | */ |
|
| 124 | protected function buildOrder( |
|
| 125 | /*# string */ $prefix, |
|
| 126 | array $settings |
|
| 127 | )/*# : string */ { |
|
| 128 | return $this->buildClause('ORDER BY', $prefix, $settings); |
|
| 129 | } |
|
| 130 | } |
|
| 131 | ||