Update: pr#1533 pr#1566 pr#1574 pr#1577 pr#1589

docs/Server.md

@@ -39,12 +39,12 @@ const fastify = require('fastify')({
 
 // 同时注册 "/foo" 与 "/foo/"
 fastify.get('/foo/', function (req, reply) {
-  res.send('foo')
+  reply.send('foo')
 })
 
 // 同时注册 "/bar" 与 "/bar/"
 fastify.get('/bar', function (req, reply) {
-  res.send('bar')
+  reply.send('bar')
 })
 ```
 
@@ -94,6 +94,26 @@ Fastify 依托 [Pino](https://getpino.io/) 内建了一个日志工具。该属
         })
         ```
       用户提供的序列化函数将会覆盖对应属性默认的序列化函数。
++ `loggerInstance`：自定义日志工具实例。日志工具必须实现 Pino 的接口，即拥有如下方法：`info`, `error`, `debug`, `fatal`, `warn`, `trace`, `child`。例如：
+```js
+const pino = require('pino')();
+
+const customLogger = {
+  info: function (o, ...n) {},
+  warn: function (o, ...n) {},
+  error: function (o, ...n) {},
+  fatal: function (o, ...n) {},
+  trace: function (o, ...n) {},
+  debug: function (o, ...n) {},
+  child: function() {
+    const child = Object.create(this);
+    child.pino = pino.child(...arguments);
+    return child;
+  },
+};
+
+const fastify = require('fastify')({logger: customLogger});
+```
 
 <a name="custom-http-server"></a>
 ### `serverFactory`
@@ -142,6 +162,13 @@ fastify.get('/user/:username', (request, reply) => {
 
 + 默认值：`'request-id'`
 
+<a name="factory-request-id-log-label"></a>
+### `requestIdLogLabel`
+
+定义日志中请求 id 的标签。
+
++ 默认值：`'reqId'`
+
 <a name="factory-gen-request-id"></a>
 ### `genReqId`
 用于生成请求 id 的函数。参数为来访的请求对象。
@@ -151,8 +178,11 @@ fastify.get('/user/:username', (request, reply) => {
  ```js
 let i = 0
 const fastify = require('fastify')({
-  genReqId: function (req) { return i++ }
+  genReqId: function (req) { return req.headers['request-id'] || i++ }
 })
+```
+
+**注意：当设置了 'request-id' header时，genReqId _不会_ 被调用。**
 
 <a name="factory-trust-proxy"></a>
 ### `trustProxy`
@@ -454,6 +484,10 @@ fastify.register(function (instance, opts, next) {
 #### setSchemaCompiler
 为所有的路由设置 schema 编译器 (schema compiler)，请看[这里](https://github.com/fastify/docs-chinese/blob/master/docs/Validation-and-Serialization.md#schema-compiler)了解更多信息。
 
+<a name="schema-compiler"></a>
+#### schemaCompiler
+`setSchemaCompiler` 方法的简写。用于设置 schema 编译器函数，也可用于返回全部路由的 schema 编译器。
+
 <a name="set-not-found-handler"></a>
 #### setNotFoundHandler
 

docs/Validation-and-Serialization.md

@@ -242,6 +242,10 @@ const ajv = new Ajv({
 fastify.setSchemaCompiler(function (schema) {
   return ajv.compile(schema)
 })
+
+// -------
+// 此外，你还可以通过 setter 方法来设置 schema 编译器：
+fastify.schemaCompiler = function (schema) { return ajv.compile(schema) })
 ```
 
 你可能还想使用其他的验证库，例如 `Joi`。这时，你只要参照下面的示例，便能轻松地使用它们来校验 url 参数、请求主体与查询字符串了！