Linux环境PHP应用改用PDO连接iSeries上的DB2实例

你不能直接沿用原有的pdo_ibm驱动连接IBM i（iSeries）的DB2实例，必须替换为PDO_ODBC驱动配合已部署的IBM i Access ODBC驱动使用，同时需要完成额外的配置适配，才能在不修改代码的前提下实现连接。

核心原因 #

pdo_ibm是IBM专门为DB2 for LUW开发的PDO扩展，仅适配LUW环境的CLI驱动，无法兼容IBM i的DB2实例。而IBM i的DB2连接依赖其专属的ODBC/CLI驱动（即你已部署的IBM i Access），对应的PDO扩展是PDO_ODBC。

具体操作步骤 #

1. 替换驱动：编译安装PDO_ODBC #

首先清理原有pdo_ibm相关组件，然后编译安装适配IBM i Access的PDO_ODBC扩展：

# 禁用并清理原有pdo_ibm
RUN docker-php-ext-disable pdo_ibm
RUN rm -rf /pdo /clidriver

# 编译安装PDO_ODBC（假设IBM i Access安装路径为/opt/ibm/iSeriesAccess）
RUN docker-php-ext-configure pdo_odbc --with-pdo-odbc=ibm,iSeriesAccess,/opt/ibm/iSeriesAccess
RUN docker-php-ext-install pdo_odbc
RUN docker-php-ext-enable pdo_odbc

2. 配置ODBC数据源以兼容原有代码 #

由于代码无法修改，需通过ODBC配置将原有pdo_ibm风格的连接参数映射到IBM i的连接：

• 注册IBM i ODBC驱动：编辑/etc/odbcinst.ini，确保驱动条目正确：

  [IBM i Access ODBC Driver]
  Description=IBM i Access ODBC Driver
  Driver=/opt/ibm/iSeriesAccess/lib64/libcwbodbc.so
  Setup=/opt/ibm/iSeriesAccess/lib64/libcwbodbcs.so
  Threading=1
  FileUsage=1
  

• 配置DSN映射：编辑/etc/odbc.ini，创建与原有代码中dbname匹配的数据源（例如原有代码用dbname=MYDB）：

  [MYDB]
  Driver=IBM i Access ODBC Driver
  SYSTEM=你的IBM i主机名或IP
  DATABASE=MYDB
  UID=数据库用户名
  PWD=数据库密码
  

3. 适配PDO连接字符串（无需修改代码） #

如果你的应用代码是通过配置文件/环境变量读取PDO连接字符串，只需将原ibm:格式的DSN替换为odbc:格式：

• 原LUW连接示例：ibm:dbname=MYDB;host=luw-host;port=50000
• 替换为IBM i连接：odbc:MYDB（直接引用上面配置的DSN）

如果代码中硬编码了ibm:前缀的DSN，你需要通过容器环境变量注入正确的odbc:格式DSN，覆盖代码中的硬编码参数。

4. 验证连接 #

在容器中执行测试脚本确认连接正常：

<?php
// 使用适配后的DSN（与代码中读取的配置一致）
$dsn = getenv('DB_DSN');
$pdo = new PDO($dsn, getenv('DB_USER'), getenv('DB_PASS'));
// 执行IBM i专属的测试查询
$stmt = $pdo->query("SELECT 1 FROM SYSIBM.SYSDUMMY1");
var_dump($stmt->fetch());
?>

内容的提问来源于stack exchange，提问作者heap overflow