PHP信创=ThinkPHPThinkPHP信创生态部署操作指南与国产中间件适配方案

--- ThinkPHP 信创生态部署操作指南 什么是信创 信创信息技术应用创新简单说就是用国产的操作系统、数据库、中间件替换掉 Windows/MySQL/Nginx 这些外国产品。 --- 一、信创技术栈全景图 ┌─────────────────────────────────────────────────────┐ │ 你的 ThinkPHP 应用 │ ├─────────────────────────────────────────────────────┤ │ Web服务器层 │ Nginx / 东方通TongWeb / 宝兰德BES │ ├─────────────────────────────────────────────────────┤ │ PHP运行时 │ PHP7.4/8.0/8.1│ ├─────────────────────────────────────────────────────┤ │ 数据库层 │ 达梦DM / 人大金仓KingbaseES / │ │ │ OpenGauss / 瀚高HighGo │ ├─────────────────────────────────────────────────────┤ │ 缓存层 │ Redis国产替代TongRDS │ ├─────────────────────────────────────────────────────┤ │ 操作系统层 │ 统信UOS / 麒麟Kylin / 中标麒麟 │ └─────────────────────────────────────────────────────┘ --- 二、项目结构 myapp/ ├── app/ │ ├── controller/ │ ├── model/ │ └── service/ ├── config/ │ ├── database.php ← 数据库配置重点 │ ├── cache.php │ └── app.php ├── extend/ │ └── driver/ ← 自定义数据库驱动放这里 ├── public/ │ └── index.php ├── composer.json └── .env --- 三、composer.json — 引入最佳国产适配库{name:mycompany/myapp,require:{php:7.4,topthink/framework:^6.1,topthink/think-orm:^2.0,topthink/think-migration:^3.0,xiaocheng-keji/think-dm:^3.0,ext-pdo:*,ext-pdo_pgsql:*},require-dev:{topthink/think-trace:^1.0},autoload:{psr-4:{app\\:app/,extend\\:extend/}},config:{optimize-autoloader:true,preferred-install:dist}}▎ 大白话xiaocheng-keji/think-dm 是目前最成熟的达梦数据库 ThinkPHP 驱动GitHub 上有持续维护。PostgreSQL ▎ 系人大金仓、OpenGauss、瀚高直接用 PHP 自带的 pdo_pgsql 扩展就行不需要额外装包。 --- 四、各国产数据库配置4.1达梦数据库DM8 // config/database.php?phpreturn[defaultenv(DB_DRIVER,dm),connections[//达梦 DM8dm[type\xiaocheng\dm\Dm, // think-dm 驱动hostnameenv(DB_HOST,192.168.1.100),databaseenv(DB_NAME,TESTDB),usernameenv(DB_USER,SYSDBA),passwordenv(DB_PASS,SYSDBA001),hostportenv(DB_PORT,5236),charsetutf8,prefixtp_,params[// 达梦特有schema 名称相当于 MySQL 的库名 PDO::ATTR_STRINGIFY_FETCHESfalse,],schemaenv(DB_SCHEMA,SYSDBA), // 达梦的 schema], //MySQL兜底/开发用mysql[typemysql,hostname127.0.0.1,databasemyapp,usernameroot,password,hostport3306,charsetutf8mb4,prefixtp_,],],];4.2人大金仓 KingbaseESPostgreSQL 兼容 // config/database.php 中的 connections 里加kingbase[typepgsql, // 直接用 ThinkPHP 内置 pgsql 驱动hostnameenv(DB_HOST,192.168.1.101),databaseenv(DB_NAME,test),usernameenv(DB_USER,system),passwordenv(DB_PASS,manager),hostportenv(DB_PORT,54321), // 金仓默认端口54321charsetutf8,prefixtp_,schemapublic,params[PDO::ATTR_STRINGIFY_FETCHESfalse, PDO::ATTR_EMULATE_PREPARESfalse,],],4.3OpenGauss / 华为 GaussDBgaussdb[typepgsql, // OpenGauss 完全兼容 PostgreSQL 协议hostnameenv(DB_HOST,192.168.1.102),databaseenv(DB_NAME,postgres),usernameenv(DB_USER,gaussdb),passwordenv(DB_PASS,Gauss123),hostportenv(DB_PORT,5432),charsetutf8,prefixtp_,schemapublic,],4.4瀚高数据库 HighGohighgo[typepgsql, // 瀚高基于 PostgreSQL协议兼容hostnameenv(DB_HOST,192.168.1.103),databaseenv(DB_NAME,highgo),usernameenv(DB_USER,highgo),passwordenv(DB_PASS,Hello123),hostportenv(DB_PORT,5866), // 瀚高默认端口5866charsetutf8,prefixtp_,schemapublic,], --- 五、.env 环境变量文件# .env — 不同环境改这里代码不用动APP_ENVproductionAPP_DEBUGfalse# 选择用哪个数据库dm / kingbase / gaussdb / highgo / mysqlDB_DRIVERdmDB_HOST192.168.1.100DB_PORT5236DB_NAMETESTDBDB_USERSYSDBADB_PASSSYSDBA001DB_SCHEMASYSDBA# Redis 缓存REDIS_HOST127.0.0.1REDIS_PORT6379REDIS_PASS--- 六、达梦数据库专用适配层 达梦和 MySQL 有几个坑需要写一个适配服务统一处理?php // app/service/DatabaseCompatService.php namespace app\service;/** * 信创数据库兼容层 * 解决达梦/金仓与 MySQL 的 SQL 语法差异 */ class DatabaseCompatService{/** * 获取当前数据库类型 */ public staticfunctiongetDbType(): string{$driverconfig(database.default);returnmatch($driver){dmdameng,kingbasekingbase,gaussdbgaussdb,highgohighgo, defaultmysql,};}/** * 判断是否是 PostgreSQL 系数据库 * 金仓、OpenGauss、瀚高都是 PG 系 */ public staticfunctionisPgFamily(): bool{returnin_array(self::getDbType(),[kingbase,gaussdb,highgo]);}/** * 获取当前时间的 SQL 表达式 * MySQL: NOW()达梦: SYSDATE PG系: NOW()*/ public staticfunctionnowExpr(): string{returnmatch(self::getDbType()){damengSYSDATE, defaultNOW(),};}/** * 字符串拼接 * MySQL: CONCAT(a,b)达梦/PG: a||b */ public staticfunctionconcat(string...$fields): string{if(self::getDbType()mysql){returnCONCAT(.implode(,,$fields).);}returnimplode( || ,$fields);}/** * 分页 SQL * MySQL: LIMIT10OFFSET0* 达梦/PG: LIMIT10OFFSET0(达梦8支持标准语法)*/ public staticfunctionpaginate(\think\db\Query$query, int$page, int$pageSize):\think\db\Query{$offset($page-1)*$pageSize;return$query-limit($pageSize)-page($page);}/** * 达梦特有表名/字段名需要大写 * 达梦默认大小写不敏感但建议统一大写 */ public staticfunctiontableName(string$name): string{if(self::getDbType()dameng){returnstrtoupper($name);}return$name;}}--- 七、Model 基类 — 屏蔽数据库差异?php // app/model/BaseModel.php namespace app\model;use think\Model;use app\service\DatabaseCompatService;abstract class BaseModel extends Model{// 子类只需要定义这个不用管用的是哪个数据库 protected$connection;publicfunctioninitialize(): void{// 自动选择当前配置的数据库连接if(empty($this-connection)){$this-connectionconfig(database.default);}parent::initialize();}/** * 达梦数据库自动处理字段名大写问题 */ protectedfunctionparseFieldName(string$field): string{if(DatabaseCompatService::getDbType()dameng){returnstrtoupper($field);}return$field;}/** * 通用软删除兼容各数据库的时间格式 */ publicfunctionsoftDelete(): bool{return$this-save([deleted_atdate(Y-m-d H:i:s),is_deleted1,]);}}?php // app/model/User.php — 实际业务 Model 示例 namespace app\model;class User extends BaseModel{protected$tabletp_user;// 达梦里会自动变成 TP_USER protected$schema[idint,usernamestring,emailstring,created_atdatetime,updated_atdatetime,];// 达梦/PG 不支持 MySQL 的 tinyint(1)自动转 bool手动处理 protected$type[is_activeinteger,];}--- 八、数据库迁移文件兼容多数据库?php // database/migrations/20240101000001_create_user_table.php use think\migration\Migrator;use think\migration\db\Column;class CreateUserTable extends Migrator{publicfunctionchange(): void{$table$this-table(tp_user,[engineInnoDB, // 达梦/PG 会忽略这个参数不影响collationutf8mb4_unicode_ci,comment用户表,]);$table-addColumn(username,string,[limit64,nullfalse,comment用户名,])-addColumn(email,string,[limit128,nullfalse,default,])-addColumn(password,string,[limit255,nullfalse,])-addColumn(is_active,integer,[// 用 integer 代替 boolean兼容性最好limit1,default1,])-addColumn(created_at,datetime,[nulltrue])-addColumn(updated_at,datetime,[nulltrue])-addIndex([username],[uniquetrue])-addIndex([email],[uniquetrue])-create();}}--- 九、Nginx 配置统信UOS / 麒麟 Kylin 上# /etc/nginx/conf.d/myapp.confserver{listen80;server_name myapp.example.com;root /opt/myapp/public;index index.php;# ThinkPHP 标准路由重写location /{if(!-e$request_filename){rewrite ^(.*)$ /index.php?s$1last;}}location ~\.php${fastcgi_pass127.0.0.1:9000;fastcgi_index index.php;fastcgi_param SCRIPT_FILENAME$document_root$fastcgi_script_name;include fastcgi_params;# 信创环境常见问题PHP-FPM 超时设置长一点fastcgi_read_timeout300;fastcgi_connect_timeout60;}# 禁止访问敏感文件location ~ /\.(env|git|svn){deny all;}location ~\.(log|sql|conf)${deny all;}access_log /var/log/nginx/myapp_access.log;error_log /var/log/nginx/myapp_error.log;}--- 十、东方通 TongWeb 适配JavaEE 容器跑 PHP 的场景 ▎ 大白话东方通 TongWeb 是 Java 应用服务器如果你的项目要求必须跑在 TongWeb 上通常的做法是 TongWeb ▎ 做反向代理PHP-FPM 在后面跑而不是直接在 TongWeb 里跑 PHP。!-- TongWeb 反向代理配置 tongweb/conf/server.xml 片段 --Connectorport8080protocolHTTP/1.1connectionTimeout20000redirectPort8443/!-- 反向代理到 PHP-FPM 的 Nginx --EnginenameCatalinadefaultHostlocalhostHostnamelocalhostappBasewebappsContextpath/docBasemyapp!-- 静态资源直接由 TongWeb 处理 --/Context/Host/Engine实际部署架构 用户请求 ↓ 东方通 TongWeb :8080 ↓(反向代理 /api/* 和 PHP 请求)Nginx :80 ↓(FastCGI)PHP-FPM :9000 ↓ ThinkPHP 应用 ↓ 达梦/金仓数据库 --- 十一、PHP 扩展安装麒麟/统信系统# 1. 安装达梦 PHP 扩展需要先装达梦客户端# 达梦官方提供 php_pdo_dm.so# 把扩展复制到 PHP 扩展目录cp/opt/dmdbms/drivers/php/php74/php_pdo_dm.so\$(php-recho ini_get(extension_dir);)# 在 php.ini 中启用echoextensionphp_pdo_dm.so/etc/php/7.4/fpm/php.ini# 2. 安装 PostgreSQL 扩展金仓/OpenGauss/瀚高用# 麒麟/统信 yum 源yuminstallphp74-php-pdo php74-php-pgsql-y# 或者 aptaptinstallphp7.4-pgsql-y# 3. 验证扩展是否加载成功php-m|grep-Epdo_dm|pdo_pgsql|pdo_mysql# 4. 重启 PHP-FPMsystemctl restart php7.4-fpm --- 十二、常见坑和解决方案 ┌─────────────────────────────┬────────────────────────────────┬──────────────────────────────────────────────────┐ │ 问题 │ 原因 │ 解决方案 │ ├─────────────────────────────┼────────────────────────────────┼──────────────────────────────────────────────────┤ │ 达梦查询结果字段名全大写 │ 达梦默认大写标识符 │ Model 里加 protected$field│ │ │ │ 映射或开启达梦大小写不敏感模式 │ ├─────────────────────────────┼────────────────────────────────┼──────────────────────────────────────────────────┤ │ 金仓/PG 不支持 LIMIT x,y │ PG 语法是 LIMIT x OFFSET y │ 用 ThinkPHP 的 -limit()-page()链式调用ORM │ │ 语法 │ │ 会自动转换 │ ├─────────────────────────────┼────────────────────────────────┼──────────────────────────────────────────────────┤ │ 达梦不支持 AUTO_INCREMENT │ 达梦用序列SEQUENCE实现自增 │ think-dm 驱动已处理建表用 IDENTITY(1,1)│ ├─────────────────────────────┼────────────────────────────────┼──────────────────────────────────────────────────┤ │ 统信UOS 上 PHP 版本太低 │ 系统源里只有 PHP7.2│ 用 Remi 源或手动编译 PHP7.4/8.0 │ ├─────────────────────────────┼────────────────────────────────┼──────────────────────────────────────────────────┤ │ 东方通 TongWeb 路径问题 │ TongWeb 的 webroot 路径配置 │ 确保 public/index.php 是入口.htaccess 换成 │ │ │ │ Nginx rewrite │ ├─────────────────────────────┼────────────────────────────────┼──────────────────────────────────────────────────┤ │ 达梦 BOOLEAN 类型不存在 │ 达梦没有 BOOLEAN用 NUMBER(1)│ 迁移文件用 integer 类型Model 里手动转换 │ ├─────────────────────────────┼────────────────────────────────┼──────────────────────────────────────────────────┤ │ 字符集乱码 │ 达梦默认 GB18030PHP 是 UTF-8 │ 达梦连接串加charsetutf8或建库时指定 UTF-8 │ └─────────────────────────────┴────────────────────────────────┴──────────────────────────────────────────────────┘ --- 十三、一键部署脚本#!/bin/bash# deploy.sh — 信创环境 ThinkPHP 部署脚本set-eAPP_DIR/opt/myappPHP_BINphpCOMPOSER_BINcomposerecho 开始部署 ThinkPHP 信创环境 # 1. 安装依赖cd$APP_DIR$COMPOSER_BINinstall--no-dev --optimize-autoloader# 2. 设置目录权限chmod-R755$APP_DIRchmod-R777$APP_DIR/runtimechmod-R777$APP_DIR/public/uploads2/dev/null||true# 3. 清理缓存$PHP_BINthinkclear# 4. 执行数据库迁移$PHP_BINthink migrate:run# 5. 生成路由缓存生产环境加速$PHP_BINthink optimize:route# 6. 重启 PHP-FPMsystemctl restart php7.4-fpm systemctl reload nginxecho 部署完成 --- 总结 ┌─────────────────────┬─────────────────────────┬────────────────────────────────┐ │ 数据库 │ 驱动方案 │ 兼容难度 │ ├─────────────────────┼─────────────────────────┼────────────────────────────────┤ │ 达梦 DM8 │ xiaocheng-keji/think-dm │ ★★★ 需要注意大小写、序列、类型 │ ├─────────────────────┼─────────────────────────┼────────────────────────────────┤ │ 人大金仓 KingbaseES │ 内置 pgsql 驱动 │ ★★ 基本兼容注意端口和 schema │ ├─────────────────────┼─────────────────────────┼────────────────────────────────┤ │ OpenGauss / GaussDB │ 内置 pgsql 驱动 │ ★★ 同上 │ ├─────────────────────┼─────────────────────────┼────────────────────────────────┤ │ 瀚高 HighGo │ 内置 pgsql 驱动 │ ★★ 同上 │ └─────────────────────┴─────────────────────────┴────────────────────────────────┘ 最省事的路线优先选人大金仓或 OpenGaussPostgreSQL 系ThinkPHP 内置驱动直接支持几乎零改造。达梦需要额外装驱动包但 think-dm 库已经封装好了大部分差异。