never throw下载 - never throw源代码下载

never throw

其他类别

v2.0.0

下载

Shipsaas从未为PHP

提供一种严格键入的方法来处理PHP应用程序的成功和错误结果。

受到Neverwor的启发，因此我们正在简单地实现PHP的Never。

投掷和捕捉与使用goto语句非常相似 - 换句话说；它更加努力地对您的程序进行理由。其次，通过使用抛出，您可以假设功能的呼叫者正在实现捕获量。这是已知的错误来源。示例：一个开发人员抛出，另一个开发人员使用该功能，而无需事先知道该功能会投掷。因此，Edge Case已被遗忘了，现在您有不愉快的用户，老板，猫等。
话虽如此，肯定有一些很好的用例可以投入您的程序。但是比您想象的要少得多。

tl; dr：no throw =更快乐的生活和应用。生产中的错误较少，并增加了PHP应用中的干燥和可重复使用的东西。

支持

自v2.0.0以来

安装

composer require shipsaas/never-throw

顶级API

NeverThrow\Result类，并随时可以延长。

非静态

isOk()
isError()
getOkResult()
getErrorResult()

用法

创建您的响应课程

我们将创建两个新类：成功和错误。并随意放置您的任何数据

 use NeverThrow  SuccessResult ;
use NeverThrow  ErrorResult ;

// Success
class BookShipperOkResult extends SuccessResult
{
    public function __construct (
        public string $ bookingId
    ) {}
}

enum BookingErrors {
    case NO_SHIPPER_AVAILABLE ;
    case OVERWEIGHT_PACKAGE ;
    case INVALID_ADDRESS ;
}

// Error
class BookShipperErrorResult extends ErrorResult
{
    public function __construct (
        public BookingErrors $ outcome
    ) {}
}

创建您的专门结果类

最后一步，然后使用Neverthrow。创建专门的结果课程有助于我们：

为错误和成功结果类定义类型
- =>对IDE友好
- =>更快乐的读者/呼叫者
参考成功和错误结果类的集中位置。

第一条方法

 use NeverThrow  Result ;

class BookShipperResult extends Result
{
    public function getOkResult (): BookShipperOkResult
    {
        return parent :: getOkResult ();
    }
    
    public function getErrorResult (): BookShipperErrorResult
    {
        return parent :: getErrorResult ();
    }
}

返回您的业务逻辑中的结果

 public function createBooking ( User $ user , BookingOrder $ order ): BookShipperResult
{
    $ hasAnyShipperAvailable = $ this -> shipperService -> hasAnyShipperAvailable ();
    if (! $ hasAnyShipperAvailable ) {
        return new BookShipperResult (
            new BookShipperErrorResult (
                BookingErrors:: NO_SHIPPER_AVAILABLE
            )
        );
    }
    
    $ isOverweight = ! $ this -> weightService -> isValid ( $ order );
    if ( $ isOverweight ) {
        return new BookShipperResult (
            new BookShipperErrorResult (
                BookingErrors:: OVERWEIGHT_PACKAGE
            )
        );
    }
    
    $ bookingId = $ this -> book ( $ user , $ order );
   
    return new BookShipperResult ( new BookShipperOkResult ( $ bookingId ));
}

检查响应

 $ bookingResult = $ this -> service -> createBooking ( $ user , $ order );

if ( $ bookingResult -> isError ()) {
    $ errorResult = $ bookingResult -> getErrorResult ();

    // handle error
    return showError ( match ( $ errorResult -> outcome ) {
        BookingErrors:: NO_SHIPPER_AVAILABLE => ' No shipper available at the moment. Please wait ' ,
        BookingErrors:: OVERWEIGHT_PACKAGE => ' Your package is overweight ' ,
    });
}

return showBooking ( $ bookingResult -> getOkResult ()-> bookingId );

结论

正如您在上述代码中看到的那样，有：

没有尝试/捕获，0尝试/捕获滥用
也不例外，永远不会
明确的返回类型和信息。

这将使发展真正令人敬畏，没有痛苦。

有了严格键入的返回类型，开发人员可以知道其他服务/库的情况。因此，可重复使用的更好。而且我们不必包装尝试/捕捉并丑化我们的代码。

不要滥用例外，它们应仅用于意外情况（和错误！==例外，事实）。

额外的

 function transfer (): Transaction
{
    if (! $ hasEnoughBalance ) {
        thrown new InsufficientBalanceError ();
    }
    
    if (! $ invalidRecipient ) {
        throw new InvalidRecipientError ();
    }
    
    if (! $ invalidMoney ) {
        throw new InvalidTransferMoneyError ();
    }
    
    $ transaction = $ this -> transferService -> transfer (...);
    if (! $ transaction ) {
        throw new TransferFailedError ();
    }
    
    return $ transaction ;
}