如何解决 Laravel 与 Jet 的冲突 #3010

panruixin · 2020-12-24T03:44:20Z

panruixin
Dec 24, 2020

Laravel 配合 Jet 使用时，因为助手函数 collection 冲突，导致出现以下类型错误

xxx must be an instance of Illuminate\Support\Collection, instance of Hyperf\Utils\Collection given

Answered by limingxinleo

Dec 24, 2020

原因

让我们编写一个接口，测试这个问题

Route::get('/', function () {
    return get_class(collect());
});

然后我们可以看到结果是 Illuminate\Support\Collection

接下来让我们载入 Jet 组件

composer require hyperf/jet
composer update -o

我们便会看到以下报错

实际报错可能会因 Laravel 版本不同而发生改变

Argument 1 passed to Illuminate\Routing\Router::sortMiddleware() must be an instance of Illuminate\Support\Collection, instance of Hyperf\Utils\Collection given, called in /Users/limingxin/Applications/workspace/php/test/laravel/vendor/laravel/framework/src/Illuminate/Routing/Router.php on line 729

我们打开 vendor/composer/autoload_files.php 文件，便可以看到以下映射关系

以下隐藏其他不相干的文件

'bbeb7603826cb9296dde3ca1a840af47' => $vendorDir . '/hyperf/utils/src/Functions.php',
'265b4fa…

View full answer

limingxinleo · 2020-12-24T05:06:15Z

limingxinleo
Dec 24, 2020
Maintainer

原因

让我们编写一个接口，测试这个问题

Route::get('/', function () {
    return get_class(collect());
});

然后我们可以看到结果是 Illuminate\Support\Collection

接下来让我们载入 Jet 组件

composer require hyperf/jet
composer update -o

我们便会看到以下报错

实际报错可能会因 Laravel 版本不同而发生改变

Argument 1 passed to Illuminate\Routing\Router::sortMiddleware() must be an instance of Illuminate\Support\Collection, instance of Hyperf\Utils\Collection given, called in /Users/limingxin/Applications/workspace/php/test/laravel/vendor/laravel/framework/src/Illuminate/Routing/Router.php on line 729

我们打开 vendor/composer/autoload_files.php 文件，便可以看到以下映射关系

以下隐藏其他不相干的文件

'bbeb7603826cb9296dde3ca1a840af47' => $vendorDir . '/hyperf/utils/src/Functions.php',
'265b4faa2b3a9766332744949e83bf97' => $vendorDir . '/laravel/framework/src/Illuminate/Collections/helpers.php',
'c7a3c339e7e14b60e06a2d7fcce9476b' => $vendorDir . '/laravel/framework/src/Illuminate/Events/functions.php',
'f0906e6318348a765ffb6eb24e0d0938' => $vendorDir . '/laravel/framework/src/Illuminate/Foundation/helpers.php',
'58571171fd5812e6e447dce228f52f4d' => $vendorDir . '/laravel/framework/src/Illuminate/Support/helpers.php',

可见，Hyperf 的助手函数会优于 Laravel 的助手函数运行，故导致 collect() 方法会使用 Hyperf 提供的方法，导致报错。

解决

知道这些情况，我们就可以来解决这个问题了

方法1

直接使用 https://github.com/hyperf/composer-plugin 组件，将 hyperf/utils 加载优先级改为 -1

方法2

我们可以修改 Laravel 的入口函数 index.php，在引入 autoload.php 之前，优先引入以下四个文件，就可以完美解决这个问题。

require __DIR__ . '/../vendor/laravel/framework/src/Illuminate/Collections/helpers.php';
require __DIR__ . '/../vendor/laravel/framework/src/Illuminate/Events/functions.php';
require __DIR__ . '/../vendor/laravel/framework/src/Illuminate/Foundation/helpers.php';
require __DIR__ . '/../vendor/laravel/framework/src/Illuminate/Support/helpers.php';
require __DIR__ . '/../vendor/autoload.php';