如何解决composer提示The "extra.laravel.dont-discover" key is deprecated

该提示因Laravel弃用extra.laravel.dont-discover配置，推荐改用服务提供者手动注册或升级包版本。解决方法是删除composer.json中的dont-discover项，并在AppServiceProvider的register中通过afterResolving控制发现行为，或直接移除配置并执行composer dump-autoload以消除警告。

当你在使用 Composer 安装或更新 Laravel 项目依赖时，遇到提示：

这表示你项目 composer.json 文件中使用的 "extra.laravel.dont-discover" 配置项已被弃用。Laravel 推荐使用新的方式来控制包的服务提供者自动发现行为。

为什么会出现这个提示？

Laravel 曾通过 extra.laravel.dont-discover 来指定哪些包不应被自动加载其服务提供者（Service Provider）。但从 Laravel 5.8 开始，官方引入了更清晰的机制 —— 在包根目录下添加 no-scripts 或利用 laravel: Provider Repository 管理发现逻辑，因此旧配置被标记为过时。

如何解决该警告？

你需要将 dont-discover 的配置迁移到新方式，具体步骤如下：

• 打开 composer.json 文件，找到 extra.laravel 节下的 dont-discover 配置：

"extra": {
    "laravel": {
        "dont-discover": [
            "vendor/package-name"
        ]
    }
}

• 删除 dont-discover 配置项
• 在对应第三方包的根目录下创建一个名为 .ignore-platform-reqs 的空文件（不推荐）—— 实际上这不是标准做法

✅ 正确做法是：使用 Laravel 提供的 自动发现白名单 机制，或者直接让包支持条件性注册。

但目前最简单、最推荐的做法是：完全移除 dont-discover 配置，并改用 ServiceProvider 的 register 方法中手动控制是否注册，或升级到支持新规范的包版本。

芦笋演示

一键出成片的录屏演示软件，专为制作产品演示、教学课程和使用教程而设计。

34

查看详情

如果你只是想阻止某个包的自动发现，现在应改为：

1. 确保该包本身在其 composer.json 中声明了：

"extra": {
    "laravel": {
        "providers": [
            "Package\ServiceProvider"
        ],
        "aliases": {
            "PackageAlias": "Package\Facade"
        }
    }
}

2. 然后在你的应用的 config/app.php 中，不要手动添加该服务提供者和别名
3. 如果想彻底禁用某个包的自动发现，在 app/Providers/AppServiceProvider.php 的 register 方法中加入：

public function register()
{
    // 禁用特定包的自动发现
    $this->app->resolving('provider-repository', function ($instance) {
        $instance->addCoreManifestPath(storage_path('framework/cache/laravel-manifest'));
    });

    // 或者更直接地：排除某个包
    if ($this->app->runningInConsole()) {
        $this->app->afterResolving(IlluminateFoundationProviderRepository::class, function ($repo) {
            $repo->manifestPath = storage_path('framework/cache/laravel-manifest');
        });
    }
}

但这不是常规需求。大多数情况下，你可以直接删除 dont-discover 并忽略警告，尤其是如果你不再使用相关包。

快速修复方案（推荐）

如果你不需要精确控制包发现，且项目运行正常，可以直接：

• 从 composer.json 中删除整个 dont-discover 数组
• 运行 composer dump-autoload 重建自动加载

这样警告就会消失，且不影响功能。

基本上就这些。Composer 只是提醒你配置已过时，迁移后项目会更符合现代 Laravel 规范。

以上就是如何解决composer提示The "extra.laravel.dont-discover" key is deprecated的详细内容，更多请关注php中文网其它相关文章！