差分

このページの2つのバージョン間の差分を表示します。

--- apricot:usage:ja:provider [2020/08/29 17:05]
y2sunlight [Containerクラス]
+++ apricot:usage:ja:provider [2020/09/03 13:46] (現在)
y2sunlight [Apricot サービスプロバイダー]
@@ 行 1: / 行 1: @@
-> 編集中
-----
 ====== Apricot サービスプロバイダー ======
  --- //[[http://www.y2sunlight.com|y2sunlight]] 2020-07-29//
@@ 行 21: / 行 17: @@
   * [[apricot:usage:ja:validation|Apricot バリデーション]]
   * Apricot サービスプロバイダー
+  * [[apricot:usage:ja:authentication|Apricot ユーザ認証]]
   * [[apricot:usage:ja:utility|Apricot ユーティリティ]]
 ----
-Apricotでは、DIコンテナーに [[https://github.com/thephpleague/container|League/Container]] を使用しています。League/Container ではサービスプロバイダーを使い、サービスをシングルトンとして登録することができます。
+Apricotでは、DIコンテナーに [[https://github.com/thephpleague/container|League/Container]] を使用しています。Apricotのスケルトンでは、League/Container のサービスプロバイダー機能を利用して、サービス（またはモデルなどのクラスも含まれる）を登録することができます。サービスはアプリレーション全体で共有できます。即ちシングルトンとして利用できます。
-Apricotのスケルトンでは、サービスプロバイターの簡単な例題を提供しています。
 \\
@@ 行 82: / 行 77: @@
              ->addArgument('User')
         ;
         $this->getContainer()->add('User', \App\Models\User::class);
      }
@@ 行 90: / 行 84: @@
 スケルトンでは[[apricot:usage:ja:model#サービス|サービスのサンプル]]として ''SampleService'' クラスを提供しています。このクラスはコンストラクタに''User'' モデルを与えて作ります。
-''SampleService'' クラスをサービスプロバイターに登録するには、コンテナの''add()'' メソッドを使用し、その引数は、エイリアス名、登録するクラス、そしてフラグです。フラグがtrueの場合、このクラスはシングルトンとして動作します。''addArgument()'' メソッドは登録するクラスのコンストラクタに与える引数を定義します。''addArgument()'' メソッドで定義した引数もまたサービスプロバイターに登録しておく必要があります。
+''SampleService'' クラスをサービスプロバイターに登録するには、コンテナの''add()'' メソッドを使用し、その引数は、エイリアス名、登録するクラス、そして共有フラグです。共有フラグがtrueの場合、このクラスはシングルトンとして動作します。''addArgument()'' メソッドは登録するクラスのコンストラクタに与える引数を定義します。この引数もまた''add()'' メソッドで登録しておく必要があります。
 サービス（またはモデル）をサービスプロバイターに登録する場合は、上例に習って適宜追加して下さい。League/Container のサービスプロバイダーについての詳細は[[https://container.thephpleague.com/3.x/service-providers/|こちら]]をご覧ください。
@@ 行 110: / 行 104: @@
 ===== 使用例 =====
-=== スタブコントローラ ===
+スタブコントローラのindexアクションには、DIコンテナの使用例があります。
-DIコンテナをテストするために、スタブコントローラを以下のように修正します。
+{{fa>folder-open-o}} ** /your-project/app/Controllers **
-{{fa>folder-open-o}} ** /apricot/app/Controllers **
 <code php StubController.php>
-<?php
+public function index(int $no=null)
-namespace App\Controllers;
+{
+    $title = "Stub {$no}";
-use App\Foundation\Container;
-use App\Foundation\Controller;
-/**
- * Stub Controller
- */
-class StubController extends Controller
-{
     /**
-     * Index Page for this controller.
+     * @var \App\Services\SampleService $service
-     *
-     * @return \Apricot\Foundation\Response
      */
-    public function index(int $no=null)
+    $service = Container::get('SampleService');
-    {
+    $count = $service->getUserCount();
-        $title = "Stub {$no}";
+    $messages[] = "Number of registered users : {$count}";
-        /*
-         * Example for Container
-         * @var \App\Models\User $user
-         */
-        $user = Container::get('user');
-        $userCount = count($user->findAll());
-        $messages[] = "Number of registered users : {$userCount}";
-        return render('stub',['title'=>$title,'messages'=>$messages]);
+    return render('stub',['title'=>$title,'messages'=>$messages]);
-    }
 }
 </code>
-  * ''Container::get('user')'' でユーザモデルを生成します。
+''Container'' シングルトンの ''get()'' メソッドで、サービスプロバイダーでシングルトンとして登録した ''SampleService'' のインスタンスを取得します。このインスタンスはアプリケーション全体で共有されます。
-  * ユーザモデルの ''findAll()'' を実行して全ユーザのリストを取得します。
-  * ユーザ数を表示するために、テンプレート変数 ''$messages'' をセットします。
 \\

Ground Sunlight

ユーザ用ツール

サイト用ツール

差分

ページ用ツール