Laravel 8集成IBM DB2报Undefined index: database错误求助

问题概述 #

PHP 7.4 + Laravel 8 项目，通过cooperl/laravel-db2集成IBM DB2，database.php已配置凭证，但控制器执行查询时抛出ErrorException Undefined index: database。服务器ibm_db2扩展正常，纯PHP脚本可连接DB2，但Laravel中ODBC驱动无法正常工作。

现有配置与代码 #

database.php 配置片段

'db2' => [
            'driver' => 'db2_ibmi_ibm',
            'driverName' => '{IBM i Access ODBC Driver}',
            'host' => '',
            'username' => '',
            'password' => '',
            'database' => '',
            'prefix' => '',
            'schema' => 'default schema',
            'port' => 80000,
            'date_format' => 'Y-m-d H:i:s',
            'odbc_keywords' => [
                'SIGNON' => 3,
                'SSL' => 0,
                'CommitMode' => 2,
                'ConnectionType' => 0,
                'DefaultLibraries' => '',
                'Naming' => 0,
                'UNICODESQL' => 0,
                'DateFormat' => 5,
                'DateSeperator' => 0,
                'Decimal' => 0,
                'TimeFormat' => 0,
                'TimeSeparator' => 0,
                'TimestampFormat' => 0,
                'ConvertDateTimeToChar' => 0,
                'BLOCKFETCH' => 1,
                'BlockSizeKB' => 32,
                'AllowDataCompression' => 1,
                'CONCURRENCY' => 0,
                'LAZYCLOSE' => 0,
                'MaxFieldLength' => 15360,
                'PREFETCH' => 0,
                'QUERYTIMEOUT' => 1,
                'DefaultPkgLibrary' => 'QGPL',
                'DefaultPackage' => 'A /DEFAULT(IBM),2,0,1,0',
                'ExtendedDynamic' => 0,
                'QAQQINILibrary' => '',
                'SQDIAGCODE' => '',
                'LANGUAGEID' => 'ENU',
                'SORTTABLE' => '',
                'SortSequence' => 0,
                'SORTWEIGHT' => 0,
                'AllowUnsupportedChar' => 0,
                'CCSID' => 819,
                'GRAPHIC' => 0,
                'ForceTranslation' => 0,
                'ALLOWPROCCALLS' => 0,
                'DB2SQLSTATES' => 0,
                'DEBUG' => 0,
                'TRUEAUTOCOMMIT' => 0,
                'CATALOGOPTIONS' => 3,
                'LibraryView' => 0,
                'ODBCRemarks' => 0,
                'SEARCHPATTERN' => 1,
                'TranslationDLL' => '',
                'TranslationOption' => 0,
                'MAXTRACESIZE' => 0,
                'MultipleTraceFiles' => 1,
                'TRACE' => 0,
                'TRACEFILENAME' => '',
                'ExtendedColInfo' => 0,
            ],
            'options' => [
                PDO::ATTR_CASE => PDO::CASE_LOWER,
                PDO::ATTR_PERSISTENT => false
            ]
        ],

控制器查询代码

$products = LeiobjProduktP::limit(1)->get(); 
return response()->json(['products' => $products]);

可正常运行的纯PHP连接脚本

$host = 'dummy'; // IBM i服务器IP/主机名
$database = 'dummy'; // IBM i上的数据库名
$username = 'test'; // 数据库用户名
$password = 'test'; // 数据库密码
$port = 80000; 
$dsn = "DRIVER={IBM i Access ODBC Driver};DATABASE=$database;SYSTEM=$host;Port=$port;PROTOCOL=TCPIP";

$connection = db2_connect($dsn, $username, $password); 
if ($connection) { 
    echo "Connected to the IBM i database."; 
    db2_close($connection); 
} else { 
    echo "Failed to connect to the IBM i database."; 
}

解决方案 #

1. 对齐配置与驱动DSN逻辑 #

cooperl/laravel-db2的db2_ibmi_ibm驱动构建DSN时，对配置字段的映射和纯PHP脚本存在差异：

• 将database字段填写为IBM i上的目标库名（和纯PHP脚本中$database值一致）
• 将host字段填写为IBM i服务器的IP或主机名（和纯PHP脚本中$host值一致）
• 确保这两个字段不为空，驱动需要这两个参数拼接正确的DSN

修改后的核心配置片段：

'db2' => [
    'driver' => 'db2_ibmi_ibm',
    'driverName' => '{IBM i Access ODBC Driver}',
    'host' => '你的IBM i服务器IP/主机名',
    'username' => '你的用户名',
    'password' => '你的密码',
    'database' => '你的目标库名',
    'schema' => '你的模式名', // 替换为实际模式，比如和模型对应的模式
    'port' => 80000,
    // ... 其他配置不变
],

2. 确保模型指定正确连接 #

检查LeiobjProduktP模型是否明确使用db2连接：

class LeiobjProduktP extends Model
{
    protected $connection = 'db2';
    protected $table = 'LeiobjProduktP'; // 确保表名正确，区分大小写
    // ... 其他模型配置
}

3. 刷新配置缓存 #

修改配置后，清理Laravel缓存确保配置生效：

php artisan config:clear
php artisan cache:clear

4. 直接测试数据库连接 #

跳过模型，用DB门面直接测试连接与查询，定位问题：

// 在路由或控制器中执行
$testData = DB::connection('db2')->select('SELECT * FROM 你的模式名.LeiobjProduktP FETCH FIRST 1 ROW ONLY');
dd($testData);

如果此查询成功，说明模型配置存在问题；如果失败，继续排查数据库配置。

5. 调整ODBC关键字（可选） #

如果连接仍有问题，检查odbc_keywords中的DefaultLibraries，填写目标库名，确保驱动能找到对应的表：

'odbc_keywords' => [
    // ... 其他配置
    'DefaultLibraries' => '你的目标库名',
    // ... 其他配置
],

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