如何解决 Laravel 与 Jet 的冲突

[panruixin]

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

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

[limingxinleo]

原因

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

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';

因为 Jet 组件虽然使用了 hyperf/utils 组件，但并没有使用到其中的任何一个助手函数，所以以上修改，不会对 Jet 有任何影响。

[Observer5]

Laravel 6.X 没有这两个文件

[limingxinleo]

Laravel 6.X 没有这两个文件

用方法1

[huangdijia]

可以用 https://github.com/huangdijia/jet-client 试试

[limingxinleo]

hyperf/jet#16
hyperf/jet#17

[huangdijia]

你根据最新的 Jet 源码，再改一下。。。

有几个BUG比较严重

OK

[huangzhhui]

@huangdijia 你可以 follow 下 hyperf/jet 项目，这样有变更你也会有通知能够及时知道

[huangdijia]

@huangdijia 你可以 follow 下 hyperf/jet 项目，这样有变更你也会有通知能够及时知道

有 Watch 了。

[huangdijia]

hyperf/jet#16
hyperf/jet#17

已经同步优化了

[Observer5]

composer dumpautoload -o
没法 composer update了，laravel 6，8都是这个情况

[limingxinleo]

方法1不能用？

[Observer5]

方法一可以用，但是在composer require 其它包，和compoesr update的时候报这个错