Laravel连接Firebird数据库时Composer依赖冲突问题求助

执行 composer require harrygulliford/laravel-firebird 时出现以下错误：

Root composer.json requires harrygulliford/laravel-firebird ^3.1 -> satisfiable by harrygulliford/laravel-firebird[v3.1.0].

• harrygulliford/laravel-firebird v3.1.0 requires illuminate/support ^8.65|9.0 -> found illuminate/support[v8.65.0, ..., 8.x-dev, v9.0.0-beta.1, ..., 9.x-dev] but these were not loaded, likely because it conflicts with another require.

我的 composer.json 文件内容如下：

{
    "name": "laravel/laravel",
    "type": "project",
    "description": "The Laravel Framework.",
    "keywords": ["framework", "laravel"],
    "license": "MIT",
    "require": {
        "php": "^8.1",
        "guzzlehttp/guzzle": "^7.2",
        "laravel/framework": "^10.0.0",
        "laravel/sanctum": "^3.2",
        "laravel/tinker": "^2.8",
        "illuminate/support": "^8.65|^9.0|^10.0.0"
    },
    "require-dev": {
        "fakerphp/faker": "^1.9.1",
        "laravel/pint": "^1.0",
        "laravel/sail": "^1.18",
        "mockery/mockery": "^1.4.4",
        "nunomaduro/collision": "^7.0",
        "phpunit/phpunit": "^10.0",
        "spatie/laravel-ignition": "^2.0"
    },
    "autoload": {
        "psr-4": {
            "App\\": "app/",
            "Database\\Factories\\": "database/factories/",
            "Database\\Seeders\\": "database/seeders/"
        }
    },
    "autoload-dev": {
        "psr-4": {
            "Tests\\": "tests/"
        }
    },
    "scripts": {
        "post-autoload-dump": [
            "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
            "@php artisan package:discover --ansi"
        ],
        "post-update-cmd": [
            "@php artisan vendor:publish --tag=laravel-assets --ansi --force"
        ],
        "post-root-package-install": [
            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
        ],
        "post-create-project-cmd": [
            "@php artisan key:generate --ansi"
        ]
    },
    "extra": {
        "laravel": {
            "dont-discover": []
        }
    },
    "config": {
        "optimize-autoloader": true,
        "preferred-install": "dist",
        "sort-packages": true,
        "allow-plugins": {
            "pestphp/pest-plugin": true,
            "php-http/discovery": true
        }
    },
    "minimum-stability": "dev",
    "prefer-stable": true
}

我的需求是将Laravel 9连接到Firebird 2.5数据库。已经尝试过修改依赖要求、更换Laravel及harrygulliford/laravel-firebird版本、新建项目重新安装依赖，但问题仍未解决。

解决方案 #

1. 定位核心冲突 #

你的composer.json中laravel/framework指定为^10.0.0，但你需要的是Laravel 9。harrygulliford/laravel-firebird v3.1仅支持Laravel 8/9，而Laravel 10会强制加载illuminate/support 10.x版本，直接和包的版本要求冲突。另外，手动添加illuminate/support依赖属于冗余操作，laravel/framework已经包含该组件，手动指定会加剧冲突。

2. 调整依赖配置 #

修改composer.json的require部分，将Laravel框架版本降到9.x，并移除手动添加的illuminate/support：

"require": {
    "php": "^8.0.2",
    "guzzlehttp/guzzle": "^7.2",
    "laravel/framework": "^9.0",
    "laravel/sanctum": "^3.0",
    "laravel/tinker": "^2.7"
}

3. 重新安装依赖 #

执行以下命令更新基础依赖：

composer update

然后安装Firebird扩展：

composer require harrygulliford/laravel-firebird ^3.1

4. 兼容验证 #

harrygulliford/laravel-firebird v3.x明确支持Laravel 9和Firebird 2.5，调整后即可正常安装。若仍有问题，可尝试指定具体版本：

composer require harrygulliford/laravel-firebird:3.1.0

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