迁移到 Express 4

概述

Express 4 对 Express 3 进行了重大更改，这意味着，如果您在现有 Express 3 应用程序的依赖项中更新了 Express 版本，那么该应用程序将无法工作。

升级到 Express 4

卸载 Express 3

npm remove express --save

安装 Express 4

npm install express --save

升级到 Express 4 应用程序生成器

卸载 Express 3 应用程序生成器

npm remove express -g
or sudo npm remove express -g

安装 Express 4 应用程序生成器

npm install express-generator -g
or sudo npm install express-generator -g

创建 Express 4 app

$ express appName

启动 app

$ npm start

之前 Express 3 中启动 app 的命令是node app.js，大家可以看到 app.js 现在成为了一个模块，再看 package.json 中的启动脚本，可以发现实际的启动命令是node ./bin/www 。由 Express 4 生成的 app.js 是作为一个模块，所以不再能够将其作为应用程序独立启动（除非修改代码）。现在是由 ./bin/www 加载 app.js 模块进行启动。

如何修改为 Express 3 风格进行启动

不使用 www，而要保持node app.js风格的话，请删除 app.js 文件末尾的module.exports = app;行。在 app.js 头部加上var debug = require('debug')('app4');。在最后加上如下代码：

app.set('port', process.env.PORT || 3000);
var server = app.listen(app.get('port'), function () { debug('Express server listening on port ' + server.address().port)})

然后，将 package.json 文件中的 "start": "node ./bin/www"更改为 "start": "node app.js"。

Express 4 中的更改

对 Express 核心和中间件系统的更改

Express 4 不再依赖于 Connect，从其核心移除了所有内置的中间件（除了 express.static
函数），需要自己单独安装和显式添加所需中间件。

app.use 可以使用参数

app.use('/book/:id', function (req, res, next) { console.log('ID:', req.params.id) next()})

路由系统

应用程序现在隐式装入路由中间件，所以无需担心其他中间件相对于路由中间件的装入顺序。
定义路由的方式并未改变，但是路由系统新增了两个功能，用于帮助组织路由：

• 一个新方法 app.route()，用于为路由路径创建可链接的路由处理程序。
• 一个新类 express.Router，用于创建可安装的模块化路由处理程序。

其他修改

对象	描述
Node.js	Express 4 需要 Node.js 0.10.x 或更高版本，已取消对 Node.js 0.8.x 的支持。
http.createServer()	不再需要 http 模块，除非您要直接使用它 (socket.io/SPDY/HTTPS)。可以使用 app.listen() 函数来启动此应用程序。
app.configure()	已移除 app.configure() 函数。使用 process.env.NODE_ENV 或 app.get('env') 功能来检测环境并相应配置该应用程序。
json spaces	缺省情况下，已禁用 json spaces 应用程序属性。
req.accepted()	使用 req.accepts()、req.acceptsEncodings()、req.acceptsCharsets() 和 req.acceptsLanguages()。
res.location()	不再解析相对 URL。
req.params	原来是数组；现在是对象。
res.locals	原来是函数；现在是对象。
res.headerSent	更改为 res.headersSent。
app.route	现在可作为 app.mountpath 使用。
res.on('header')	已移除。
res.charset	已移除。
res.setHeader('Set-Cookie', val)	功能现在已限制为设置基本 cookie 值。更多的功能请使用 res.cookie()。

Express 4 中的其他细节

详见 Moving to Express 4(English edition)
或 迁移到 Express 4(中文版)