必须先安装unixODBC，否则GBase ODBC驱动无法启动；CentOS/RedHat用yum install unixODBC unixODBC-devel，Ubuntu/Debian用apt-get install unixodbc unixodbc-dev，且需验证odbcinst -j输出配置路径。
ODBC驱动安装必须先配unixODBC
不装unixODBC，GBase的ODBC驱动根本起不来，连isql命令都会报“driver not found”或“Data source name not found”。CentOS/RedHat系直接用yum install unixODBC unixODBC-devel；Ubuntu/Debian则用apt-get install unixodbc unixodbc-dev。注意：unixODBC-devel不能漏，否则后续编译PHP扩展（比如pdo_gbasedbt）会找不到头文件。
装完验证：odbcinst -j能输出unixODBC配置路径（通常是/etc/odbcinst.ini和/etc/odbc.ini），才算基础环境到位。
GBase ODBC驱动安装与odbcinst.ini配置
从南大通用官网下载对应版本的GBaseODBC-*.rpm（如GBaseODBC-9.5.0.2-centos7.x86_64.rpm），用rpm -ivh安装。安装后，驱动SO文件通常落在/opt/gbase8s-odbc-driver/lib/下，关键文件是libgbaseodbc.so。
接下来必须手动编辑/etc/odbcinst.ini，注册驱动：
立即学习“PHP免费学习笔记（深入）”；
[GBaseODBC] Description=GBase ODBC Driver Driver=/opt/gbase8s-odbc-driver/lib/libgbaseodbc.so Setup=/opt/gbase8s-odbc-driver/lib/libgbaseodbc.so FileUsage=1
常见错误：
-
Driver’s SQLAllocHandle on SQL_HANDLE_ENV failed：多半是Driver路径写错，或LD_LIBRARY_PATH没包含该目录 - 加载时提示
undefined symbol: SQLGetPrivateProfileString：说明unixODBC版本太低，需升级到2.3.9+（官网提供源码包）
ThinkPHP 6/7中配置PDO_ODBC连接GBase
ThinkPHP本身不内置GBase支持，但可通过PDO_ODBC协议间接连接。前提是PHP已启用pdo_odbc扩展（检查php -m | grep odbc）。
在config/database.php中配置如下：
'gbase' => [
'type' => 'pdo',
'dsn' => 'odbc:DRIVER={GBaseODBC};SERVER=192.168.10.100;PORT=9088;DATABASE=testdb;UID=gbasedbt;PWD=yourpass;',
'hostname' => '',
'database' => '',
'username' => '',
'password' => '',
'hostport' => '',
'params' => [],
],
关键点：
-
dsn里DRIVER={GBaseODBC}必须和/etc/odbcinst.ini中定义的Section名完全一致（区分大小写） - 不要填
hostname或database，PDO_ODBC模式下这些字段会被忽略，全靠dsn传参 - 如果连接时报
SQLSTATE[IM002] Data source name not found，优先检查odbcinst.ini是否加载成功、驱动路径是否存在可执行权限
PHP运行时环境变量GBASEDBTDIR必须设对
即使ODBC驱动注册成功，PHP-FPM子进程仍可能因找不到GBase客户端运行时库而失败。必须在PHP配置中显式声明GBASEDBTDIR：
在/etc/php-fpm.d/www.conf里加一行：
env[GBASEDBTDIR] = /opt/gbase8s-odbc-driver
然后重启php-fpm。这个路径必须指向GBase ODBC驱动安装根目录（含lib/、etc/等子目录），不是只放SO文件的lib路径。
漏掉这步的典型现象是：isql命令行能连，但PHP脚本执行new PDO($dsn)时直接Segmentation fault或静默失败——因为底层CSDK依赖的sqlhosts、locales等资源找不到。
ODBC方式在ThinkPHP里属于“兜底方案”，性能和事务控制不如原生JDBC，但胜在不用改框架底层。真正容易被忽略的是GBASEDBTDIR环境变量和odbcinst.ini中驱动名大小写一致性——这两个地方错一个，整个连接链就断在看不见的地方。
