差分

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

--- apricot:usage:ja:config [2020/07/29 14:45]
tanaka [配置]
+++ apricot:usage:ja:config [2020/08/12 10:07]
y2sunlight [Apricot 配置と構成]
@@ 行 1: / 行 1: @@
-> 編集中
-----
 ====== Apricot 配置と構成 ======
  --- //[[http://www.y2sunlight.com|y2sunlight]] 2020-07-29//
-[[apricot:usage:ja|Apricotの使用法 に戻る]]
+[[apricot:usage:ja|Apricot ドキュメント に戻る]]
 目次
+  * [[apricot:usage:ja:features|Apricot 特徴と概要]]
   * Apricot 配置と構成
+  * [[apricot:usage:ja:errors-logging|Apricot ログとエラー処理]]
   * [[apricot:usage:ja:http|Apricot リクエストとレスポンス]]
   * [[apricot:usage:ja:frontend|Apricot フロントエンド]]
@@ 行 16: / 行 14: @@
   * [[apricot:usage:ja:middleware|Apricot ミドルウェア]]
   * [[apricot:usage:ja:controller|Apricot コントローラ]]
-  * [[apricot:usage:ja:errors-logging|Apricot ログとエラー処理]]
   * [[apricot:usage:ja:utility|Apricot ユーティリティ]]
 ----
-===== 配置 =====
+===== ディレクトリー構成 =====
+以下にプロジェクトディレクトリーの構成を示します。
-以下にプロジェクトフォルダの構成を示します。
+{{fa>folder-open-o}} ** /your-project **
+<code>
+your-project [プロジェクトディレクトリー]
+ |
+ ├── app
+ ├── assets
+ ├── config
+ ├── core
+ ├── public
+ ├── var
+ └── vendor
+</code>
-''your-project''がプロジェクトフォルダになります。この名前は任意に付けることができますが、プロジェクトフォルダ以下の名前については規則があり、変更することはできません。主要なソースコードは ''core'' と ''app'' に存在し、これらには名前空間としてそれぞれ ''Core''と''App''が付与されており、オートローディングを有効にするために、''composer.json'' で ''autoload'' を追加しています。
+=== appディレクトリー===
+アプリケーションの本体を配置するディレクトリーで以下サブディレクトリーがあります。
+  * ''Foundation'' --- コントローラ、モデル、エラーバッグなどのベースクラス
+  * ''Exceptions'' --- アプリケーション例外クラスと集約例外コントローラ
+  * ''Models'' --- 通常データベースのテーブル単位で作り、アプリケーションのデータモデル
+  * ''Controllers'' --- 通常画面単位に作り、URLと結びついたアクション(メソッド)から
+  * ''Middleware'' --- アクション起動時の前処理(まはた後処理)を行うミドルウェア
+  * ''Helpers'' --- ビューヘルパーなどの共通のユーティリティクラス
+=== assetsディレクトリー ===
+アプリケーションのリソースを配置し以下サブディレクトリーがあります。
+  * ''views'' --- 画面を作成するHTMLテンプレート(BladeOneで使用)
+  * ''lang'' --- トランスレーションの為の言語別のテキスト
+  * ''sql'' --- データベース構築の為のSQLファイル
+=== configディレクトリー ===
+アプリケーションの設定を配置し以下サブディレクトリーがあります。
+  * ''setup'' --- アプリケーション起動時のセットアップファイル
+  * ''setting'' --- 機能別の設定ファイル
+=== coreディレクトリー ===
+Apricotのコアクラスを配置します。コアクラスはApricotフレームワークライブラリとして提供され、次の３つの主要な目的があります。
+  * アプリケーションの構成管理を提供します。
+  * ロギング、例外集約、デバックの機能を提供します。
+  * リクエストからレスポンスまでのアプリケーションの標準的な処理方法を提供します。
+=== publicディレクトリー ===
+公開用のディレクトリーです。ここにApricotのフロントコントローラ( ''index.php'' )があります。
+=== varディレクトリー ===
+アプリケーションの次のデータを保存するディレクトリーで以下サブディレクトリーがあります。
+  * ''logs'' --- ログファイル
+  * ''cache'' --- キャッシュファイル
+  * ''db'' --- データベースファイルなど
+=== vendorディレクトリー ===
+Composerが使用する外部ライブラリーの保存ディレクトリーです。
+\\
+===== public ディレクトリー =====
+''public'' ディレクトリーの下には以下に示すようなディレクトリーとファイルが存在します。
-{{fa>folder-open-o}} ** /your-project **
 <code>
-your-project [プロジェクト]
+your-project [プロジェクトディレクトリー]
  |
- ├── app [アプリケーション]
- |    |
- |    ├── Controllers [コントローラ]
- |    ├── Exceptions [例外]
- |    ├── Foundation [基盤]
- |    ├── Helpers    [ヘルパー]
- |    ├── Middleware [ミドルウェア]
- |    ├── Models     [モデル]
- |    └── Services   [サービス](Option)
- |
- ├── assets [リソース]
- |    |
- |    ├── lang  [言語別の出力テキスト]
- |    ├── sql   [SQLファイル]
- |    └── views [HTMLテンプレート]
- |
- ├── config [設定ファイル]
- |    |
- |    ├── setting [機能別の一般設定]
- |    └── setup   [機能別の起動設定]
- |
- ├── core [Apricotのコア]
- |    |
- |    ├── Derivations [ライブラリの派生クラス]
- |    ├── Exceptions  [例外]
- |    ├── Foundation  [基盤]
- |    └── helpers     [ヘルパー関数]
- |
  ├── public [公開フォルダ]
  |    |
- |    ├── css/
+ |    ├── css/        [cssファイル用]
- |    ├── img/
+ |    ├── img/        [画像ファイル用]
- |    ├── js/
+ |    ├── js/         [JavaScriptファイル用]
- |    ├── var/
+ |    ├── var/        [ライブラリリソース用(実行時に配置)]
- |    ├── resources/
+ |    ├── resources/  [ライブラリリソース用(配布時に配置)]
- |    ├── .htaccess
+ |    ├── .htaccess   [Apacheの設定]
- |    └── index.php
+ |    └── index.php   [フロントコントローラ]
- |
+</code>
- ├── test [テスト用]
- |
- ├── var  [データファイル]
- |    |
- |    ├── cache [キャッシュ]
- |    ├── db    [DBファイル(sqlite)]
- |    └── logs  [ログ]
- |
- └── vendor [外部ライブラリ]
+Apricot自身のフロントエンドアセットは css, img と js ディレクトリーに配置し、外部ライブラリーのアセットは　var または resources ディレクトリーに配置します。実行時にアセットを作成する場合は var に、配布ファイルとしてアセットを含める場合は、resources を使用します。
+\\
+==== .htcccess ====
+Apricotに含まれている ''.htcccess'' を以下に示します。このファイルの目的は、アプリケーションへの全てのリクエストをフロントコントローラ ''index.php'' で受け取るようにするためです。フロントコントローラはこのリクエストをリクエストルーターへ送り、適切なアクションで処理を行います。
+{{fa>folder-open-o}} ** your-project/public **
+<code - .htaccess>
+<IfModule mod_rewrite.c>
+    RewriteEngine On
+    RewriteCond %{REQUEST_FILENAME} !-f
+    RewriteCond %{REQUEST_FILENAME} !-d
+    RewriteRule ^ index.php [L]
+</IfModule>
 </code>
-=== appフォルダ===
+この設定では、ApacheのRewriteEngineを有効にして、publicフォルダ下に実在しないファイル及びフォルダに対する全てのリクエストをindex.phpに転送します。詳しくはApacheの[[https://httpd.apache.org/docs/2.4/ja/mod/mod_rewrite.html|マニュアル]]を参照して下さい。
-アプリケーションの本体を保存するフォルダーで以下のクラスが存在します。
-  * 【 基盤 】コントローラ、モデル、エラーバッグなどのベースクラス
+\\
-  * 【 例外 】アプリケーション例外クラスと集約例外コントローラ
-  * 【 モデル 】通常データベースのテーブル単位で作り、アプリケーションのデータモデルとなる
-  * 【 コントローラ 】通常画面単位に作り、URLと結びついたアクション(メソッド)から構成されている
-  * 【 ミドルウェア 】アクション起動時の前処理(まはた後処理)を行うクラス
-  * 【 ヘルパー 】ビューヘルパーなどの共通のユーティリティクラス
-  * 【 サービス 】特定のサービスクラス(オプション)
-  * 【 コンテナ― 】サービスプロバイダーとサービスコンテナ―(オプション)
-=== assetsフォルダ ===
+===== アプリケーションの配置 =====
-アプリケーションのリソースを保存します。
-  *【 ビューテンプレート 】画面を作成するHTMLテンプレート([[basic-library:bladeone:3.37|BladeOne]]で使用)
+フロントコントローラ ''index.php'' は、以下に示すように、起動後直ぐに公開ディレクトリーとプロジェクトディレクトリーを取得してアプリケーションを初期化します。
-  *【 言語別のテキスト 】トランスレーションの為の言語別のテキスト
-  *【 SQLファイル 】データベース構築の為のSQL
-=== configフォルダ ===
+{{fa>folder-open-o}} ** your-project/public **
-アプリケーションの設定を保存します。
+<code php index.php>
+<?php
+//-------------------------------------------------------------------
+// Autoloader registration
+//-------------------------------------------------------------------
+require dirname(__DIR__).'/vendor/autoload.php';
-  *【 起動設定 】機能別のアプリケーション起動時の設定ファイル
+//-------------------------------------------------------------------
-  *【 一般設定 】機能別の一般設定ファイル
+// Sets the project and pulic path
+//-------------------------------------------------------------------
+$project_path = dirname(__DIR__);
+$public_path = __DIR__;
-=== coreフォルダ ===
+//-------------------------------------------------------------------
-Apricotのコアクラスを保存します。コアの主な目的は次の３つです。
+// Initializes the application
+//-------------------------------------------------------------------
+$application = new Apricot\Application($project_path, $public_path);
-  * アプリケーションの構成管理を提供する
+...
-  * リクエストからレスポンスまでの標準的な処理方法を提供する
+</code>
-  * ロギング、例外集約、デバックの機能を提供する
-=== publicフォルダ ===
+このように、デフォルトのindex.php の実装では、公開ディレクトリーとプロジェクトディレクトリーの関係は以下のような親子関係を想定しています。
-公開用のフォルダです。ここのはApricotのフロントコントローラ( ''index.php'' )があります。
-=== testフォルダ ===
+<code>
-テスト用のフォルダです。使い方に制限はありません。必要に応じて追加して下さい。
+your-project [プロジェクトディレクトリー]
+ |
+ ├── app
+ ├── assets
+ ├── config
+ ├── core
+ ├── var
+ ├── vendor
+ |
+ └── public [公開ディレクトリー]
+</code>
-=== varフォルダ ===
+プロジェクトディレクトリーは公開ディレクトリーからの相対パスで設定することがきでるので、例えば、以下で示すように index.php を変更すれば任意の場所にプロジェクトディレクトリーを配置することができます。
-アプリケーションの次のデータを保存するフォルダです。
-  * ログファイル
-  * キャッシュファイル
-  * データベースファイルなど
-=== vendorフォルダ ===
+=== 兄弟関係(siblings) ===
-Composerが使用する外部ライブラリーの保存フォルダです。
+<code>
+ ┌── your-project [プロジェクトディレクトリー]
+ |     |
+ |     ├── app
+ |     ├── assets
+ |     ├── config
+ |     ├── core
+ |     ├── var
+ |     └── vendor
+ |
+ ├── public [公開ディレクトリー]
+ |
+</code>
+<code php index.php>
+$project_path = dirname(__DIR__).'/your-project';
+$public_path = __DIR__;
+</code>
+=== 祖父母孫関係(Grandparent-Grandchild) ===
+<code>
+your-project [プロジェクトディレクトリー]
+ |
+ ├── app
+ ├── assets
+ ├── config
+ ├── core
+ ├── var
+ ├── vendor
+ |
+ ├── html
+ |    |
+ |    └── public [公開フォルダ]
+</code>
+<code php index.php>
+$project_path = dirname(dirname(__DIR__));
+$public_path = __DIR__;
+</code>
 \\
 ===== 環境設定 =====
+Apricotでは環境設定ライブラリーとして phpdotenv を使用しています。環境変数を設定する ''.env'' ファイルはプロジェクトフォルダ直下に配置します。環境変数の設定に関しての詳細は、[[https://github.com/vlucas/phpdotenv|phpdotenv]] を参照して下さい。
 {{fa>folder-open-o}} ** /your-project **
@@ 行 151: / 行 230: @@
 ^環境変数^設定内容^型^必須^
-|APP_NAME|アプリケーション名(半角英数字)|string|〇|
+|APP_NAME|アプリケーション名|string|〇|
-|APP_VERSION|バージョン|string|〇|
+|APP_VERSION|アプリケーションバージョン|string|〇|
 |APP_SECRET|シークレット文字列\\ 安全の為にランダムな32文字を設定して下さい|string|〇|
 |APP_DEBUG|デバッグモード|bool|〇|
@@ 行 158: / 行 237: @@
 |LOG_NAME|ログ名 (省略時はAPP_NAMEと同じ)|string| |
 |LOG_LEVEL|[[https://github.com/Seldaek/monolog/blob/master/doc/01-usage.md#log-levels|ログレベル]] (省略時はdebug)|string| |
+環境変数の取得にはヘルパー関数の ''env()'' を使用します。
+<code php>
+$app_name = env('APP_NAME');
+</code>
 \\
 ===== アプリケーション設定 =====
-app.php はライブラリとミドルウェアに関する構成とセキュリティーの定義が含まれています。
+アプリケーションの設定ファイルは、config ディレクトリの下に配置します。
+<code>
+your-project [プロジェクトディレクトリー]
+ |
+ ├── config
+ |    |
+ |    ├── setting/ ----- 機能別の設定ファイル(*.setting.php)を配置します
+ |    ├── setup/ ------- 機能別のセットアップファイル(*.setup.php)を配置します
+ |    ├── app.php ------ アプリケーション全体の設定を行います
+ |    ├── routes.php --- ルーティングの設定を行います
+</code>
+\\
+==== app.php ファイル =====
+app.php はアプリケーション全体の設定を行いますが、デフォルトでは以下のような設定が含まれています。
+{{fa>folder-open-o}} ** /your-project/config**
+<code php app.php>
+<?php
+/**
+ * This file contains application settings.
+ */
+return
+[
+    'setup' => [ /* Some settings */ ],
+    'middleware' => [ /* Some settings */ ],
+    'csrf' => [ /* Some settings */ ],
+    'auth' => [ /* Some settings */ ],
+];
+</code>
+  * ''setup'' --- 主に外部ライブラリの初期化ファイルを指定します。詳しくは [TODO] を参照して下さい。
+  * ''middleware'' --- ミドルウェアを指定します。詳しくは [TODO] を参照して下さい。
+  * ''csrf'' --- CSRFトークンの設定を行います。詳しくは [TODO] を参照して下さい。
+  * ''auth'' --- ユーザ認証(セッション認証)の設定を行います。詳しくは [TODO] を参照して下さい。
+\\
+==== routes.php ファイル ====
+Apricotではリクエストルータに [[https://github.com/nikic/FastRoute|FastRoute]] を使用しています。ルーティングの設定は、
+routes.php ファイルで行います。以下はその例です：
+{{fa>folder-open-o}} ** /your-project/config**
+<code php routes.php>
+<?php
+//-------------------------------------------------------------------
+// Route Definition Callback
+//-------------------------------------------------------------------
+return function (FastRoute\RouteCollector $r)
+{
+    $base = Core\Application::getInstance()->getRouteBase();
+    $r->addGroup($base, function (FastRoute\RouteCollector $r) use($base)
+    {
+        // Home
+        $r->get('/', function() use($base){
+            header("Location: " . $base.'/stub');
+        });
+        // Stub
+        $r->get('/stub[/{no:\d+}]', 'StubController@index');
+    });
+};
+</code>
+ルーティングは、フロントコントローラ ''index.php'' が受け取ったURLパスとアクションを対応させます。上のHomeの例は、URLパス と クロージャを対応付けています。また、Stubの例では、URLパス と 「コントローラクラス@アクションメソッド」を対応付けています。
+ルーティング設定に関する詳細は、[[https://github.com/nikic/FastRoute|FastRoute]]を参照して下さい。
+\\
+==== 設定管理 ====
+アプリケーション内の様々な設定は、ディレクトリー ''/your-project/config/setting'' 下に以下のネーミング規則で機能毎に保存されます。
+<code>
+設定ファイル名: {first_key}.setting.php
+</code>
+設定値へのアクセスには **ドット表記** による「設定キー」によって行われます。設定キーの第1キーが設定ファイル名の{first_key}と一致します。この第1キーは習慣的にライブラリー名や機能によって名前付けされます。
+以下に ロギングライブラリである [[https://github.com/Seldaek/monolog|monolog]] の例を示します。
+{{fa>folder-open-o}} ** /apricot/config/setting **
+<code php monolog.setting.php>
+<?php
+return
+[
+    'name' => env('LOG_NAME',env('APP_NAME')),
+    'path' => env('LOG_PATH',var_dir('logs')),
+    'level'=> env('LOG_LEVEL','debug'),
+    'max_files'=> 0,
+];
+</code>
+settingファイルは key => valute の形式で設定を表す連想配列を返す必要があります。
+settingファイルの設定値を取得するには「ドット表記」によって行います。例えば「ログの名前」を参照する設定キーは、''monolog.name'' です。ドット表記による階層に制限はなく、monolog.setting.php で返す連想配列の階層が深ければ ''monolog.second_key.third_key.4th_key'' などのように深い階層も可能です。
+設定の取得には Configシングルトンを使用します。
+<code php>
+/** Checks if the given key is present. */
+$present = Config::has('monolog.name');
+/** Gets the configuration value specified by the Dot-notation key. */
+$value = Config::get('monolog.name', $default);
+</code>
+また、ヘルパー関数を使って取得することも出来ます。
+<code php>
+$value = config('monolog.name', $default);
+</code>
+\\
+==== セットアップ管理 ====
+アプリケーションを構成しているライブラリーやクラスなどのセットアップファイルは、ディレクトリー ''/your-project/config/setup'' 下に以下のネーミング規則で保存されます。
+<code>
+セットアップファイル名: {setup_name}.setup.php
+</code>
+これらのセットアップファイルの構成は、アプリケーション設定ファイル app.php によって行われます。以下に実際の app.php によるセットアップの構成を示します。
 {{fa>folder-open-o}} ** /your-project/config**
@@ 行 178: / 行 394: @@
         config_dir('setup/validator.setup.php'), /* Valitron\Validator */
     ],
-    'middleware' =>[
+    ...
-        \App\Middleware\AccessLog::class,        /* Access log */
-        \App\Middleware\VerifyCsrfToken::class,  /* Verify CSRF Token */
-//      \App\Middleware\Auth\BasicAuth::class,   /* Basic authentication */
-        \App\Middleware\Auth\SessionAuth::class, /* Session authentication */
-    ],
-    'csrf' =>[
-        'disposable' => false,
-    ],
-    'auth' =>[
-        'db'=>[
-            'user'=>[
-                'account' =>'account',
-                'password' =>'password',
-                'remember' =>'remember_token',
-            ],
-        ],
-        'expires_sec'=> 2*7*24*3600, /* 2weekws */
-        'menu'=> true,
-    ],
 ];
 </code>
-  * setup --- ライブラリの初期化ファイルの所在(フルパス)
+Apricotのアプリケーションインスタンスは、起動時にセットアップ構成で定義されて順序でに従ってsetupファイルを実行します。ここで使用されている ''config_dir()'' は configディレクトリ内からファイルパスを取得するヘルパー関数です。
-  * middleware --- ミドルウェアの完全修飾クラス名
-  * auth --- ユーザ認証(セッション認証)の設定
-  * csrf --- CSRFトークンの設定
 \\
-===== パッケージ設定 =====
->TODO
-\\
-===== ルーティング =====
->TODO
-\\

Ground Sunlight

ユーザ用ツール

サイト用ツール

差分

ページ用ツール