Ubuntu 22.04中PHP通过PDO_IBM连接DB2报错SQL10007N排查

核心问题 #

你在~/.bashrc配置的环境变量仅对当前登录用户生效，但运行PHP的www-data用户不会读取该文件，导致IBM CLIDriver无法加载必要的消息文件，触发SQL10007N错误（原因码3通常对应消息文件缺失或权限不足）。

修复步骤 #

• 配置全局环境变量
  编辑/etc/environment文件，添加以下内容（替换为你的实际路径）：

  ODBCHOME=/path/to/ibm/clidriver
  ODBCINI=/path/to/your/odbc.ini
  LD_LIBRARY_PATH=/path/to/ibm/clidriver/lib:$LD_LIBRARY_PATH
  IBM_DB_HOME=/path/to/ibm/clidriver
  

  保存后重启web服务或系统，让环境变量生效（例如systemctl restart apache2或systemctl restart php-fpm）。

• 赋予www-data驱动目录读取权限
  执行命令确保www-data能访问CLIDriver的库和消息文件：

  chmod -R 755 /path/to/ibm/clidriver
  chown -R root:www-data /path/to/ibm/clidriver
  

• 验证PHP环境变量
  创建测试PHP文件，检查环境变量是否生效：

  <?php
  print_r(getenv());
  ?>
  

  访问该文件，确认ODBCHOME、LD_LIBRARY_PATH等变量已正确加载。

• 检查odbc.ini权限
  确保www-data能读取配置文件：

  chmod 644 /path/to/your/odbc.ini
  

额外优化（针对PHP-FPM场景） #

如果使用PHP-FPM，可直接在FPM池配置（如/etc/php/8.1/fpm/pool.d/www.conf）中添加环境变量：

env[ODBCHOME] = /path/to/ibm/clidriver
env[ODBCINI] = /path/to/your/odbc.ini
env[LD_LIBRARY_PATH] = /path/to/ibm/clidriver/lib:$LD_LIBRARY_PATH

修改后重启PHP-FPM服务。

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