使用给定的format和options创建一个新的morgan中间件
format:字符串、格式化字符串、生成日志功能的函数
format函数有三个参数:tokens、req、res.
tokens是所有已定义标记的对象,req是HTTP请求,res是HTTP响应
//使用预定义的格式化字符串 morgan('tiny') //使用预定义tokens的格式化字符串 morgan(':method :url :status :res[content-length] - :response-time ms') //使用自定义格式化函数 morgan(function (tokens, req, res) { return [ tokens.method(req, res), tokens.url(req, res), tokens.status(req, res), tokens.res(req, res, 'content-length'), '-', tokens['response-time'](req, res), 'ms' ].join(' ') })immediate 在请求而不是响应写入日志行,这意味着即使服务器崩溃，也将记录请求，但是无法记录来自响应的数据（例如响应代码，内容长度等）
skip 确定是否跳过日志记录函数,默认false,该函数将调用skip(req,res)
//仅记录错误的响应日志 morgan('combined', { skip: function (req, res) { return res.statusCode < 400 } })stream: 写入日支行的输出流,默认为process.stdout
回调函数应该返回字符串，返回值可用作"format_name"
morgan.token('type', function (req, res) { return req.headers['content-type'] })format_name与预定义的tokens相同覆盖默认的
回调函数应该使用req，res，代表请求、响应，此外还可以使用其他参数，其他参数如下
:data[format] 当前UTC时间，可用格式如下
clf 通用日志格式("10/Oct/2000:13:55:36 +0000")
iso 通用的ISO 8601 日期时间格式(2000-10-10T13:55:36.000Z)
web 通用的RFC 1123 日期时间格式(Tue, 10 Oct 2000 13:55:36 GMT)
如果format为空，默认为web
:http-version 请求的HTTP版本
:method HTTP请求方法
:referrer 请求的referrer标头
:remote-addr 请求的远程地址
:remote-user 身份验证的用户
:req[header] 请求的给定标头。 如果标题不存在，则该值将在日志中显示为“-”
:res[header] 给定的响应标头。 如果响应头不存在，则该值将在日志中显示为“-”
:response-time[digits] 从请求进入morgan到响应头被写入的时间(ms)，digits参数是一个数字，指定要包括在该数字上的位数，默认为3，可提供微秒精度
:status 响应的状态码
:total-time[digits] 从请求进入morgan到响应完成之间的时间(ms),digits参数是一个数字，指定要包括在该数字上的位数，默认为3，可提供微秒精度
:url 请求的url
:user-agent 请求的User-Agent标头的内容
将格式字符串编译为供morgan使用的格式函数。 格式字符串是表示单个日志行并可以使用令牌语法的字符串。 tokens是通过：token-name引用的。 如果令牌接受参数，则可以使用[]进行传递，例如：：token-name [pretty]将字符串’pretty’作为令牌令牌名称的参数传递
从morgan.compile返回的函数采用三个参数tokens，req和res，其中tokens是具有所有已定义tokens的对象，req是HTTP请求，res是HTTP响应。 该函数将返回一个字符串，该字符串将是日志行，或者返回undefined / null以跳过日志记录。
通常，格式是使用morgan.format（name，format）定义的，但是对于某些高级用法，此编译功能可直接使用。
express/connect
输出到标准输出
var express = require('express') var morgan = require('morgan') var app = express() app.use(morgan('combined')) app.get('/', function (req, res) { res.send('hello, world!') })vanilla http server
输出到标准输出
var finalhandler = require('finalhandler') var http = require('http') var morgan = require('morgan') // create "middleware" var logger = morgan('combined') http.createServer(function (req, res) { var done = finalhandler(req, res) logger(req, res, function (err) { if (err) return done(err) // respond to request res.setHeader('content-type', 'text/plain') res.end('hello, world!') }) })将所有请求记录到文件access.log中
var express = require('express') var fs = require('fs') var morgan = require('morgan') var path = require('path') var app = express() // create a write stream (in append mode) var accessLogStream = fs.createWriteStream(path.join(__dirname, 'access.log'), { flags: 'a' }) // setup the logger app.use(morgan('combined', { stream: accessLogStream })) app.get('/', function (req, res) { res.send('hello, world!') })以一天为周期记录日志到/log目录下
var express = require('express') var morgan = require('morgan') var path = require('path') var rfs = require('rotating-file-stream') // version 2.x var app = express() // create a rotating write stream var accessLogStream = rfs.createStream('access.log', { interval: '1d', // rotate daily path: path.join(__dirname, 'log') }) // setup the logger app.use(morgan('combined', { stream: accessLogStream })) app.get('/', function (req, res) { res.send('hello, world!') })该示例应用程序将使用Apache格式将所有请求记录到一个文件，但是错误响应将记录到控制台
var express = require('express') var fs = require('fs') var morgan = require('morgan') var path = require('path') var app = express() // log only 4xx and 5xx responses to console app.use(morgan('dev', { skip: function (req, res) { return res.statusCode < 400 } })) // log all requests to access.log app.use(morgan('common', { stream: fs.createWriteStream(path.join(__dirname, 'access.log'), { flags: 'a' }) })) app.get('/', function (req, res) { res.send('hello, world!') })使用自定义令tokens式的示例应用。 这会向所有请求添加一个ID，并使用：id tokens显示它
var express = require('express') var morgan = require('morgan') var uuid = require('node-uuid') morgan.token('id', function getId (req) { return req.id }) var app = express() app.use(assignId) app.use(morgan(':id :method :url :response-time')) app.get('/', function (req, res) { res.send('hello, world!') }) function assignId (req, res, next) { req.id = uuid.v4() next() }