[转载]Express4 启航指南 – 聂微东 – 博客园.
确实有感而发,Nodejs真的发展太快了,这么 说的原因有两点:自己去年冬天买了本《了不起的Node.js》,里面介绍Express的版本还是2.x.x;前些天小伙伴买了本《Node.js实 战》,结果依赖的Express是3.x.x。尼玛如果安装目前新版的Express4,那么这些书中的例子连项目都无法正常跑起来。
Nodejs相关的纸版书一上市就已经过时了!
此文的背景是由于俺某天手欠,升级了最新Express V4+后,发现项目不可用了(还好是公司内部的小工具),查找资料后整理了些许总结,介绍如何使用Express4搭建项目。
情况差不多就是这样,那么咱们”深入浅出”一把Express项目吧。
如果看官想了解Express 4之前的安装、使用可查看:http://www.cnblogs.com/Darren_code/p/node_express.html
————————— 分割线 —————————
目录
建立工程环境
先介绍下各种环境吧:
进入俺们的项目所在目录:
cd /home/work/node/project
npm安装express , -g 指令让express进入全局安装:
$ npm install -g express
如果是express 4.0之前版本,那么执行“express -V”就可以得到版本号了,可express 4.0之后还需要再安装express-generator包,如果没有安装还执行“express -V”命令会报错。
执行安装express-generator包:
$ npm install -g express-generator
现在执行“$ express -V”可查看express版本信息了。
发生这种情况的原因是,express4.0之后把创建一个APP的功能分离出来为express-generator,没它你创建不了应用程序。
NPM和模块
以下两张express目录(安装samba,Windows下查看无压力)的图片可以更直观的对比express包的变化,下图左侧是V3.15.0,下图右侧是V4.7.0:
目录结构上看就缺少一个bin文件,这个bin目录内存放的就是内部命令(下图),只不过它们都是以独立的文件形式存在的。
PS:bin是binary的缩写,有关bin和sbin目录的含义需要看官对linux的目录结构有一点点了解,使用Google 百度一下”linux 目录”即可找到对应资料。
再从模块信息(node_modules/express/package.json)看它们的重要不同:
"bin": {
"express": "./bin/express"
}
需要注意npm模块中的信息都在package.json里面,包括各种配置信息。
其中”bin”这个key就是申明用户可以使用“command-name”这个命令,而输入该命令后就会去执行“command-file”这个文件。如下:
{
...
"bin": {
"command-name” : “command-file”
}
...
}
所以在命令行输入express命令时,其实对应的其实是去执行bin目录下的express程序。
如果自己要制作模块包,且希望可以命令行工具使用时,需要配置好bin字段,当全局模式安装之后就可以在命令行直接执行使用。有关package.json的信息会再配置章节中再详细介绍,”$ npm help json”可以获取官方的详细信息。
全局模式安装的意义
npm安装的时候区分本地模式安装和全局模式安装,“-g”就表示全局模式安装,这种模式会被安装在node安装目录的lib所在目录的node_modules文件夹中,全局使用。
NPM是由Isaac Z.Schlueter创建的,提供给Node服务的Node包管理器,最开始需要独立安装,后来当Nodev0.6.3版本默认集成了NPM作为Node包管理器,所以在那之后,只要使用NPM安装的全局包地址,都可以推算出来。
如Node在/usr/local/bin/node,那么模块目录就是/usr/local/lib/node_modules/下。
非全局那么就是本地模式安装,这类模式安装会被安装在当前目录的node_modules文件夹中,非全局使用。
如果express-generator不是全局模式安装怎么办?
非常不爽的就是命令行工具中直接使用”express [option] [dir]”就没法完成了,只能手动的找到执行文件执行才可以,如本地模式安装的时只能只能在当前目录下执行
$ ./node_modules/express-generator/bin/express -V
4.2.0
创建项目
东扯西扯完毕,各方面也已经Ready,创建个Express项目开心一下:)
再确认一下所在的目录位置
express myapp
$ cd myapp && npm install
npm install完成之后就可以run起来咯,执行:
$ DEBUG=myapp ./bin/www
执行“npm start”其效果一样,下图分别是这两条语句执行情况:
PS:红框中的内容是访问时打印的信息。
可以看到俩条命令打印出来的信息有一行不一样,执行完“Debug=myapp ./bin/www”后会打印出:“myapp Express server listening on port 8898 +0ms”
让俺们来看看为神马,执行命令:
$ vi ./bin/www
PS:默认PORT其实3000(红框中的部分),俺手动修改后使用的是8898端口
Express4中引入了著名的Debug模块,所以debug模式让我们更方便的玩转Node中的模块,其使用方法介绍起来较长,建议大家看看其官方的介绍:https://www.npmjs.org/package/debug
重要的package.json文件马上会介绍,创建Express4项目俺们就说到这里。
目录结构
了解目录结构是玩转一切项目的第一步:
- app.js,程序启动文件
- bin,创建项目时已经提到,是真实的执行程序
- node_modules, 存放所有的项目依赖库
- package.json,项目依赖配置及开发者信息
- public,静态文件(css,js,img)
- routes,路由文件
- views,页面文件
配置文件之神奇的package.json
在Nodejs项目中,package.json文件用来声明项目基本信息和使用的模块,这样在新的环境部署时,只要在package.json文件所在的目录执行npm install命令即可按照所需要的模块啦。
下面俺们通过这个package.json文件再Build Express项目玩玩(生命不息折腾不止嘛)。
回到project目录:
在project目录下新加testpackage项目
$ mkdir testpackage && cd testpackage
把myapp中的package.json copy过来
$ cp ../myapp/package.json ./
创建个server.js,写入简单的几行代码,运行一把:
1
2
3
4
5
6
7
8
9
10
11
|
var express = require( 'express' ); var app = express(); app. get ( '/' , function(req, res){ res.send( 'Hello World' ); }); var server = app.listen(8808, function() { console.log( 'Listening on port %d' , server.address().port); }); app. get ( '/sayhi' , function(req, res){ res.send( '狗狗 黑喂狗' ); }); |
上面俩图就是运行结果。
查看package.json中的内容如下
会议下由package.json实现的快速项目搭建,俺们再来了解其内容意义:
- name
~ 在package.json中最重要的就是name和version字段。他们都是必须的,如果没有就无法install;
~ 想好名字之前先去npm registry查看一下这个名字是否已经被使用了,http://registry.npmjs.org/
- version
~ version必须能被 node-semver解析,它被包在npm的依赖中;
~ name和version一起组成的标识在假设中是唯一的。改变包应该同时改变version - private
~ 如果你设置”private”: true,npm就不会发布它;
~ 这是一个防止意外发布私有库的方式。如果你要确定给定的包是只发布在特定registry(如内部registry)的,用publishConfighash的描述来重写registry的publish-time配置参数
- scripts
~ “scripts”是一个由脚本命令组成的hash对象,他们在包不同的生命周期中被执行。key是生命周期事件,value是要运行的命令。 - dependencies
~ 依赖是给一组包名指定版本范围的一个hash。这个版本范围是一个由一个或多个空格分隔的字符串。依赖还可以用tarball或者git URL
以上五项仅仅是Express4 package.json使用的,其他细节可参考文档 传送门https://www.npmjs.org/doc/files/package.json.html
小结一下
文章在偏应用的层面上介绍了NPM和模块信息,希望能对大家了解有所帮忙吧。
8月份的文章补上,俺们下一章再来介绍用Express+mongodb搭建个人网站,保佑老子千万别跳票了…吼吼:)
资料
- http://expressjs.com
- http://www.npmjs.com/
- (英语)https://www.npmjs.org/doc/files/package.json.html
- (中文)http://mujiang.info/translation/npmjs/files/package.json.html