ホームページ  >  記事  >  ウェブフロントエンド  >  ThinkJS 開発構成サンプルのチュートリアル

ThinkJS 開発構成サンプルのチュートリアル

零下一度
零下一度オリジナル
2017-07-26 18:02:582013ブラウズ

設定ファイルはモジュールによって定義されます

thinkjs を使用すると、開発者は src/common/config/ で直接独自のパラメータを設定し、js ファイルを直接追加できます。ファイル名は json 属性名の要件を満たす必要があるだけです。 . 、ファイルの内容は次の形式に従います: src/common/config/ 下面配置自己的参数,直接增加 js 文件即可,文件名只要符合 json 属性名要求即可,文件内容遵照如下格式:

// 新增文件 assets.js 键入如下内容'use strict';export default {
  // key: value};

文件内容只要符合一个 json 对象格式的定义即可。来看一个 log4js 的配置定义:

// log4js.js'use strict';export default {
  appenders: [{  type    : "console",  category: "console"},// 定义一个日志记录器{  type                : "dateFile",                 // 日志文件类型,可以使用日期作为文件名的占位符  filename            : "logs/",     // 日志文件名,可以设置相对路径或绝对路径  pattern             : "debug/yyyyMMddhh.txt",  // 占位符,紧跟在filename后面  absolute            : true,                   // filename是否绝对路径  alwaysIncludePattern: true,       // 文件名是否始终包含占位符  category            : "logInfo"               // 记录器名}
  ],
  levels   : {logInfo: "DEBUG"
  }        // 设置记录器的默认显示级别,低于这个级别的日志,不会输出}

配置文件属于静态设置,一般存放不经常变动的设置参数(当然可以在内存中更改配置参数的值,下面会详细说明)。

另外配置文件是以 ES6 格式导出变量定义的 js 文件,而非 json 文件,这里有个好处就是可以增加以 // 开头的注释说明。

细心的你肯定也发现了:除了 src/common/config 以外,src/home/ 模块下面也有个 config 文件夹。

一般来说按照配置文件的作用范围来定义和安排,是比较合理的做法。

比如:所有模块都会用到的配置放在 src/common/config 下面比较合适,而仅用于 home 模块的配置,放在 src/home/config 下面比较合适。

当配置文件多了之后,我们需要关注一下多个配置文件的加载顺序。

配置文件加载顺序

官网是这么描述配置文件加载顺序的:

框架默认的配置 -> 项目模式下框架配置 -> 项目公共配置 -> 项目模式下的公共配置 -> 模块下的配置

先问个问题:这五个配置都指的是哪里呢?

前两个可以忽略掉,那是 thinkjs 框架自身的配置设置,通常里面不会有我们项目会用到的配置参数。

第三个和第四个则是在不同的项目创建模式(项目创建模式参见 Node.js 国产 MVC 框架 ThinkJS 开发 入门(荆秀网))下的默认 config 配置文件夹,位置在:

# normal modethinkjs_normal/src/config/*# module modethinkjs_module/src/common/config/*

最后一个是指的在 module mode 下的项目,每个 module 自己的 config,位置在:

thinkjs_module/src/home/config/*

需要注意的是:多个配置文件最终会在 thinkjs 运行时被全部加载,并合并在一起(注意加粗文字)。

所以当存在多个配置文件时,需要注意配置参数的 key(即属性名)尽量不要重复,因为按照加载顺序,后加载的 key 的值会覆盖先加载的 key 的值,导致出现不希望的结果。

提示:教程主要讲解处于模块模式(moudule mode)下的开发方式。

自动切换配置文件

前面讲到我们可以在 src/common/config 下面放置配置文件,可以是全部配置参数都放在一个文件中,也可以分散在多个文件中。

有个常见的场景相信每个开发人员都会遇到:

有些配置参数是本地开发时才会用到,有些则是线上运行时才会用到。当开发完成在做持续集成时,配置参数上传时却发现开发参数和线上参数混合在一起。。。

thinkjs 在 src/common/config/env/ 下提供了三种配置参数环境,分别是 开发配置 development、生产配置 production、测试配置 testing,可以拯救我们的持续集成。

我们可以把项目配置分成三份一样属性名的参数,分别放在不同的配置环境中,这样在本地开发是 thinkjs 自动加载开发配置,持续集成后线上加载的是生产配置,是不是很方便~

开发配置

开发配置文件是:src/common/config/env/development.js

如前所述,开发配置适用于本地开发使用,那么 thinkjs 是怎么知道现在是哪个环境呢?

答案是:已经在 package.json 里面定义好了

{
  "scripts": {"start": "node www/development.js?1.1.11","compile": "babel src/ --out-dir app/","watch-compile": "node -e \"console.log(&#39;<npm run watch-compile> no longer need, use <npm start> command direct.&#39;);console.log();\"","watch": "npm run watch-compile"
  }}

可以看到 scripts.start 属性定义了我们直接使用 npm start 时具体执行的实际上是 node www/development.js

var thinkjs = require(&#39;thinkjs&#39;);var path = require(&#39;path&#39;);var rootPath = path.dirname(__dirname);var instance = new thinkjs({
  APP_PATH: rootPath + path.sep + &#39;app&#39;,
  RUNTIME_PATH: rootPath + path.sep + &#39;runtime&#39;,
  ROOT_PATH: rootPath,
  RESOURCE_PATH: __dirname,
  env: &#39;development&#39;  // <-- 这里定义了当前的 thinkjs 实例的运行环境});// Build code from src to app directory.instance.compile({
  log: true});instance.run();

ファイルの内容は、json オブジェクト形式の定義に準拠する必要があるだけです。 log4js 構成定義を見てみましょう:
src/common/config/├── config.js  # 可以放置自己的配置├── db.js  # 数据库连接├── env  # 运行时配置,下面会详述│   ├── development.js│   ├── production.js│   └── testing.js├── error.js  # 错误配置├── hook.js  # 钩子配置├── locale  # 多语言版配置│   └── en.js├── session.js└── view.js  # 视图文件配置
🎜🎜 構成ファイルは静的な設定であり、通常は頻繁に変更されない設定パラメーターを保存します (もちろん、で説明するように、構成パラメーターの値はメモリ内で変更できます)詳細は以下にあります)。 🎜🎜さらに、設定ファイルは、json ファイルではなく、ES6 形式で変数定義をエクスポートする js ファイルであるため、// で始まるコメントを追加できることが利点です。 🎜🎜注意していれば、src/common/config に加えて、src/home/ の下に <code>config フォルダーもあることに気づいたはずです。 モジュール。 🎜🎜 一般的には、設定ファイルのスコープに従って定義し、配置する方が合理的です。 🎜🎜例: すべてのモジュールで使用される設定を src/common/config に配置し、ホーム モジュールのみに使用される設定を src/home に配置する方が適切です。 /config code> 以下の方が適切です。 🎜🎜設定ファイルが多すぎる場合は、複数の設定ファイルの読み込み順序に注意する必要があります。 🎜🎜設定ファイルの読み込み順序🎜🎜 公式 Web サイトでは、設定ファイルの読み込み順序が次のように説明されています。 🎜
🎜プロジェクト モードのフレームワーク設定->プロジェクト パブリック設定->パブリック設定 -> モジュール内の設定🎜
🎜 まず質問させてください: これら 5 つの設定はどこを参照していますか? 🎜🎜最初の 2 つは無視できます。これらは thinkjs フレームワーク自体の構成設定であり、通常、プロジェクトが使用する構成パラメーターはありません。 🎜🎜 3 番目と 4 番目は、さまざまなプロジェクト作成モードでのデフォルトの構成構成フォルダーです (プロジェクト作成モードについては、Node.js 国内 MVC フレームワーク ThinkJS 開発入門 (Jingxiu.com) を参照してください)。場所は次のとおりです: 🎜🎜
// development.js&#39;use strict&#39;;export default {
  site_name: "",
  site_title: "",
  site_keywords: "",
  site_description: "",
  db: {  // 这里的配置替代 db.jstype   : &#39;mysql&#39;,log_sql: true, //是否记录 sql 语句adapter: {  mysql: {host    : &#39;127.0.0.1&#39;,port    : &#39;3306&#39;,database: &#39;&#39;,user    : &#39;&#39;,password: &#39;&#39;,prefix  : &#39;thinkjs_&#39;,encoding: &#39;utf8&#39;  }}
  },
  jwt: { // 第三方模块的公共定义options: {  algorithm: &#39;HS128&#39;,  expiresIn: &#39;7d&#39;}
  },
  pay: {// 定义与在线支付接口相关的参数
  },
  backend: {// 定义管理后台相关的参数
  },
  home: {// 定义前端网站相关的参数
  },
  rest: {// 定义 REST API 相关的参数
  },
  task: {// 定义 crond 相关的参数
  }};
🎜🎜最後のものは、モジュール モードのプロジェクトを参照します。各モジュールには独自の構成があり、場所は次のとおりです: 🎜🎜
// 配置 development.jslet dbOpt = this.config(&#39;db&#39;);let jwtOpt = this.config(&#39;jwt.options&#39;);
🎜🎜 thinkjs の実行中に複数の構成ファイルが最終的に読み込まれ、 一緒にマージされることに注意してください。 (太字のテキストに注意してください)。 🎜🎜そのため、複数の設定ファイルがある場合は、 読み込み順序に従って、後でロードされたキーによって、最初にロードされたキーの値が上書きされ、望ましくない結果が生じます。 🎜🎜ヒント: このチュートリアルでは主にモジュール モードでの開発方法について説明します。 🎜🎜設定ファイルを自動的に切り替える🎜🎜 前述したように、すべての設定パラメータは src/common/config の下に配置することも、分散させることもできます。複数のファイルに。 🎜🎜すべての開発者が遭遇すると思われる一般的なシナリオがあります: 🎜🎜一部の構成パラメーターはローカル開発にのみ使用され、一部はオンライン操作にのみ使用されます。開発が完了し、継続的インテグレーションを行っていたところ、設定パラメータをアップロードしたところ、開発パラメータとオンラインパラメータが混在していることが判明しました。 。 。 🎜🎜thinkjs は、src/common/config/env/ の下に 3 つの構成パラメーター環境を提供します。つまり、開発構成 development と運用構成 production、テスト構成です。 test により、継続的インテグレーションを節約できます。 🎜🎜プロジェクト構成を同じ属性名を持つ 3 つのパラメーターに分割し、それらを異なる構成環境に配置することができます。こうすることで、thinkjs は、継続的統合後に開発構成をオンラインでロードします。とても便利ですね~🎜

開発設定

🎜 開発設定ファイルは: src/common/config/env/development.js です🎜🎜 上で述べたように、開発構成はローカル開発での使用に適していますが、thinkjs はどのようにして現在の環境を知るのでしょうか? 🎜🎜答えは次のとおりです: package.json で定義されています🎜🎜
// 配置 development.jslet jwtOpt = this.config(&#39;jwt.options&#39;);console.log(jwtOpt);// 读取成功,打印:// {//   options: {//     algorithm: &#39;HS128&#39;,//     expiresIn: &#39;7d&#39;//   }// }let jwtOptAlg = this.config(&#39;jwt.options.algorithm&#39;);console.log(jwtOptAlg);// 超过三层,读取失败,只能读取到两层内容,打印:// {//   options: {//     algorithm: &#39;HS128&#39;,//     expiresIn: &#39;7d&#39;//   }// }jwtOptAlg = jwtOpt[&#39;algorithm&#39;];console.log(jwtOptAlg);// 正确的读取方式,打印:// HS128
🎜🎜 npm start を直接使用する場合、<code>scripts.start 属性が特定の実行を定義していることがわかります。 code> これは実際には node www/development.js コマンドです。 🎜🎜回答を求めるという原則に従って、このファイルの内容を見てみましょう: 🎜🎜
// 配置文件:src/home/config/assets.jslet siteName = think.config(&#39;assets.site_name&#39;, undefined, &#39;home&#39;);
🎜

:-)

生产配置

生产配置文件是:src/common/config/env/production.js

明白了开发配置的原理,也就不难明白生产配置了。

使用 node www/production.js 命令可以告诉 thinkjs 现在运行的是生产环境。

同理,生产配置中的参数名(属性名)一般与开发配置一样,只是值不同而已。

比较常见的是数据库连接,本地开发时连接的是测试库,而生产环境中连接的是生产库,不同的地址、用户、密码和库名,这些都是要交给运维人员来管理了。

测试配置

测试配置文件是:src/common/config/env/testing.js

明白了前两个配置,这个也不难明白~

使用 node www/testing.js 命令可以告诉 thinkjs 现在运行的是测试环境。

定义和使用配置文件

前面其实有介绍过配置文件的分布原则和定义方法,只要确保不与系统特定配置冲突即可自由定义。

系统特定配置

下面是 thinkjs 默认的配置文件清单,这些系统特定配置都是有相应的使用场景和参数设置,详细说明及完整参数详见:

src/common/config/├── config.js  # 可以放置自己的配置├── db.js  # 数据库连接├── env  # 运行时配置,下面会详述│   ├── development.js│   ├── production.js│   └── testing.js├── error.js  # 错误配置├── hook.js  # 钩子配置├── locale  # 多语言版配置│   └── en.js├── session.js└── view.js  # 视图文件配置

自定义配置

一般做法是使用带有层级的配置定义来组织配置参数(当然你一定要把全部参数都放在根下面也不是不可以),参见如下配置:

// development.js&#39;use strict&#39;;export default {
  site_name: "",
  site_title: "",
  site_keywords: "",
  site_description: "",
  db: {  // 这里的配置替代 db.jstype   : &#39;mysql&#39;,log_sql: true, //是否记录 sql 语句adapter: {  mysql: {host    : &#39;127.0.0.1&#39;,port    : &#39;3306&#39;,database: &#39;&#39;,user    : &#39;&#39;,password: &#39;&#39;,prefix  : &#39;thinkjs_&#39;,encoding: &#39;utf8&#39;  }}
  },
  jwt: { // 第三方模块的公共定义options: {  algorithm: &#39;HS128&#39;,  expiresIn: &#39;7d&#39;}
  },
  pay: {// 定义与在线支付接口相关的参数
  },
  backend: {// 定义管理后台相关的参数
  },
  home: {// 定义前端网站相关的参数
  },
  rest: {// 定义 REST API 相关的参数
  },
  task: {// 定义 crond 相关的参数
  }};

配置参数按照层次组织之后,需要注意的一点是:获取配置的时候,不能无限制的 this.config(参数.参数.参数.参数) 下去,详见下面读取配置的几种方式描述。

几种读取配置的方式

配置文件定义之后,需要在项目运行的特别业务中读取(也可以设置)到配置参数的值,根据读取配置的位置的不同,thinkjs 提供了以下几种读取方式。

this.config()

这是使用率最高的读取配置方法,绝大多数位置都可以使用此方法来读取配置,比如 controller logic model service middleware 等地方。

// 配置 development.jslet dbOpt = this.config(&#39;db&#39;);let jwtOpt = this.config(&#39;jwt.options&#39;);

这里有一点需要注意:thinkjs 只能解析两层配置参数,超过的层级不予解析(源码中写死了仅返回两层)。

// 配置 development.jslet jwtOpt = this.config(&#39;jwt.options&#39;);console.log(jwtOpt);// 读取成功,打印:// {//   options: {//     algorithm: &#39;HS128&#39;,//     expiresIn: &#39;7d&#39;//   }// }let jwtOptAlg = this.config(&#39;jwt.options.algorithm&#39;);console.log(jwtOptAlg);// 超过三层,读取失败,只能读取到两层内容,打印:// {//   options: {//     algorithm: &#39;HS128&#39;,//     expiresIn: &#39;7d&#39;//   }// }jwtOptAlg = jwtOpt[&#39;algorithm&#39;];console.log(jwtOptAlg);// 正确的读取方式,打印:// HS128

think.config()

think.config 方法可以:

  • 无须考虑当前位置来读取配置参数(其内部运行方式类似 this.config )

  • 跨模块读取配置参数

对于前者可以无须思考当前所在的模块,更自由的读取配置参数。

对于后者则对开发多模块协作有着比较重要的意义,配置参数只有一份,不可能向不同的模块复制相同的配置,因此需要“一处配置、多处可用”。因此无须考虑“我在哪里读取配置”,只要考虑“我要读取哪里的配置”即可。

// 配置文件:src/home/config/assets.jslet siteName = think.config(&#39;assets.site_name&#39;, undefined, &#39;home&#39;);

方法的第二个参数设置为 undefined 是为了避免将读取动作变为设置动作。

方法的第三个参数标明了这个配置参数在哪个模块下面,一旦给定此参数,thinkjs 会认为 src/home/config/ 下面的配置是你需要读取的目标。

http.config()

http.config 方法实质上是 think.config() 的一个别名,可以读取和设置配置参数。

避免踩坑之正确读取参数

如果不能理解 thinkjs 设计配置文件读取策略的情况下,会无意中踩坑,如下便是一个例子,代码说话。

假设有两个配置文件 src/common/config/assets.jssrc/home/config/assets.js,其中有着一样的属性名:

// src/common/config/assets.jsexport default {
  "site_title": "my site"};// src/home/config/assets.jsexport default {
  "site_title": "my test"};// 两个配置参数属性名一样的情况下// 使用不同的读取方式// 注意 config 方法的上下文对象的不同// 会导致读取的结果的不同// src/home/controller/index.jslet assets = this.config(&#39;assets&#39;);let siteTitle = assets[&#39;site_title&#39;];console.log(&#39;siteTitle is: &#39;, siteTitle);// 打印:// my test// src/home/controller/index.jslet assets = think.config(&#39;assets&#39;, undefined, &#39;common&#39;);let siteTitle = assets[&#39;site_title&#39;];console.log(&#39;siteTitle is: &#39;, siteTitle);// 打印:// my site

明白了 thinkjs 配置文件加载顺序,就不会对上面发生的情况惊讶了~

如果你实在懒得去思考 this.configthink.config 两者的分别,建议你干脆使用后者,当读取参数只传入第一个参数时,它的表现与前者一致。这样貌似更有利于代码的维护~

避免踩坑之动态修改配置参数

当读取到了配置参数后,当然是可以动态修改其为新的值,以让后续的处理都读到新的值。动态修改方法也很简单:config 方法的第二个参数就是给定的新值。

let siteTitle = this.config(&#39;assets.site_title&#39;);console.log(siteTitle);// 打印:// my testthis.config(&#39;assets.site_title&#39;, &#39;test 123&#39;);siteTitle = this.config(&#39;assets.site_title&#39;);console.log(siteTitle);// 打印:// test 123

上面的动态修改方法其实平淡无奇,来看看更有趣的修改方法,如下:

let siteAuthor = this.config(&#39;assets.site_author&#39;);console.log(siteAuthor);// 打印:// {//   name: &#39;xxuyou.com&#39;,//   email: &#39;cap@xxuyou.com&#39;// }siteAuthor[&#39;name&#39;] = &#39;cap&#39;;siteAuthor = this.config(&#39;assets.site_author&#39;);console.log(siteAuthor);// 打印:// {//   name: &#39;cap&#39;,//   email: &#39;cap@xxuyou.com&#39;// }

假如上面的代码片段修改一下写法,就可以得到预期的效果,如下:

let siteAuthor = think.extend({}, this.config(&#39;assets.site_author&#39;)); // <-- 不同点在这里console.log(siteAuthor);// 打印:// {//   name: &#39;xxuyou.com&#39;,//   email: &#39;cap@xxuyou.com&#39;// }siteAuthor[&#39;name&#39;] = &#39;cap&#39;;siteAuthor = this.config(&#39;assets.site_author&#39;);console.log(siteAuthor);// 打印:// {//   name: &#39;xxuyou.com&#39;,//   email: &#39;cap@xxuyou.com&#39;// }

当面は、この think.extend が誰であるかに関係なく、等号の左側にある変数を変更すると、構成メソッドを直接変更するのと同じ効果が得られるのはなぜですか? think.extend 是何方神圣,为啥修改等号左边的变量的效果跟直接修改配置方法是一样的?

原因其实很简单:

  1. thinkjs 内部会缓存配置参数。

  2. 配置参数的值是一个 Object 而不是 String

OK~

语言包

语言包其实本身可以作为 i18n 来单独描述,不过由于国际化在实际开发甚至架构过程中极少涉及到,因此这里简略描述。

src/config/locale/en.js

系统默认的英语语言环境,其中定义了相关的语言模版。

src/config/locale/zh-CN.js

规范起见,建议手工设立这个语言模版文件,并修改 src/common/config/local.js 中的 default 参数为 zh-CN

その理由は実際には非常に簡単です: 🎜
  1. 🎜thinkjs は構成パラメーターを内部的にキャッシュします。 🎜
  2. 🎜設定パラメータの値は、String ではなく Object です。 🎜
🎜OK~🎜

言語パック

🎜 言語パック自体は実際には i18n として個別に記述することができますが、国際化が実際の開発やアーキテクチャ プロセスに関与することはほとんどないため、したがって、ここでは簡単に説明します。 🎜

src/config/locale/en.js

🎜 システムのデフォルトの英語環境。関連する言語テンプレートを定義します。 🎜

src/config/locale/zh-CN.js

🎜 標準化のために、この言語テンプレート ファイルを手動で設定し、src/common/config/local を変更することをお勧めします。 js この言語テンプレートを有効にするための default パラメータは zh-CN です。 🎜

以上がThinkJS 開発構成サンプルのチュートリアルの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。

声明:
この記事の内容はネチズンが自主的に寄稿したものであり、著作権は原著者に帰属します。このサイトは、それに相当する法的責任を負いません。盗作または侵害の疑いのあるコンテンツを見つけた場合は、admin@php.cn までご連絡ください。