ThinkPHP配置GaussDB(for MySQL)数据库:华为云数据库在ThinkPHP中的兼容性配置

风辰大大_2021

风辰大大_2021

2026-05-23

221人浏览

原创

thinkphp 默认连不上 gaussdb(for mysql) 是因 gaussdb 默认启用严格 sql 模式(如 strict_trans_tables),导致 thinkphp 自动生成的非严格兼容 sql(如 group by 非聚合字段、datetime 插入空字符串等)在执行阶段报错,而非连接失败;必须在 database.php 的 'params' 中显式设置 pdo::mysql_attr_init_command => "set sql_mode = 'no_auto_create_user,no_engine_substitution'" 并启用 pdo::attr_emulate_prepares => true 才能正常运行。

thinkphp配置gaussdb(for mysql)数据库:华为云数据库在thinkphp中的兼容性配置

ThinkPHP 能直接连 GaussDB(for MySQL),但必须关掉 strict 模式,否则 INSERT ... ON DUPLICATE KEY UPDATE 会报错。

为什么 ThinkPHP 默认连不上 GaussDB(for MySQL)

GaussDB(for MySQL) 虽然兼容 MySQL 协议,但它底层是基于 PostgreSQL 改造的分布式数据库,SQL 行为更接近 MySQL 5.7+,但默认开启严格模式(sql_mode=STRICT_TRANS_TABLES,NO_ENGINE_SUBSTITUTION)时,会对 ThinkPHP 自动生成的某些 SQL 做额外校验,比如:

  • INSERT INTO ... SELECT ... 中字段数量不完全匹配时直接拒绝执行
  • GROUP BY 非聚合字段未出现在 SELECT 列表中时报错(MySQL 5.7 默认允许,GaussDB 默认不允许)
  • datetime 类型插入空字符串或非法时间时抛异常(ThinkPHP 的 create_time 自动填充可能触发)

这些不是连接失败,而是查询执行阶段报错,错误信息通常是:ERROR 1055 (42000): Expression #1 of SELECT list is not in GROUP BY clause 或类似。

ThinkPHP 6.x 数据库配置要点

在 config/database.php 中,关键修改项如下:

amphp
amphp

使用 AMPHP 框架编写非阻塞异步 PHP 代码,依赖 revolt/event-loop、amphp/amp ^3 及完整 amphp/* 生态(http‑server、http‑client 等)。

下载
  • 'hostname' 填 GaussDB 实例的内网地址(如 gaussdb-mysql-xxxxxx.gaussdb.rds.huaweicloud.com),不要用公网地址
  • 'database' 必须是创建时指定的、DBCOMPATIBILITY='M' 的数据库名(不能是 template0 或 O/B 兼容模式)
  • 'hostname' 和 'port' 确保能被服务器 telnet 通(华为云安全组要放行 3306)
  • 'params' 中必须显式关闭严格模式:
    'params' => [
        \PDO::ATTR_EMULATE_PREPARES => true,
        \PDO::MYSQL_ATTR_INIT_COMMAND => "SET sql_mode = 'NO_AUTO_CREATE_USER,NO_ENGINE_SUBSTITUTION';"
    ]

注意:\PDO::ATTR_EMULATE_PREPARES => true 是必须的,否则 GaussDB 的预处理协议兼容层可能返回字段元信息异常,导致 Db::name('user')->find() 返回空数组。

迁移时容易漏掉的 GaussDB M 模式配置

GaussDB 控制台创建数据库时,默认是 O(Oracle)兼容模式。ThinkPHP 连接前必须确认该数据库是 M 模式,否则连得上也跑不了业务 SQL:

  • 建库语句必须带 DBCOMPATIBILITY='M',例如:
    CREATE DATABASE myapp_db ENCODING='UTF8' DBCOMPATIBILITY='M';
  • 如果已有数据库是 O/B 模式,无法在线修改兼容模式,只能导出再重建
  • 连接后执行 SELECT VERSION(); 应返回类似 8.0.32-GaussDB(for MySQL),而非 14.0(那是 PG 内核版本,说明连错了模式)
  • 部分 ThinkPHP 扩展(如多语言字段自动切换)依赖 INFORMATION_SCHEMA.COLUMNS 的列名格式,M 模式下才和 MySQL 一致;B 模式下字段名会带双引号或大小写敏感,导致 Db::field('name') 失效

备份与事务行为差异

ThinkPHP 的 Db::transaction() 在 GaussDB 上能用,但要注意两点:

  • GaussDB 不支持 SAVEPOINT 嵌套回滚(即 Db::startTrans() 后再嵌套 Db::startTrans() 会失败),建议业务层避免多层事务包装
  • 使用 Db::backup()(非官方扩展)或自定义 mysqldump 命令备份时,必须加 --set-gtid-purged=OFF 参数,否则恢复时报 GTID_PURGED cannot be changed
  • 华为云控制台「自动备份」生成的是 .qp 格式,不能直接用 mysql 命令恢复,需先用 flexusrds 工具解包

最常被忽略的是:GaussDB 的 autocommit 默认为 ON,但 ThinkPHP 的 Db::execute() 执行 DDL(如 ALTER TABLE)后,会隐式提交当前事务——这点和原生 MySQL 一致,但开发时容易误以为还能 rollback。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关文章

数码产品性能查询
数码产品性能查询

该软件包括了市面上所有手机CPU,手机跑分情况,电脑CPU,电脑产品信息等等,方便需要大家查阅数码产品最新情况,了解产品特性,能够进行对比选择最具性价比的商品。

下载

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

9384

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

5661

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2055

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3528

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4214

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3291

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

4677

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

3662

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11682

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PostgreSQL vs MySQL
PostgreSQL vs MySQL

共1课时 | 176人学习

使用phpenv集成环境安装极致CMS
使用phpenv集成环境安装极致CMS

共2课时 | 279人学习