差分

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

--- apricot:app:top [2020/05/09 15:25]
y2sunlight [例外クラス]
+++ apricot:app:top [2020/06/03 13:11] (現在)
tanaka [クラスエイリアス]
@@ 行 14: / 行 14: @@
     * [[apricot:app:db-model|Apricot データベースとモデル]]
     * [[apricot:app:user-list|Apricot ユーザ一覧画面]]
-    * [[apricot:app:user-edit|Apricot ユーザ編集画面]]
+    * [[apricot:app:user-edit|Apricot ユーザ登録画面]]
     * [[apricot:app:validation|Apricot バリデーション]]
     * [[apricot:app:transaction|Apricot トランザクション]]
-  * [[apricot:ext:top|Apricot 拡張]]
+  * [[apricot:ext:middleware|Apricot 拡張]]
-\\
 まずは、apricotのアプリを作る為に以下を準備します。
@@ 行 32: / 行 31: @@
 ==== appフォルダ ====
-以下に示すようにプロジェクトフォルダ下に、アプリ用のフォルダ app を作成し、その下に７つのフォルダ(Controllers, Exceptions, Foundation, Helpers, Middleware, Models, Services)を作成します。
+以下に示すようにプロジェクトフォルダ下に、アプリ用のフォルダ app を作成し、その下に７つのフォルダ(Controllers, Exceptions, Foundation, Helpers, Middleware, Models, Services)を作成します。また、Controllersの下にはInterceptorsフォルダを作成します。
 <code>
@@ 行 40: / 行 39: @@
  |    |
  |    ├── Controllers [コントローラ]
+ |    |    |
+ |    |    └── Interceptors [インターセプター]
+ |    |
  |    ├── Exceptions [例外]
  |    ├── Foundation [基盤]
@@ 行 45: / 行 47: @@
  |    ├── Middleware [ルミドルウェア]
  |    ├── Models     [モデル]
- |    └── Services   [サービス]
+ |    └── Services   [サービス] (予約)
 </code>
@@ 行 146: / 行 148: @@
 </code>
-  * よく使うコアクラスとアプリ用のヘルパークラスのアリアスを作っています
+  * よく使うコアクラスとアプリ用のヘルパークラスのエイリアスを作っています
@@ 行 261: / 行 263: @@
 </code>
-  * エラーメッセージがユーザ表示用( $user_message )とエラーログなどで使用する内部用( $internal_message )と２つあります。
+  * コンストラクタの引数のエラーメッセージが、ユーザ表示用( $user_message )と内部用( $internal_message )の２つがあります。
   * ユーザ表示用のメッセージは、''getUserMessage()'' メソッドで取得できます。
-  * 他の機能は継承元の Exceptionクラス と同じです。
+  * コンストラクタ内で使用されているボイラープレート ''%%__%%()'' はトランスレータ [[apricot:core:basic-class#langクラス|Core\Lang::get()]] を呼び出しています。トランスレータへの引数 'messages.error.unknown' は言語テキストのキーです(ドット表記)。
-  * コンストラクタ内で使用されているボイラープレート ''%%__%%()'' はトランスレータ [[apricot:core:basic-class#langクラス|Core\Lang::get()]] を呼び出しています。
 次に、ApplicationException から継承した楽観的ロック例外クラス OptimissticLockException を作ります。
@@ 行 291: / 行 291: @@
 }
 </code>
+  * コンストラクタ内で使用されているボイラープレート ''%%__%%()'' はトランスレータ [[apricot:core:basic-class#langクラス|Core\Lang::get()]] を呼び出しています。トランスレータへの引数 'messages.error.db.optimisstic_lock' は言語テキストのキーです(ドット表記)。
 このようにして、アプリで発生する例外は ApplicationException から継承して作るようにします。
@@ 行 355: / 行 357: @@
             {{--
-            @if(app_has('auth'))
+            @if(app('auth.menu',false))
             <ul class="navbar-nav ml-auto">
                 <a id="navbarDropdown" class="nav-link dropdown-toggle" href="#" role="button" data-toggle="dropdown" aria-haspopup="true" aria-expanded="false" v-pre>
-                    {{user()->account}} <span class="caret"></span>
+                    {{AuthUser::getUser()->account}} <span class="caret"></span>
                 </a>
                 <div class="dropdown-menu dropdown-menu-right" aria-labelledby="navbarDropdown">
@@ 行 397: / 行 399: @@
     </main>
-    <footer class="fixed-bottom bg-secondary text-center text-light py-1">&copy; 2020 y2sunlight</footer>
+    <footer class="fixed-bottom bg-secondary text-center text-light py-1">{{env('APP_NAME')}} &copy; 2020 y2sunlight</footer>
     {!! DebugBar::render() !!}
 </body>
@@ 行 415: / 行 417: @@
       * ''@yield('title')'' を使って、個々の画面のタイトルを生成します
       * ''@yield('content')'' を使って、個々の画面のコンテンツを生成します
+      * ''@if'', ''@foreach'' はPHPの if, foreach と同じ機能を持つ制御ディレクティブです
       * テンプレード変数 ''$errors'' が空でない場合はエラー表示します
       * フラッシュ変数 ''msg'' があるときはメッセージを表示します
@@ 行 420: / 行 423: @@
   * **ボイラープレート**
-    * ''__()'' はトランスレータ [[apricot:core:basic-class#langクラス|Core\Lang::get()]] を呼び出しています。
+    * ''__()'' はトランスレータ [[apricot:core:basic-class#langクラス|Core\Lang::get()]] を呼び出しています。トランスレータへの引数は言語テキスト(assests/lang/ja/messages.php)のキーです(ドット表記)。
     * ''url_ver()'' はHTMLリソースをバージョニング対応する[[apricot:core:application-class#applicationクラスのヘルパー関数|Applicationクラスのヘルパー関数]]です。\\ (バージョニングとは、静的なHTMLリソースの更新をブラウザに通知する為に、静的ファイルの後ろに ''?v={version no}'' などのクエリ文字列を追加する事を指します)
     * ''route()'' はルートパスをURLに変換する[[apricot:core:application-class#applicationクラスのヘルパー関数|Applicationクラスのヘルパー関数]]です。
     * ''user()'' はログインユーザのエンティティを呼び出します(後述のユーザ認証で説明)。
+    * ''env()'' は環境設定を取得する[[apricot:core:top#ヘルパー|ヘルパー関数]]です。
->''<nav>'' の中の ''@if(app_has('auth'))'' の部分は後述のユーザ認証で説明します。この段階ではコメントアウトされています。
+>''<nav>'' の中の ''@if(app('auth.menu',false))'' の部分は後述のユーザ認証で説明します。この段階ではコメントアウトされています。
 HTMLテンプレートに関しては本編[[http://www.y2sunlight.com/ground/doku.php?id=basic-library:bladeone:3.37|BladeOne]]のリンクを項を参照して下さい。
@@ 行 553: / 行 557: @@
      * @return \Core\Foundation\Response
      */
-    function index(int $no=null)
+    public function index(int $no=null)
     {
         $title = "Stub {$no}";
@@ 行 589: / 行 593: @@
 {{-- コンテンツ --}}
 @section('content')
-    @foreach($messages as $message)
+    @if(!empty($messages))
-    <p>{{$message}}</p>
+      @foreach($messages as $message)
-    @endforeach
+      <p>{{$message}}</p>
+      @endforeach
+    @endif
 @endsection
 </code>
@@ 行 598: / 行 604: @@
   * ''push''ディレクティブで layoutテンプレートの ''scripts''スタック にコードを追加しています。\\ (ここでは書くべきJavascriptがないので何も追加していません)
   * ''section''で layoutテンプレートの ''title'' と ''content'' セクションを生成しています。
+  * ''@if'', ''@foreach'' はPHPの if, foreach と同じ機能を有するディレクティブです。
 HTMLテンプレートに関しては本編[[http://www.y2sunlight.com/ground/doku.php?id=basic-library:bladeone:3.37|BladeOne]]のリンクを項を参照して下さい。

Ground Sunlight

ユーザ用ツール

サイト用ツール

差分

ページ用ツール