借助 rector 升级 Hyperf

[huangdijia]

背景

最近发布的 v3.0.16 对 hyperf/utils 调整比较多的调整，很多助手类从这个包拆分出去了，将会在 v3.1 版本中废弃。

既然要废弃，那项目中的代码最好还是尽早做调整，这里给大家一个思路，借助 rector 实现一键升级。

follow me！

安装 rector

composer require rector/rector --dev

配置文件

rector-hyperf-3.1.x.php

<?php

declare(strict_types=1);

use Rector\CodeQuality\Rector\Class_\InlineConstructorDefaultToPropertyRector;
use Rector\Config\RectorConfig;
use Rector\Renaming\Rector\FuncCall\RenameFunctionRector;
use Rector\Renaming\Rector\Name\RenameClassRector;
use Rector\Set\ValueObject\LevelSetList;

return static function (RectorConfig $rectorConfig): void {
    $rectorConfig->importNames(true, false);

    $rectorConfig->paths([
        __DIR__ . '/app',
        __DIR__ . '/config',
    ]);

    // register a single rule
    // $rectorConfig->rule(InlineConstructorDefaultToPropertyRector::class);

    // define sets of rules
    // $rectorConfig->sets([
    //     LevelSetList::UP_TO_PHP_80,
    // ]);

    $rectorConfig
        ->ruleWithConfiguration(RenameClassRector::class, [
            'Hyperf\Utils\ApplicationContext' => 'Hyperf\Context\ApplicationContext',
            'Hyperf\Utils\Arr' => 'Hyperf\Collection\Arr',
            'Hyperf\Utils\Collection' => 'Hyperf\Collection\Collection',
            'Hyperf\Utils\Coroutine' => 'Hyperf\Coroutine\Coroutine',
            'Hyperf\Utils\Coroutine\Concurrent' => 'Hyperf\Coroutine\Concurrent',
            'Hyperf\Utils\Str' => 'Hyperf\Stringable\Str',
            'Hyperf\Utils\Stringable' => 'Hyperf\Stringable\Stringable',
        ]);

    $rectorConfig
        ->ruleWithConfiguration(RenameFunctionRector::class, [
            'collect' => 'Hyperf\Collection\collect',
            'data_fill' => 'Hyperf\Collection\data_fill',
            'data_get' => 'Hyperf\Collection\data_get',
            'data_set' => 'Hyperf\Collection\data_set',
            'value' => 'Hyperf\Collection\value',

            'tap' => 'Hyperf\Tappable\tap',

            'co' => 'Hyperf\Coroutine\co',
            'defer' => 'Hyperf\Coroutine\defer',
            'go' => 'Hyperf\Coroutine\go',
            'parallel' => 'Hyperf\Coroutine\parallel',
            'run' => 'Hyperf\Coroutine\run',
            'wait' => 'Hyperf\Coroutine\wait',

            'env' => 'Hyperf\Support\env',
        ]);
};

运行

./vendor/bin/rector process --autoload-file=vendor/autoload.php --config=rector-hyperf-3.1.x.php 

📢 注意

慎重！！！对现有代码可能造成比较多附带的变动！！！

[huangdijia]

封装成一个组件了 https://github.com/friendsofhyperf/rector ，有兴趣的试试。

[binaryfire]

Hi @huangdijia. What about the config() helper in Hyperf 3.1? Will we need to import the function?

[huangdijia]

https://github.com/friendsofhyperf/rector/blob/main/config/sets/hyperf31.php

The config function has been handled.