PHP7系(7.4)を利用しております。
構成として主要なビジネスロジックはサービスクラスに記述し、コントローラーは必要な処理が記述されたサービスを呼び出し利用しています。
APIサービスのような場合、例えばあるユーザーIDに対応したユーザー情報を返す場合であれば以下のような構成となります。
class UserController { public function get(int $loginId) { $result = UserService::get($loginId); http_response_code($result["code"]): echo $result["body"]; } } class UserService { public static function get(int $loginId) { $result = []; // ユーザーモデルからログインIDに対応したユーザー情報を取得 $user = User::get($loginId); // ユーザーが見つからない場合 if(is_null($user)){ $result["code"] = 400; $result["body"]["error"] = "ユーザーがいません"; }else{ // 該当するユーザーが見つかった場合は、ユーザー情報を返す $result = $user; } return $result; } }
引き渡されたユーザーIDに対応したユーザーがいる場合はそのユーザー情報を返し、該当するユーザーがいない場合はそれに応じたエラーメッセージを返す為、応答結果のデータをサービス側で作成し、コントローラ側では返された内容に寄ってレスポンスを生成しています。
このケースだけであればこれでも良いのですが、例えば別なサービスからサービス内のメソッドが呼び出される場合にこの方法では不都合がでます。
例えば、同じようなユーザー情報を参照するケースでいえばログイン処理が考えられます。
class AuthenticationController { public function login($request) { $result = AuthenticationService::login($request->loginId, $request->password); http_response_code($result["code"]): echo $result["body"]; } } class AuthenticationService { public static function login(string $loginId, string $password) { $result = []; // ユーザーサービスを経由してユーザーモデルからログインIDに対応したユーザー情報を取得 $user = UserService::get($loginId); // ユーザーが見つからない場合 if(is_null($user)){ $result["code"] = 400; $result["body"]["error"] = "ユーザーがいません"; }else{ // パスワードの検証 if(password_verify($password, $user->passwordHash)){ // パスワードが一致した場合はログインに成功したユーザー情報を返す $result = $user; }else{ $result["code"] = 400; $result["body"]["error"] = "パスワードが一致しません"; } } return $result; } }
※本来検証結果の詳細はセキュリティ上返すべきではありませんが、ここではわかりやすくするためにあえて返す前提としています
当然ですがこの内容では正常に動作しません。
理由としてはUserServiceはそもそもコントローラがレスポンスを返す為の情報を前提に返値を構成している為、純粋なユーザーモデルを返していない為です。
このようにサービス内のメソッドがコントローラーから呼び出される場合と、サービスから呼び出される場合で同じメソッドであっても期待する返値に違いがあり、こういった場合にどのように実装するべきか悩んでおります。
一時期例外処理を使う方法も考えましたが、そもそも例外処理は制御を行う為に用いてはならないという情報を見つけており、こういったケースで使うのは適切ではないと考えています。
別な方法としては全てのサービスからそれぞれのモデルを参照する方法も考えていますが、そうすると例えば取得結果に対して一定の処理が必要となるようなケースではモデル側にそういった処理を実装する必要が出るため、サービスの役割とモデルの役割が曖昧になるのではないかとも考えています。
このような場合、どのように実装するのが良いのでしょうか。
あなたの回答
tips
プレビュー