Laravelサービスに何を書くべきか

Laravel の継続的な開発により、サービスは Laravel フレームワークの重要なコンポーネントになりました。サービスの役割とは何ですか? Laravelでサービスを使用するにはどうすればよいですか?この記事では、Laravel Serviceの関連知識を詳しく紹介します。

1. サービスの役割

サービスとは、支払い、従業員管理、データ分析などに関連するビジネス ロジックなど、プロジェクトで使用されるビジネス ロジックを指します。 Laravel フレームワークでは、Service は主に、面倒なビジネス ロジックを処理し、それを再利用可能なコンポーネントにカプセル化して、複数のコントローラー、リポジトリ、およびサービスで呼び出すことができるようにするために使用され、コードの再利用率が向上し、コードの冗長性が削減されます。

通常、サービスとリポジトリはデータに対する一連のビジネス操作を実装するために使用されますが、ビジネスの高度な抽象化と簡素化を達成するには、サービスをさらにカプセル化する必要があります。サービスはクライアント要求を受け入れ、ビジネス ロジックを処理し、結果を返すか例外をスローします。

リポジトリとは異なり、サービスは多くのビジネス ロジックをカプセル化します。さまざまなビジネス機能に対して、複数の異なるサービス クラスを作成して、コードの論理的分割を容易にすることができます。

2. Service の実装方法

Service を使用するときは、Service クラスの作成と、必要に応じて Service クラスの呼び出しという 2 つの側面に注意する必要があります。コードについては以下で詳しく説明します。

1. サービスの作成

サービスを作成するときは、サービスの関数と呼び出し元を考慮する必要があります。通常の状況では、いくつかの基本的な追加、削除、変更、およびクエリ操作がサービスに実装されるだけでなく、その他のより具体的なビジネス ロジックも実装されます。

以下では、Service の従来の実装を示すために、ユーザーが登録した Service を例に挙げます。

<?php

namespace AppServices;

use AppRepositoriesUserRepository;

class RegisterService
{
    protected $userRepository;

    /**
     * RegisterService constructor.
     *
     * @param UserRepository $userRepository
     */
    public function __construct(UserRepository $userRepository)
    {
        $this->userRepository = $userRepository;
    }

    /**
     * 用户注册.
     *
     * @param array $data
     *
     * @return mixed
     */
    public function register(array $data)
    {
        // TODO: 进一步验证
        $this->userRepository->create($data);
    }
}

上記のコードでは、最初の名前空間は AppServices で、Service のクラス名は RegisterService です。 UserRepository オブジェクトをコンストラクターに挿入する必要があります。 Service では、ユーザー登録ロジックを実装し、UserRepository の create() メソッドを使用してデータベースに新しいユーザーを作成しました。

2. サービスの呼び出し

サービスが利用可能になったら、コントローラーとリポジトリで呼び出す必要があります。以下では、呼び出しコードを示すために、例としてコントローラーで RegisterService を呼び出します。

<?php

namespace AppHttpControllers;

use AppHttpRequestsRegisterRequest;
use AppServicesRegisterService;

class RegisterController extends Controller
{
    public function register(RegisterRequest $request, RegisterService $registerService)
    {
        // TODO: 调用 Service 进行注册
        $registerService->register($request->validated());
    }
}

上記のコードでは、RegisterService を使用する場合、そのコンストラクターで UserRepository オブジェクトを渡す必要があり、呼び出し時に、 RegisterController のメソッドに渡す RegisterService オブジェクトをパラメータに注入します。

3. Service で注意が必要なその他の問題

Laravel で Service を使用する場合は、次の問題にも注意する必要があります:

1. Service は単なるサービスです。クラスに依存することができ、他のサービス、リポジトリ、または他のクラスを使用する場合は、コンストラクターに依存関係を注入する必要があります。
2. サービスは特定のビジネス ロジックを実装する必要があり、そのためにはサービスをシンプルかつ軽量に保つ必要もあります。サービスによって実装されるビジネスが複雑すぎる場合は、サービスの分割を検討する必要があります。一般に、各サービスは単一の機能のみを実装することをお勧めします。
3. サービスにビューレベルのロジック処理を含めないでください。サービスのロジックは、コントローラーや他の呼び出されるサービスのロジックとは無関係である必要があります。

4. 結論

サービスは Laravel の重要なコンポーネントの 1 つであり、ビジネス ロジック コンポーネントとしてのその利点は非常に明白です。 Laravel 5.8/6 以降、Laravel はより便利な Service 自動登録メカニズムを正式に導入し、Service の統合が容易になりました。ビジネス ロジックがますます複雑になる場合、サービス組織のコードはより明確で理解しやすくなり、コードの複雑さが簡素化され、拡張性と保守性が向上します。

以上がLaravelサービスに何を書くべきかの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。