docs(middleware): add description of import koa middleware (eggjs#1805)

iHaust · Dec 11, 2017 · 4c9eacb · 4c9eacb
1 parent c152dee
commit 4c9eacb
Show file tree

Hide file tree

Showing 2 changed files with 38 additions and 0 deletions.
diff --git a/docs/source/en/basics/middleware.md b/docs/source/en/basics/middleware.md
@@ -176,6 +176,25 @@ module.exports = {
 };
 ```
 
+If the third-party Koa middleware do not follow the rule, then you can wrap it youself:
+
+```js
+// config/config.default.js
+module.exports = {
+  webpack: {
+    compiler: {},
+    others: {},
+  },
+};
+
+// app/middleware/webpack.js
+const webpackMiddleware = require('some-koa-middleware');
+
+module.exports = (options, app) => {
+  return webpackMiddleware(options.compiler, options.others);
+}
+```
+
 ## General Configuration
 
 These general config fields are supported by middleware loaded by the application layer or built in by the framework:

diff --git a/docs/source/zh-cn/basics/middleware.md b/docs/source/zh-cn/basics/middleware.md
@@ -176,6 +176,25 @@ module.exports = {
 };
 ```
 
+如果使用到的 Koa 中间件不符合入参规范，则可以自行处理下：
+
+```js
+// config/config.default.js
+module.exports = {
+  webpack: {
+    compiler: {},
+    others: {},
+  },
+};
+
+// app/middleware/webpack.js
+const webpackMiddleware = require('some-koa-middleware');
+
+module.exports = (options, app) => {
+  return webpackMiddleware(options.compiler, options.others);
+}
+```
+
 ## 通用配置
 
 无论是应用层加载的中间件还是框架自带中间件，都支持几个通用的配置项：