osmianski/not-implemented

一个简单的库,帮助您永远不忘掉应用程序中未实现的部分。

v0.1.0 2023-03-28 19:33 UTC

This package is auto-updated.

Last update: 2024-09-28 22:41:35 UTC


README

一个简单的库,帮助您永远不忘掉应用程序中未实现的部分。

安装

使用以下命令将 Composer 包添加到您的项目中

composer require osmianski/not-implemented

用法

您是否曾经忘记返回这样的评论?

function foo(?Bar $bar): void {
    // TODO: handle nulls
    ...
}

以前,我也有过这种情况。

不再有了。

我发现抛出 NotImplemented 异常而不是简单的注释,可以让您立即偿还这部分技术债务。

use Osmianski\Exceptions\NotImplemented;
...

function foo(?Bar $bar): void {
    if (!$bar) {
        throw new NotImplemented();        
    }
    
    ...
}

最近,我发现 PhpStorm 中有一个非常实用的功能,称为“异常断点”。其想法是,每当抛出指定的异常时,调试器会停止在抛出异常的行。

这与 NotImplemented 异常完美匹配。配置后,当执行遇到尚未实现的功能或特殊情况时,调试器会随时停止。

通过按下 运行 -> 查看断点运行 -> 查看断点 中配置它,按 + -> PHP 异常断点,输入完整的异常类名,然后按“确定”

Exception Breakpoints

许可证

本软件包是开源软件,根据 MIT 许可证授权。