API インターフェース開発に Hyperf フレームワークを使用する方法

WBOY
リリース: 2023-10-21 10:15:44
オリジナル
1490 人が閲覧しました

API インターフェース開発に Hyperf フレームワークを使用する方法

API インターフェイス開発に Hyperf フレームワークを使用する方法

  1. まえがき
    現在の Web 開発において、API インターフェイスは不可欠な部分となっています。 Hyperf は、Swoole および PHP コルーチンに基づく高性能フレームワークであり、開発者が高性能 API インターフェイスを迅速に構築できるようにするさまざまなツールとコンポーネントを提供します。この記事では、API インターフェイス開発に Hyperf フレームワークを使用する方法を紹介し、具体的なコード例を示します。
  2. 環境セットアップ
    まず、ローカル環境に Hyperf フレームワークの開発環境をセットアップする必要があります。 Composer ツールを使用して、ターミナルで次のコマンドを実行して Hyperf プロジェクトを作成できます。

    composer create-project hyperf/hyperf hyperf-demo
    ログイン後にコピー
  3. API コントローラーの作成
    Hyperf フレームワークでは、次のコマンドを作成して定義できます。コントローラー API インターフェイス。ターミナルでプロジェクトのルート ディレクトリに切り替え、次のコマンドを実行して API コントローラーを作成します。

    php bin/hyperf.php make:controller User
    ログイン後にコピー

    これにより、App/ControllerUserController# という名前の API が作成されます。ディレクトリ ## コントローラ ファイル。

  4. API インターフェイス メソッドの定義


    UserController コントローラー ファイルでは、さまざまな API インターフェイスを処理する複数のメソッドを定義できます。たとえば、getUser という名前のメソッドを定義して、ユーザー情報を取得できます。このメソッドのコード例は次のとおりです。

    <?php
    
    declare(strict_types=1);
    
    namespace AppController;
    
    use HyperfHttpServerAnnotationController;
    use HyperfHttpServerAnnotationGetMapping;
    
    /**
     * @Controller(prefix="/user")
     */
    class UserController
    {
     /**
      * @GetMapping(path="get")
      */
     public function getUser(): array
     {
         return [
             'id' => 1,
             'name' => 'John Doe',
             'email' => 'john.doe@example.com',
         ];
     }
    }
    ログイン後にコピー

    上記のコードでは、

    Controller アノテーションと GetMapping アノテーションを使用してコントローラーとメソッドを識別します。 GetMapping アノテーションは、API インターフェイスのリクエスト メソッドとパスを定義します。

  5. Hyperf サービスを開始します

    ターミナルでプロジェクトのルート ディレクトリに切り替え、次のコマンドを実行して Hyperf サービスを開始します:

    php bin/hyperf.php start
    ログイン後にコピー

    正常に起動したら, Hyperf はアドレス

    http://127.0.0.1:9501 でリッスンします。

  6. テスト API インターフェイス
  7. Postman やcurl コマンドなどの API テスト ツールを使用して、GET リクエストを
    http://127.0.0.1:9501/user/get に送信します。 ユーザー情報を取得するためのアドレス。
  8. インターフェイスの検証と例外処理
  9. 実際の開発では、API インターフェイスの検証と例外処理が必要になることがよくあります。 Hyperf フレームワークは、これらの機能を簡単に実装するための豊富な検証および例外処理ツールを提供します。
たとえば、パラメータ検証と例外スロー コードを

getUser メソッドに追加できます。

<?php

declare(strict_types=1);

namespace AppController;

use HyperfHttpServerAnnotationController;
use HyperfHttpServerAnnotationGetMapping;
use AppRequestUserRequest;
use HyperfDiAnnotationInject;
use HyperfValidationContractValidatorFactoryInterface;

/**
 * @Controller(prefix="/user")
 */
class UserController
{
    /**
     * @Inject
     * @var ValidatorFactoryInterface
     */
    protected $validationFactory;

    /**
     * @GetMapping(path="get")
     */
    public function getUser(UserRequest $request): array
    {
        $validator = $this->validationFactory->make($request->all(), $request->rules());

        if ($validator->fails()) {
            throw new InvalidArgumentException($validator->errors()->first());
        }

        return [
            'id' => 1,
            'name' => 'John Doe',
            'email' => 'john.doe@example.com',
        ];
    }
}
ログイン後にコピー
上記のコードでは、

UserRequest を使用します。 ユーザーリクエストパラメータの検証ルールを定義するクラス。依存関係注入を通じて ValidatorFactoryInterface インターフェイスを取得し、その make メソッドを使用してバリデーターを作成します。検証が失敗した場合は、InvalidArgumentException 例外がスローされます。

    結論
  1. この記事の導入部を通じて、API インターフェイス開発に Hyperf フレームワークを使用する方法を学び、具体的なコード例を提供しました。 Hyperf フレームワークは、開発者が高性能の API インターフェイスを迅速に構築できるようにする豊富なツールとコンポーネントを提供します。この記事が API インターフェース開発のお役に立てば幸いです。

以上がAPI インターフェース開発に Hyperf フレームワークを使用する方法の詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。

ソース:php.cn
このウェブサイトの声明
この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。
最新の問題
人気のチュートリアル
詳細>
最新のダウンロード
詳細>
ウェブエフェクト
公式サイト
サイト素材
フロントエンドテンプレート