Ground Sunlight

Windowsで作る - PHPプログラミングの開発環境

ユーザ用ツール

サイト用ツール

トレース: • Apricot サービスプロバイダー
apricot:usage:ja:provider

差分

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

この比較画面にリンクする

両方とも前のリビジョン 前のリビジョン
次のリビジョン 		前のリビジョン
apricot:usage:ja:provider [2020/08/29 16:55]
y2sunlight [DIコンテナの使用例] 		apricot:usage:ja:provider [2020/09/03 13:46] (現在)
y2sunlight [Apricot サービスプロバイダー]
行 1: 行 1:
-> 編集中 
- 
----- 
- 
 ====== Apricot サービスプロバイダー ====== ====== Apricot サービスプロバイダー ======
  --- //[[http://www.y2sunlight.com|y2sunlight]] 2020-07-29//  --- //[[http://www.y2sunlight.com|y2sunlight]] 2020-07-29//
行 21: 行 17:
   * [[apricot:usage:ja:validation|Apricot バリデーション]]   * [[apricot:usage:ja:validation|Apricot バリデーション]]
   * Apricot サービスプロバイダー   * Apricot サービスプロバイダー
 +  * [[apricot:usage:ja:authentication|Apricot ユーザ認証]]
   * [[apricot:usage:ja:utility|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')              ->addArgument('User')
         ;         ;
- 
         $this->getContainer()->add('User', \App\Models\User::class);         $this->getContainer()->add('User', \App\Models\User::class);
      }      }
行 90: 行 84:
 スケルトンでは[[apricot:usage:ja:model#サービス|サービスのサンプル]]として ''SampleService'' クラスを提供しています。このクラスはコンストラクタに''User'' モデルを与えて作ります。 スケルトンでは[[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/|こちら]]をご覧ください。 サービス（またはモデル）をサービスプロバイターに登録する場合は、上例に習って適宜追加して下さい。League/Container のサービスプロバイダーについての詳細は[[https://container.thephpleague.com/3.x/service-providers/|こちら]]をご覧ください。
行 96: 行 90:
 \\ \\
  
-===== App\Foundation\Containerクラス =====+===== Containerクラス =====
  
-サービスプロバイダーで登録してサービス（またはモデル） +サービスプロバイダーで登録したサービス（またはモデル）を取得するには、''App\Foundation\Container'' クラスを使用します。このクラスは、''\League\Container\Container'' をシングルトンにしたもので、以下のメソッドがあります。これらのメソッドは [[https://www.php-fig.org/psr/psr-11/|PSR-11]] に準拠しています。
- +
-App\Foundation\Containerクラスは、\League\Container\Container クラスを生成し、Apricotのサービスプロバイダー(Provider)を登録したクラスで、シングルトンとして動作します。 +
- +
-サービスの使用者は、''App\Foundation\Container''が持っている [[https://www.php-fig.org/psr/psr-11/|PSR-11]] に準じた ''get()'' と ''has()'' を使ってサービスを利用することができます。+
  
 使用法: ** Container::{メソッド} ** 使用法: ** Container::{メソッド} **
行 109: 行 99:
 |mixed get(string $id)|識別子idでコンテナのエントリを検索して返します。| |mixed get(string $id)|識別子idでコンテナのエントリを検索して返します。|
 |bool has(string $id)|コンテナが指定された識別子idのエントリを返すことができる場合はtrueを返します。| |bool has(string $id)|コンテナが指定された識別子idのエントリを返すことができる場合はtrueを返します。|
- 
-{{fa>folder-open-o}} ** /apricot/app/Foundation ** 
-<code php Container.php> 
-<?php 
-namespace App\Foundation; 
- 
-use Apricot\Foundation\Singleton; 
-use App\Provider; 
- 
-/** 
- * Container class for service 
- * 
- * @method static Container getInstance() Gets the Container instance. 
- * @method static mixed get(string $id) Finds an entry of the container by its identifier and returns it. 
- * @method static bool has(string $id) Returns true if the container can return an entry for the given identifier. 
- */ 
-class Container extends Singleton 
-{ 
-    /** 
-     * Create Container instance. 
-     * @return \League\Container\Container 
-     */ 
-    protected static function createInstance() 
-    { 
-        $container = new \League\Container\Container; 
-        $container->addServiceProvider(new Provider()); 
-        return $container; 
-    } 
-} 
-</code> 
  
 \\ \\
行 144: 行 104:
 ===== 使用例 ===== ===== 使用例 =====
  
-=== スタブコントローラ ===+スタブコントローラのindexアクションには、DIコンテナの使用例があります。
  
-DIコンテナをテストするために、スタブコントローラを以下のように修正します。 +{{fa>folder-open-o}} ** /your-project/app/Controllers **
- +
-{{fa>folder-open-o}} ** /apricot/app/Controllers **+
 <code php StubController.php> <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> </code>
  
-  * ''Container::get('user')'' でユーザモデルを生成します。 +''Container'' シングルトンの ''get()'' メソッドで、サービスプロバイダーでシングルトンとして登録した ''SampleService'' のインスタンスを取得します。このインスタンスはアプリケーション全体で共有されます。
-  * ユーザモデルの ''findAll()'' を実行して全ユーザのリストを取得します。 +
-  * ユーザ数を表示するために、テンプレート変数 ''$messages'' をセットします。+
  
 \\ \\
apricot/usage/ja/provider.1598687735.txt.gz · 最終更新: 2020/08/29 16:55 by y2sunlight

ページ用ツール

特に明示されていない限り、本Wikiの内容は次のライセンスに従います： CC Attribution-Share Alike 4.0 International
CC Attribution-Share Alike 4.0 International Donate Powered by PHP Valid HTML5 Valid CSS Driven by DokuWiki