使用 Unfinalize 删除供应商软件包中类和方法的 "final "关键字

Laravel  /  管理员 发布于 1年前   311

Unfinalize刚刚发布了v1版本，其发布说明值得你花上一分钟的时间。

Unfinalize 是一个使用 PHP CS Fixer 从作曲家供应商包中永久移除 final 关键字的软件包。

git:

https://github.com/stevebauman
https://github.com/stevebauman/unfinalize/releases/tag/v1.0.0
https://github.com/stevebauman/unfinalize

- final class Foo
+ class Foo
{
-   final public function bar()
+   public function bar()
    {
        // ...
    }
}

当你运行它时，它会执行以下操作：

1.安全、快速、高效地更新 PHP 文件。
2.永久保存更改。使用 Unfinalize 不会影响性能。
3.不会对您的应用程序造成额外的依赖。Unfinalize 及其依赖项被编译到一个 phar 文件中。

https://github.com/stevebauman/unfinalize/blob/master/builds

Unfinalize 的使用

首先安装

composer require stevebauman/unfinalize

然后，在你的 composer.json 文件中，添加你想从里面移除最终关键字的供应商软件包：

{
    "unfinalize": [
        "vendor/package"
    ]
}

接下来，

在你的 composer.json 中添加 unfinalize 命令，这样它就能在 composer 更新时运行了：

{
  "scripts": {
    "post-update-cmd": [
      "@php vendor/bin/unfinalize run"
    ]
  }
}

最后，运行 

composer update

取消最终版本选项

--mark-final

如果你希望用 @final doc 块标记最终类和方法，

可以在 unfinalize 命令中添加 --mark-final 选项：

{
  "scripts": {
    "post-update-cmd": [
      "@php vendor/bin/unfinalize run --mark-final"
    ]
  }
}

这将产生

之前：

final class Foo
{
    final public function bar()
    {
        // ...
    }
}

之后：

/**
 * @final
 */
class Foo
{
    /**
     * @final
     */
    public function bar()
    {
        // ...
    }
}

`--dry`

执行一次模拟运行，查看 PHP CS Fixer 将修改哪些文件。