// +---------------------------------------------------------------------- declare (strict_types = 1); namespace think\db; use BackedEnum; use Closure; use Stringable; use think\db\BaseQuery as Query; use think\db\exception\DbException as Exception; use UnitEnum; /** * Db Builder. */ class Builder extends BaseBuilder { /** * 数据分析. * * @param Query $query 查询对象 * @param array $data 数据 * @param array $fields 字段信息 * @param array $bind 参数绑定 * * @return array */ protected function parseData(Query $query, array $data = [], array $fields = [], array $bind = []): array { if (empty($data)) { return []; } $options = $query->getOptions(); // 获取绑定信息 if (empty($bind)) { $bind = $query->getFieldsBindType(); } if (empty($fields)) { if (empty($options['field']) || '*' == $options['field']) { $fields = array_keys($bind); } else { $fields = $options['field']; } } $result = []; foreach ($data as $key => $val) { $item = $this->parseKey($query, $key, true); if ($val instanceof BackedEnum) { $val = $val->value; } elseif ($val instanceof UnitEnum) { $val = $val->name; } elseif ($val instanceof Raw) { $result[$item] = $this->parseRaw($query, $val); continue; } elseif (is_null($val) && in_array($key, $fields, true)) { $result[$item] = 'NULL'; continue; } elseif (!is_scalar($val) && (in_array($key, (array) $query->getOptions('json')) || 'json' == $query->getFieldType($key))) { $val = json_encode($val); } if (str_contains($key, '->')) { [$key, $name] = explode('->', $key, 2); $item = $this->parseKey($query, $key); $result[$item . '->' . $name] = 'json_set(' . $item . ', \'$.' . $name . '\', ' . $this->parseDataBind($query, $key . '->' . $name, $val, $bind) . ')'; } elseif (!str_contains($key, '.') && !in_array($key, $fields, true)) { if ($options['strict']) { throw new Exception('fields not exists:[' . $key . ']'); } } elseif (is_array($val) && !empty($val) && is_string($val[0])) { if (in_array(strtoupper($val[0]), ['INC', 'DEC'])) { $result[$item] = match (strtoupper($val[0])) { 'INC' => $item . ' + ' . floatval($val[1]), 'DEC' => $item . ' - ' . floatval($val[1]), }; } } elseif (is_scalar($val)) { // 过滤非标量数据 if (!$query->isAutoBind() && Connection::PARAM_STR == $bind[$key]) { $val = '\'' . $val . '\''; } $result[$item] = !$query->isAutoBind() ? $val : $this->parseDataBind($query, $key, $val, $bind); } } return $result; } /** * 数据绑定处理. * * @param Query $query 查询对象 * @param string $key 字段名 * @param mixed $data 数据 * @param array $bind 绑定数据 * * @return string */ protected function parseDataBind(Query $query, string $key, $data, array $bind = []): string { if ($data instanceof Raw) { return $this->parseRaw($query, $data); } $name = $query->bindValue($data, $bind[$key] ?? Connection::PARAM_STR); return ':' . $name; } /** * 字段名分析. * * @param Query $query 查询对象 * @param mixed $key 字段名 * @param bool $strict 严格检测 * * @return string */ public function parseKey(Query $query, string | int | Raw $key, bool $strict = false): string { return $key; } /** * 查询额外参数分析. * * @param Query $query 查询对象 * @param string $extra 额外参数 * * @return string */ protected function parseExtra(Query $query, string $extra): string { return preg_match('/^[\w]+$/i', $extra) ? ' ' . strtoupper($extra) : ''; } /** * field分析. * * @param Query $query 查询对象 * @param array $fields 字段名 * * @return string */ protected function parseField(Query $query, array $fields): string { if (empty($fields)) { return '*'; } // 支持 'field1' => 'field2' 这样的字段别名定义 $array = array_map(function ($field, $key) use ($query) { if ($field instanceof Raw) { return $this->parseRaw($query, $field); } elseif (!is_numeric($key)) { // 字段别名定义 return $this->parseKey($query, $key) . ' AS ' . $this->parseKey($query, $field, true); } else { return $this->parseKey($query, $field); } }, $fields, array_keys($fields)); return implode(',', $array); } /** * table分析. * * @param Query $query 查询对象 * @param array|string $tables 表名 * * @return string */ protected function parseTable(Query $query, array | string $tables): string { $item = []; $options = $query->getOptions(); foreach ((array) $tables as $key => $table) { if ($table instanceof Raw) { $item[] = $this->parseRaw($query, $table); } elseif (!is_numeric($key)) { $item[] = $this->parseKey($query, $key) . ' ' . $this->parseKey($query, $table); } elseif (isset($options['alias'][$table])) { $item[] = $this->parseKey($query, $table) . ' ' . $this->parseKey($query, $options['alias'][$table]); } else { $item[] = $this->parseKey($query, $table); } } return implode(',', $item); } /** * where分析. * * @param Query $query 查询对象 * @param array $where 查询条件 * * @return string */ protected function parseWhere(Query $query, array $where): string { $options = $query->getOptions(); $whereStr = $this->buildWhere($query, $where); if (!empty($options['soft_delete'])) { // 附加软删除条件 [$field, $condition] = $options['soft_delete']; $binds = $query->getFieldsBindType(); $whereStr = $whereStr ? '( ' . $whereStr . ' ) AND ' : ''; $whereStr = $whereStr . $this->parseWhereItem($query, $field, $condition, $binds); } return empty($whereStr) ? '' : ' WHERE ' . $whereStr; } /** * where子单元分析. * * @param Query $query 查询对象 * @param mixed $field 查询字段 * @param array $val 查询条件 * @param array $binds 参数绑定 * * @return string */ protected function parseWhereItem(Query $query, $field, array $val, array $binds = []): string { // 字段分析 $key = $field ? $this->parseKey($query, $field, true) : ''; [$exp, $value] = $val; // 检测操作符 if (!is_string($exp)) { throw new Exception('where express error:' . var_export($exp, true)); } $exp = strtoupper($exp); if (isset($this->exp[$exp])) { $exp = $this->exp[$exp]; } if (is_string($field) && 'LIKE' != $exp) { $bindType = $binds[$field] ?? Connection::PARAM_STR; } else { $bindType = Connection::PARAM_STR; } if ($value instanceof Raw) { } elseif ($value instanceof Stringable) { // 对象数据写入 $value = $value->__toString(); } elseif ($value instanceof BackedEnum) { $value = $value->value; } elseif ($value instanceof UnitEnum) { $value = $value->name; } if (is_scalar($value) && !in_array($exp, ['EXP', 'NOT NULL', 'NULL', 'IN', 'NOT IN', 'BETWEEN', 'NOT BETWEEN']) && !str_contains($exp, 'TIME')) { if (is_string($value) && str_starts_with($value, ':') && $query->isBind(substr($value, 1))) { } else { $name = $query->bindValue($value, $bindType); $value = ':' . $name; } } // 解析查询表达式 foreach ($this->parser as $fun => $parse) { if (in_array($exp, $parse)) { return $this->$fun($query, $key, $exp, $value, $field, $bindType, $val[2] ?? 'AND'); } } throw new Exception('where express error:' . $exp); } /** * 模糊查询. * * @param Query $query 查询对象 * @param string $key * @param string $exp * @param array $value * @param string $field * @param int $bindType * @param string $logic * * @return string */ protected function parseLike(Query $query, string $key, string $exp, $value, $field, int $bindType, string $logic): string { // 模糊匹配 if (is_array($value)) { $array = []; foreach ($value as $item) { $name = $query->bindValue($item, Connection::PARAM_STR); $array[] = $key . ' ' . $exp . ' :' . $name; } $whereStr = '(' . implode(' ' . strtoupper($logic) . ' ', $array) . ')'; } else { $whereStr = $key . ' ' . $exp . ' ' . $value; } return $whereStr; } /** * 表达式查询. * * @param Query $query 查询对象 * @param string $key * @param string $exp * @param Raw $value * @param string $field * @param int $bindType * * @return string */ protected function parseExp(Query $query, string $key, string $exp, Raw $value, string $field, int $bindType): string { // 表达式查询 return '( ' . $key . ' ' . $this->parseRaw($query, $value) . ' )'; } /** * Null查询. * * @param Query $query 查询对象 * @param string $key * @param string $exp * @param mixed $value * @param string $field * @param int $bindType * * @return string */ protected function parseNull(Query $query, string $key, string $exp, $value, $field, int $bindType): string { // NULL 查询 return $key . ' IS ' . $exp; } /** * 范围查询. * * @param Query $query 查询对象 * @param string $key * @param string $exp * @param mixed $value * @param string $field * @param int $bindType * * @return string */ protected function parseBetween(Query $query, string $key, string $exp, array | string $value, $field, int $bindType): string { // BETWEEN 查询 $data = is_array($value) ? $value : explode(',', $value); $min = $query->bindValue($data[0], $bindType); $max = $query->bindValue($data[1], $bindType); return $key . ' ' . $exp . ' :' . $min . ' AND :' . $max . ' '; } /** * IN查询. * * @param Query $query 查询对象 * @param string $key * @param string $exp * @param mixed $value * @param string $field * @param int $bindType * * @return string */ protected function parseIn(Query $query, string $key, string $exp, $value, $field, int $bindType): string { // IN 查询 if ($value instanceof Closure) { $value = $this->parseClosure($query, $value, false); } elseif ($value instanceof Raw) { $value = $this->parseRaw($query, $value); } else { $value = array_unique(is_array($value) ? $value : explode(',', (string) $value)); if (count($value) === 0) { return 'IN' == $exp ? '0 = 1' : '1 = 1'; } if ($query->isAutoBind()) { $array = []; foreach ($value as $v) { $name = $query->bindValue($v, $bindType); $array[] = ':' . $name; } $value = implode(',', $array); } elseif (Connection::PARAM_STR == $bindType) { $value = '\'' . implode('\',\'', $value) . '\''; } else { $value = implode(',', $value); } if (!str_contains($value, ',')) { return $key . ('IN' == $exp ? ' = ' : ' <> ') . $value; } } return $key . ' ' . $exp . ' (' . $value . ')'; } /** * 日期时间条件解析. * * @param Query $query 查询对象 * @param mixed $value * @param string $key * @param int $bindType * * @return string */ protected function parseDateTime(Query $query, $value, string $key, int $bindType): string { $options = $query->getOptions(); // 获取时间字段类型 if (str_contains($key, '.')) { [$table, $key] = explode('.', $key); if (isset($options['alias']) && $pos = array_search($table, $options['alias'])) { $table = $pos; } } else { $table = $options['table']; } $type = $query->getFieldType($key); if ($type) { if (is_string($value)) { $value = strtotime($value) ?: $value; } if (is_int($value)) { if (preg_match('/(datetime|timestamp)/is', $type)) { // 日期及时间戳类型 $value = date('Y-m-d H:i:s', $value); } elseif (preg_match('/(date)/is', $type)) { // 日期及时间戳类型 $value = date('Y-m-d', $value); } } } $name = $query->bindValue($value, $bindType); return ':' . $name; } /** * limit分析. * * @param Query $query 查询对象 * @param mixed $limit * * @return string */ protected function parseLimit(Query $query, string $limit): string { return (!empty($limit) && !str_contains($limit, '(')) ? ' LIMIT ' . $limit . ' ' : ''; } /** * join分析. * * @param Query $query 查询对象 * @param array $join * * @return string */ protected function parseJoin(Query $query, array $join): string { $joinStr = ''; foreach ($join as $item) { [$table, $type, $on] = $item; if (str_contains($on, '=')) { [$val1, $val2] = explode('=', $on, 2); $condition = $this->parseKey($query, $val1) . '=' . $this->parseKey($query, $val2); } else { $condition = $on; } $table = $this->parseTable($query, $table); $joinStr .= ' ' . $type . ' JOIN ' . $table . ' ON ' . $condition; } return $joinStr; } /** * order分析. * * @param Query $query 查询对象 * @param array $order * * @return string */ protected function parseOrder(Query $query, array $order): string { $array = []; foreach ($order as $key => $val) { if ($val instanceof Raw) { $array[] = $this->parseRaw($query, $val); } elseif (is_array($val) && preg_match('/^[\w\.]+$/', $key)) { $array[] = $this->parseOrderField($query, $key, $val); } elseif ('[rand]' == $val) { $array[] = $this->parseRand($query); } elseif (is_string($val)) { if (is_numeric($key)) { [$key, $sort] = explode(' ', str_contains($val, ' ') ? $val : $val . ' '); } else { $sort = $val; } if (preg_match('/^[\w\.]+$/', $key)) { $sort = strtoupper($sort); $sort = in_array($sort, ['ASC', 'DESC'], true) ? ' ' . $sort : ''; $array[] = $this->parseKey($query, $key, true) . $sort; } else { throw new Exception('order express error:' . $key); } } } return empty($array) ? '' : ' ORDER BY ' . implode(',', $array); } /** * 分析Raw对象 * * @param Query $query 查询对象 * @param Raw $raw Raw对象 * * @return string */ protected function parseRaw(Query $query, Raw $raw): string { $sql = $raw->getValue(); $bind = $raw->getBind(); if ($bind) { $query->bindParams($sql, $bind); } return $sql; } /** * 随机排序. * * @param Query $query 查询对象 * * @return string */ protected function parseRand(Query $query): string { return ''; } /** * orderField分析. * * @param Query $query 查询对象 * @param string $key * @param array $val * * @return string */ protected function parseOrderField(Query $query, string $key, array $val): string { if (isset($val['sort'])) { $sort = $val['sort']; unset($val['sort']); } else { $sort = ''; } $sort = strtoupper($sort); $sort = in_array($sort, ['ASC', 'DESC'], true) ? ' ' . $sort : ''; $bind = $query->getFieldsBindType(); foreach ($val as $k => $item) { $val[$k] = $this->parseDataBind($query, $key, $item, $bind); } return 'field(' . $this->parseKey($query, $key, true) . ',' . implode(',', $val) . ')' . $sort; } /** * group分析. * * @param Query $query 查询对象 * @param mixed $group * * @return string */ protected function parseGroup(Query $query, string | array $group): string { if (empty($group)) { return ''; } if (is_string($group)) { $group = explode(',', $group); } $val = []; foreach ($group as $key) { $val[] = $this->parseKey($query, $key); } return ' GROUP BY ' . implode(',', $val); } /** * having分析. * * @param Query $query 查询对象 * @param string $having * * @return string */ protected function parseHaving(Query $query, string $having): string { return !empty($having) ? ' HAVING ' . $having : ''; } /** * comment分析. * * @param Query $query 查询对象 * @param string $comment * * @return string */ protected function parseComment(Query $query, string $comment): string { if (str_contains($comment, '*/')) { $comment = strstr($comment, '*/', true); } return !empty($comment) ? ' /* ' . $comment . ' */' : ''; } /** * distinct分析. * * @param Query $query 查询对象 * @param mixed $distinct * * @return string */ protected function parseDistinct(Query $query, bool $distinct): string { return !empty($distinct) ? ' DISTINCT ' : ''; } /** * index分析,可在操作链中指定需要强制使用的索引. * * @param Query $query 查询对象 * @param mixed $index * * @return string */ protected function parseForce(Query $query, string | array $index): string { if (empty($index)) { return ''; } if (is_array($index)) { $index = implode(',', $index); } return sprintf(' FORCE INDEX ( %s ) ', $index); } /** * 设置锁机制. * * @param Query $query 查询对象 * @param bool|string $lock * * @return string */ protected function parseLock(Query $query, bool | string $lock = false): string { if (is_bool($lock)) { return $lock ? ' FOR UPDATE ' : ''; } if (is_string($lock) && !empty($lock)) { return ' ' . trim($lock) . ' '; } return ''; } /** * 生成insertall SQL. * * @param Query $query 查询对象 * @param array $keys 字段名 * @param array $datas 数据 * * @return string */ public function insertAllByKeys(Query $query, array $keys, array $datas): string { $options = $query->getOptions(); // 获取绑定信息 $bind = $query->getFieldsBindType(); $fields = []; $values = []; foreach ($keys as $field) { $fields[] = $this->parseKey($query, $field); } foreach ($datas as $k => $data) { foreach ($data as $key => &$val) { if (!$query->isAutoBind()) { $val = Connection::PARAM_STR == $bind[$keys[$key]] ? '\'' . $val . '\'' : $val; } else { $val = $this->parseDataBind($query, $keys[$key], $val, $bind); } } $values[] = 'SELECT ' . implode(',', $data); } return str_replace( ['%INSERT%', '%TABLE%', '%EXTRA%', '%FIELD%', '%DATA%', '%COMMENT%'], [ !empty($options['replace']) ? 'REPLACE' : 'INSERT', $this->parseTable($query, $options['table']), $this->parseExtra($query, $options['extra']), implode(' , ', $fields), implode(' UNION ALL ', $values), $this->parseComment($query, $options['comment']), ], $this->insertAllSql ); } }