ダウンロードnever throw - ソースコードのダウンロードnever throw

never throw

その他のカテゴリー

v2.0.0

ダウンロード

ShipsaasはPHPを使用しません

PHPアプリケーションの成功とエラーの結果に対処するための厳密に型付けられた方法を提供します。

Neverthrowに触発されたので、ここではPHPからのNeverthrowの簡単な実装を行っています。

スローとキャッチングは、GOTOステートメントを使用することと非常によく似ています。それはあなたのプログラムについての推論をより難しくします。第二に、スローを使用することにより、関数の発信者がキャッチを実装していると仮定します。これは既知のエラーソースです。例：1つの開発者がスローし、もう1つの開発者は、関数がスローするという事前知識なしに関数を使用します。したがって、エッジケースは未解決のままにされており、今では不幸なユーザー、ボス、猫などがいます。
とはいえ、プログラムを投入するための良いユースケースが間違いなくあります。しかし、あなたが思っているよりもはるかに少ない。

TL; DR：スローなし=より幸せな生活とアプリケーション。 PHPアプリでは、生産のエラーが少なくなり、ドライと再利用可能なものが増加します。

サポート

V2.0.0以降のPHP 8.2+

インストール

composer require shipsaas/never-throw

トップレベルAPI

NeverThrow\Result 、いつでも拡張する準備ができています。

非静止

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

使用法

応答クラスを作成します

成功とエラーという2つの新しいクラスを作成します。そして、お気軽にデータを入れてください

 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
    ) {}
}

専用の結果クラスを作成します

ネバースローを使用する前の最後のステップ。専用の結果クラスを作成するのに役立ちます：

エラーと成功結果クラスのタイプを定義します
- => ide-frendly
- =>より幸せなリーダー/発信者
成功とエラーの結果クラスを参照する集中的な場所。

最初の方法

 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虐待を試してください
例外ではありません
明示的な返品タイプと情報。

それは開発を本当に素晴らしいものにし、痛みはありません。

厳密にタイプされたリターンタイプを使用すると、開発者は他のサービス/ライブラリで何が起こっているかを知ることができます。したがって、再利用性を向上させます。そして、私たちは私たちのコードを試して、キャッチしてuglifeする必要はありません。

例外を乱用しないでください。予期しない状況（およびエラー！==例外、事実）にのみ使用する必要があります。

追加

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