Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 28 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -40,4 +40,31 @@ composer require topthink/think-orm

[![](https://www.topthink.com/uploads/assistant/20230630/4d1a3f0ad2958b49bb8189b7ef824cb0.png)](https://chat.topthink.com/)

ThinkPHP 生态服务由[顶想云](https://www.topthink.com)(TOPThink Cloud)提供,为生态提供专业的开发者服务和价值之选。
ThinkPHP 生态服务由[顶想云](https://www.topthink.com)(TOPThink Cloud)提供,为生态提供专业的开发者服务和价值之选。

## KingbaseES 使用注意事项

### Oracle 兼容模式的字段名称

在连接 DSN 的 `options` 中设置 `-c enable_upper_colname=off`,避免服务端自动将查询结果列名转为大写。业务输入、Model 主键及查询结果的字段键需要使用一致的大小写约定。

业务统一使用 `ID`、`NAME` 等大写字段键时,在连接配置的 `params` 中设置 `PDO::ATTR_CASE => PDO::CASE_UPPER`。原框架按该配置处理元数据字段键,PDO 按该配置处理查询结果列名,无需修改业务代码或自定义 Query 的父类。例如,以下为连接配置片段:

```php
'dsn' => "kdb:host=127.0.0.1;port=15422;dbname=oracle;options='-c enable_upper_colname=off'",
'params' => [
PDO::ATTR_CASE => PDO::CASE_UPPER,
],
```

主机、端口和数据库名称按实际环境填写;已有 `options` 或其他 PDO 参数时,应合并配置,不要覆盖原有设置。

业务使用精确小写或混合大小写字段名时,保留 `PDO::CASE_NATURAL`,不要强制设置 `CASE_UPPER`,以免改变字段名及显式别名。适配层不自动改写业务字段键,也不保证同一连接能够任意混用多套大小写约定。

更改大小写策略后,应重建连接并清理相应字段缓存;采用不同策略的连接不要共用同一份字段缓存。

### MySQL 兼容模式的多态关联分组

对于部分`has()`、`hasWhere()`生成的等值内连接查询,金仓构造器会在原关联外键分组后补充主表主键。适配前先读取物理目录,确认普通表、有效单列整数主键及同类型非空关联列,保留原WHERE、HAVING、软删除及参数绑定规则。

该处理仅覆盖已验证的简单小写物理表名、主表字段投影及单个内连接结构。复杂连接、外连接、继承/分区表、其他主键类型和分布式连接继续沿用原流程,不自动猜测改写。`fetchSql()`等只生成SQL的调用也沿用原分组规则,不为此适配额外访问数据库。
125 changes: 125 additions & 0 deletions src/db/builder/KingbaseMysql.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,125 @@
<?php

// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2025 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
declare(strict_types=1);

namespace think\db\builder;

use think\db\BaseQuery as Query;
use think\db\Connection;
use think\db\Raw;

/**
* KingbaseES MySQL 兼容模式 SQL 构造器。
*/
class KingbaseMysql extends Mysql
{
/**
* 为等值内连接的主表投影补充分组主键。
*
* 多态关联会按关联外键分组并返回主表全部字段。只有结构及物理目录能证明
* 每个原分组只对应一个真实主键时,才保留原分组并补充该主键;不改查询状态、
* HAVING、绑定值或软删除条件。离线SQL生成、分布式连接及未验证的复杂结构
* 沿用原流程,避免使用另一物理连接的目录属性作为证明。
*/
protected function parseGroup(Query $query, string|array $group): string
{
$options = $query->getOptions();
$groups = is_string($group) ? explode(',', $group) : array_values($group);
$joins = $options['join'] ?? [];
if (!$query->getModel() || !empty($options['fetch_sql']) || count($groups) !== 1
|| !is_string($groups[0]) || count($joins) !== 1) {
return parent::parseGroup($query, $group);
}

$main = $this->parseGroupTable($options['table'] ?? null, $options['alias'] ?? []);
$join = reset($joins);
if (!$main || !is_array($join) || count($join) !== 3
|| !in_array($join[1], ['', 'INNER'], true) || !is_string($join[2])
|| array_values($options['field'] ?? []) !== [$main[1] . '.*']) {
return parent::parseGroup($query, $group);
}

$related = $this->parseGroupTable($join[0]);
$identifier = '[A-Za-z_][A-Za-z0-9_]*';
if (!$related || $main[1] === $related[1]
|| !preg_match('/\A\s*(' . $identifier . ')\.(' . $identifier . ')\s*=\s*(' . $identifier . ')\.(' . $identifier . ')\s*\z/', $join[2], $on)) {
return parent::parseGroup($query, $group);
}
if ($on[1] === $related[1] && $on[3] === $main[1]) {
$on = ['', $on[3], $on[4], $on[1], $on[2]];
}
if ($on[1] !== $main[1] || $on[3] !== $related[1]
|| trim($groups[0]) !== $related[1] . '.' . $on[4]) {
return parent::parseGroup($query, $group);
}

$connection = $query->getConnection();
if (!$connection instanceof \think\db\connector\KingbaseMysql
|| !empty($connection->getConfig('deploy'))
|| !$connection->canSupplementGroupByPrimaryKey($main[0], $on[2], $related[0], $on[4])) {
return parent::parseGroup($query, $group);
}
$groups[] = $main[1] . '.' . $on[2];

return parent::parseGroup($query, $groups);
}

/** 仅识别简单小写物理表名和普通别名,不猜测Raw、子查询及复杂引用。 */
private function parseGroupTable($table, array $aliases = []): ?array
{
$alias = null;
if (is_array($table)) {
if (count($table) !== 1 || !is_string(key($table)) || !is_string(current($table))) {
return null;
}
$alias = current($table);
$table = key($table);
}
$identifier = '[A-Za-z_][A-Za-z0-9_]*';
$tableName = '[a-z_][a-z0-9_]*';
if (!is_string($table) || !preg_match('/\A' . $tableName . '(?:\.' . $tableName . ')?\z/', $table)) {
return null;
}
$alias = $alias ?? ($aliases[$table] ?? (str_contains($table, '.') ? substr($table, strrpos($table, '.') + 1) : $table));

return is_string($alias) && preg_match('/\A' . $identifier . '\z/', $alias) ? [$table, $alias] : null;
}

/**
* 生成写入参数占位符,适配整数列的布尔绑定。
*
* Model 的 bool 配置可能覆盖整数列的绑定类型;此时按实际字段绑定信息
* 使用 1/0 整数参数,避免 PDO_KDB
* 发送 t/f。真正的 BOOLEAN 列、NULL 和其他绑定类型仍沿用原处理。
*
* @param Query $query 当前查询对象
* @param string $key 字段名或 JSON 路径
* @param mixed $data 待绑定数据
* @param array $bind 字段绑定类型映射
*
* @return string SQL 参数占位表达式
*/
protected function parseDataBind(Query $query, string $key, $data, array $bind = []): string
{
if (null !== $data && !($data instanceof Raw) && !str_contains($key, '->')
&& Connection::PARAM_BOOL === ($bind[$key] ?? null)) {
// 读取连接器已有的字段缓存,不使用被 Model 类型配置覆盖的字段映射。
$table = $query->getTable();
$fieldBind = is_string($table) || (is_array($table) && 1 === count($table))
? $query->getConnection()->getTableInfo($table, 'bind') : [];
if (Connection::PARAM_INT === ($fieldBind[$key] ?? null)) {
$data = $data ? 1 : 0;
$bind[$key] = Connection::PARAM_INT;
}
}

return parent::parseDataBind($query, $key, $data, $bind);
}
}
114 changes: 114 additions & 0 deletions src/db/builder/KingbaseOracle.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,114 @@
<?php

// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2025 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
declare(strict_types=1);

namespace think\db\builder;

use think\db\BaseQuery as Query;
use think\db\Connection;

/**
* KingbaseES Oracle 兼容模式 SQL 构造器。
*/
class KingbaseOracle extends Oracle
{
/**
* 使用 VALUES 语法构造多行 INSERT。
*
* PDO_KDB 无法在父 Oracle Builder 的 UNION ALL SELECT 批量写法中稳定推断
* BLOB 等目标列的占位符类型,因此仅改写 SQL 结构;字段和值仍按原框架的
* 数组迭代顺序处理。
*/
public function insertAll(Query $query, array $dataSet): string
{
$options = $query->getOptions();
$bind = $query->getFieldsBindType();

if (empty($options['field']) || '*' == $options['field']) {
$allowFields = array_keys($bind);
} else {
$allowFields = $options['field'];
}

$values = [];
$insertFields = null;

foreach ($dataSet as $data) {
$data = $this->parseData($query, $data, $allowFields, $bind);

if (null === $insertFields) {
$insertFields = array_keys($data);
}
$values[] = '( ' . implode(',', array_values($data)) . ' )';
}

if (null === $insertFields) {
return '';
}

$fields = [];
foreach ($insertFields as $field) {
$fields[] = $this->parseKey($query, $field);
}

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),
'VALUES ' . implode(' , ', $values),
$this->parseComment($query, $options['comment']),
],
$this->insertAllSql
);
}

/** 使用 VALUES 语法构造固定字段批量 INSERT。 */
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 $data) {
foreach ($data as $key => &$val) {
$field = $keys[$key];

if (!$query->isAutoBind()) {
$val = Connection::PARAM_STR == $bind[$field] ? '\'' . $val . '\'' : $val;
} else {
$val = $this->parseDataBind($query, $field, $val, $bind);
}
}

$values[] = '( ' . 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),
'VALUES ' . implode(' , ', $values),
$this->parseComment($query, $options['comment']),
],
$this->insertAllSql
);
}
}
19 changes: 19 additions & 0 deletions src/db/builder/KingbaseSqlsrv.php
Original file line number Diff line number Diff line change
@@ -0,0 +1,19 @@
<?php

// +----------------------------------------------------------------------
// | ThinkPHP [ WE CAN DO IT JUST THINK ]
// +----------------------------------------------------------------------
// | Copyright (c) 2006~2025 http://thinkphp.cn All rights reserved.
// +----------------------------------------------------------------------
// | Licensed ( http://www.apache.org/licenses/LICENSE-2.0 )
// +----------------------------------------------------------------------
declare(strict_types=1);

namespace think\db\builder;

/**
* KingbaseES SQL Server 兼容模式 SQL 构造器,直接沿用原 Sqlsrv 生成规则。
*/
class KingbaseSqlsrv extends Sqlsrv
{
}
Loading