Laravel の TrimStrings ミドルウェアが問題を引き起こす仕組み

Laravel は PHP の世界で人気のフレームワークであり、開発者に作業を簡素化する優れたツールを提供します。ただし、これらの利便性が予期せぬ問題を引き起こす場合があります。この投稿では、Laravel の TrimStrings ミドルウェアがどのように問題を引き起こす可能性があるか、そしてその解決方法について説明します。

TrimStrings ミドルウェアとは何ですか?またその機能は何ですか?

TrimStrings ミドルウェアは、フォーム入力などの受信リクエスト データから空白を自動的にトリミングするために Laravel アプリケーションで使用されます。これは、ユーザーが入力フィールドの先頭または末尾に誤ってスペースを入れてしまった場合に特に便利です。たとえば、ユーザーがフォームで電子メール アドレスの前後にスペースを入れて「 user@example.com 」と入力すると、TrimStrings ミドルウェアはこれらのスペースをトリミングし、「user@example.com」のみが処理されるようにします。 .

この機能は、不要な空白によって引き起こされるエラーを防ぎ、よりクリーンなデータを処理するのに役立ちます。ただし、いつものように、特定の特殊なケースでは、このデフォルトの動作が予期せぬ結果を招く可能性があります。

どうしたの？

ブラジルに拠点を置く決済プロバイダーと統合していたプロジェクトでは、コールバック システムを通じて支払い結果を取得して検証する必要がありました。支払いプロバイダーは、POST リクエストを介してトランザクション結果を当社のサーバーに送信し、当社は署名/ハッシュ検証を実行することでリクエストを検証します。

この検証プロセスは単純なロジックに従います:

1. 当社はプロバイダーから送信されたデータを受け取ります。
2. すべてのデータが 1 つの文字列に連結されます。
3. この文字列は、支払いプロバイダーから提供される秘密鍵を使用してSHA256アルゴリズムを使用してハッシュされます。
4. 結果のハッシュは、プロバイダーによって送信されたハッシュと比較されます。それらが一致する場合、リクエストは受け入れられます。それ以外の場合は拒否されます。

問題をどのように特定したか?

当初、一部の有効なリクエストが拒否される理由を理解するのは困難でした。ただし、Nginx ログを検査した結果、受信リクエストの full_name パラメーターの末尾にスペースが残っていることがわかりました。それにもかかわらず、私たちのサーバーではこれらのスペースがトリミングされていたため、ハッシュ検証が失敗しました。このとき、TrimStrings ミドルウェアがこの問題の原因であることがわかりました。

解決策は何ですか?

このような問題を回避するには、特定のルートまたはリクエストに対して TrimStrings ミドルウェアを無効にする必要があります。 Laravel 8 では、この状況に合わせたソリューションを提供する TrimStrings::skipWhen メソッドが導入されました。

以下は、プロバイダーを使用してこのソリューションを適用する方法の例です。

use Illuminate\Foundation\Http\Middleware\TrimStrings;
use Illuminate\Http\Request;

// ...

TrimStrings::skipWhen(function (Request $request) {
    return $request->is('api/v1/integrations/foo-provider/callback');
});

このコード スニペットは、特定のルートの TrimStrings ミドルウェアを無効にします。この場合、api/v1/integrations/foo-provider/callback ルートからのリクエストに対してトリミングは行われず、ハッシュ検証プロセスがスムーズに機能することが保証されます。

結論

Laravel のデフォルト機能は通常、作業を容易にしますが、特定のシナリオでは予期しない結果につながる可能性があります。したがって、使用するツールがどのように動作するかを理解し、その潜在的な影響を慎重に評価することが重要です。 TrimStrings ミドルウェアはほとんどの場合に便利なツールですが、このようなシナリオでは問題が発生する可能性があります。幸いなことに、TrimStrings::skipWhen のような柔軟なソリューションにより、このような問題を回避できます。

以上がLaravel の TrimStrings ミドルウェアが問題を引き起こす仕組みの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。