Ground Sunlight

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

ユーザ用ツール

サイト用ツール

トレース:
apricot:usage:ja:config

差分

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

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

両方とも前のリビジョン 前のリビジョン
次のリビジョン 		前のリビジョン
次のリビジョン 両方とも次のリビジョン
apricot:usage:ja:config [2020/08/03 12:06]
y2sunlight 		apricot:usage:ja:config [2020/08/13 08:25]
y2sunlight
行 1: 行 1:
-> 編集中 
- 
----- 
- 
 ====== Apricot 配置と構成 ====== ====== Apricot 配置と構成 ======
  --- //[[http://www.y2sunlight.com|y2sunlight]] 2020-07-29//  --- //[[http://www.y2sunlight.com|y2sunlight]] 2020-07-29//
  
-[[apricot:usage:ja|Apricotの使用法 に戻る]]+[[apricot:usage:ja|Apricot ドキュメント に戻る]]
  
 目次 目次
  
 +  * [[apricot:usage:ja:features|Apricot 特徴と概要]]
   * Apricot 配置と構成   * Apricot 配置と構成
 +  * [[apricot:usage:ja:errors-logging|Apricot ログとエラー処理]]
   * [[apricot:usage:ja:http|Apricot リクエストとレスポンス]]   * [[apricot:usage:ja:http|Apricot リクエストとレスポンス]]
   * [[apricot:usage:ja:frontend|Apricot フロントエンド]]   * [[apricot:usage:ja:frontend|Apricot フロントエンド]]
行 16: 行 14:
   * [[apricot:usage:ja:middleware|Apricot ミドルウェア]]   * [[apricot:usage:ja:middleware|Apricot ミドルウェア]]
   * [[apricot:usage:ja:controller|Apricot コントローラ]]   * [[apricot:usage:ja:controller|Apricot コントローラ]]
-  * [[apricot:usage:ja:errors-logging|Apricot ログとエラー処理]] 
   * [[apricot:usage:ja:utility|Apricot ユーティリティ]]   * [[apricot:usage:ja:utility|Apricot ユーティリティ]]
  
行 22: 行 19:
  
 ===== ディレクトリー構成 ===== ===== ディレクトリー構成 =====
- 
-==== プロジェクトディレクトリー ==== 
  
 以下にプロジェクトディレクトリーの構成を示します。 以下にプロジェクトディレクトリーの構成を示します。
行 38: 行 33:
  ├── var  ├── var
  └── vendor  └── vendor
- 
 </code> </code>
  
-=== appフディレクトリー=== +=== appディレクトリー=== 
-アプリケーションの本体を保存するディレクトリーで以下のクラスが存在します。+アプリケーションの本体を配置するディレクトリーで以下サブディレクトリーがあります。
  
-  * [ Foundation ] コントローラ、モデル、エラーバッグなどのベースクラスを配置します。 +  * ''Foundation'' --- コントローラ、モデル、エラーバッグなどのベースクラス 
-  * [ Exceptions ] アプリケーション例外クラスと集約例外コントローラを配置します。 +  * ''Exceptions'' --- アプリケーション例外クラスと集約例外コントローラ 
-  * [ Models ] 通常データベースのテーブル単位で作り、アプリケーションのデータモデルを配置します。 +  * ''Models'' --- 通常データベースのテーブル単位で作り、アプリケーションのデータモデル 
-  * [ Controllers ] 通常画面単位に作り、URLと結びついたアクション(メソッド)からを配置します。 +  * ''Controllers'' --- 通常画面単位に作り、URLと結びついたアクション(メソッド)から 
-  * [ Middleware ] アクション起動時の前処理(まはた後処理)を行うミドルウェアを配置します。 +  * ''Middleware'' --- アクション起動時の前処理(まはた後処理)を行うミドルウェア 
-  * [ Helpers ] ビューヘルパーなどの共通のユーティリティクラスを配置します。+  * ''Helpers'' --- ビューヘルパーなどの共通のユーティリティクラス
  
 === assetsディレクトリー === === assetsディレクトリー ===
-アプリケーションのリソースを配置します。+アプリケーションのリソースを配置し以下サブディレクトリーがあります。
  
-  * [ views ] 画面を作成するHTMLテンプレート([[basic-library:bladeone:3.37|BladeOne]]で使用) +  * ''views'' --- 画面を作成するHTMLテンプレート(BladeOneで使用) 
-  * [ lang ] トランスレーションの為の言語別のテキスト +  * ''lang'' --- トランスレーションの為の言語別のテキスト 
-  * [ sql ] データベース構築の為のSQL+  * ''sql'' --- データベース構築の為のSQLファイル
  
 === configディレクトリー === === configディレクトリー ===
-アプリケーションの設定を配置します。+アプリケーションの設定を配置し以下サブディレクトリーがあります。
  
-  * [ setup ] 機能別のアプリケーション起動時の設定ファイル +  * ''setup'' --- アプリケーション起動時のセットアップファイル 
-  * [ setting ] 機能別の一般設定ファイル+  * ''setting'' --- 機能別の設定ファイル
  
 === coreディレクトリー === === coreディレクトリー ===
行 75: 行 69:
  
 === varディレクトリー === === varディレクトリー ===
-アプリケーションの次のデータを保存するディレクトリーです。+アプリケーションの次のデータを保存するディレクトリーで以下サブディレクトリーがあります。
  
-  * [ logs ] ログファイル +  * ''logs'' --- ログファイル 
-  * [ cache ] キャッシュファイル +  * ''cache'' --- キャッシュファイル 
-  * [ db ] データベースファイルなど+  * ''db'' --- データベースファイルなど
  
 === vendorディレクトリー === === vendorディレクトリー ===
行 88: 行 82:
 ===== public ディレクトリー ===== ===== public ディレクトリー =====
  
 +''public'' ディレクトリーの下には以下に示すようなディレクトリーとファイルが存在します。
 +
 +<code>
 +your-project [プロジェクトディレクトリー]
 + |
 + ├── public [公開フォルダ]
 + |    |
 + |    ├── css/        [cssファイル用]
 + |    ├── img/        [画像ファイル用]
 + |    ├── js/         [JavaScriptファイル用]
 + |    ├── var/        [ライブラリリソース用(実行時に配置)]
 + |    ├── resources/  [ライブラリリソース用(配布時に配置)]
 + |    ├── .htaccess   [Apacheの設定]
 + |    └── index.php   [フロントコントローラ]
 +</code>
 +
 +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> 
 + 
 +この設定では、ApacheのRewriteEngineを有効にして、publicフォルダ下に実在しないファイル及びフォルダに対する全てのリクエストをindex.phpに転送します。詳しくはApacheの[[https://httpd.apache.org/docs/2.4/ja/mod/mod_rewrite.html|マニュアル]]を参照して下さい。 
 + 
 +\\ 
 + 
 +===== アプリケーションの配置 ===== 
 + 
 +フロントコントローラ ''index.php'' は、以下に示すように、起動後直ぐに公開ディレクトリーとプロジェクトディレクトリーを取得してアプリケーションを初期化します。 
 + 
 +{{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__; 
 + 
 +//------------------------------------------------------------------- 
 +// Initializes the application 
 +//------------------------------------------------------------------- 
 +$application = new Apricot\Application($project_path, $public_path); 
 + 
 +... 
 +</code> 
 + 
 +このように、デフォルトのindex.php の実装では、公開ディレクトリーとプロジェクトディレクトリーの関係は以下のような親子関係を想定しています。 
 + 
 +<code> 
 +your-project [プロジェクトディレクトリー] 
 + | 
 + ├── app 
 + ├── assets 
 + ├── config 
 + ├── core 
 + ├── var 
 + ├── vendor 
 + | 
 + └── public [公開ディレクトリー] 
 +</code> 
 + 
 +プロジェクトディレクトリーは公開ディレクトリーからの相対パスで設定することがきでるので、例えば、以下で示すように index.php を変更すれば任意の場所にプロジェクトディレクトリーを配置することができます。 
 + 
 + 
 +=== 兄弟関係(siblings) === 
 + 
 +<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 ** {{fa>folder-open-o}} ** /your-project **
行 114: 行 230:
  
 ^環境変数^設定内容^型^必須^ ^環境変数^設定内容^型^必須^
-|APP_NAME|アプリケーション名(半角英数字)|string|〇| +|APP_NAME|アプリケーション名|string|〇| 
-|APP_VERSION|バージョン|string|〇|+|APP_VERSION|アプリケーションバージョン|string|〇|
 |APP_SECRET|シークレット文字列\\ 安全の為にランダムな32文字を設定して下さい|string|〇| |APP_SECRET|シークレット文字列\\ 安全の為にランダムな32文字を設定して下さい|string|〇|
 |APP_DEBUG|デバッグモード|bool|〇| |APP_DEBUG|デバッグモード|bool|〇|
行 121: 行 237:
 |LOG_NAME|ログ名 (省略時はAPP_NAMEと同じ)|string| | |LOG_NAME|ログ名 (省略時はAPP_NAMEと同じ)|string| |
 |LOG_LEVEL|[[https://github.com/Seldaek/monolog/blob/master/doc/01-usage.md#log-levels|ログレベル]] (省略時はdebug)|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** {{fa>folder-open-o}} ** /your-project/config**
行 141: 行 394:
         config_dir('setup/validator.setup.php'), /* Valitron\Validator */         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> </code>
  
-  * setup --- ライブラリの初期化ファイルの所在(フルパス) +Apricotのアプリケーションインスタンスは、起動時にセットアップ構成で定義されて順序でに従ってsetupファイルを実行します。ここで使用されている ''config_dir()'' は configディレクトリ内からファイルパスを取得するボイラープレートです。
-  * middleware --- ミドルウェアの完全修飾クラス名 +
-  * auth --- ユーザ認証(セッション認証)の設定 +
-  * csrf --- CSRFトークンの設定 +
  
 \\ \\
  
-===== パッケージ設定 ===== 
->TODO 
  
-\\ 
- 
-===== ルーティング ===== 
->TODO 
- 
-\\ 
  
apricot/usage/ja/config.txt · 最終更新: 2020/09/03 13:44 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