這次帶給大家Node.js Express安裝與使用步驟詳解,Node.js Express安裝與使用的注意事項有哪些,下面就是實戰案例,一起來看一下。
之前我們在安裝完Node.js後直接寫了個HelloWorld網站,這次呢,我們使用Node.js的Web框架Express來重寫一下HelloWorld,看看有什麼不同。同時我們也會重寫之前的文件伺服器,功能更完善而程式碼更簡潔。
安裝 express
為了重寫我們的HelloWorld,我們需要安裝Express模組。 Express基於Node.js的一個Web框架,官方網站在這裡:http://expressjs.com/。官網對Express的介紹是:
Fast, unopinionated, minimalist web framework for Node.js
Express很輕巧,通常用來做Web後端的開發。有一些推薦的書,可以看這裡:http://www.jb51.net/books/470249.html。
要安裝express模組,直接使用npm指令即可。在命令列環境下不帶參數執行npm指令,即可看到npm的幫助資訊。安裝某個Node.js模組,使用install子指令。 「npm install xxx」會將xxx模組安裝到目前路徑下,「npm install -g xxx」則將xxx模組安裝到目前使用者的全域位置。使用「npm helo install」可以查看install子指令的細節。要卸載一個模組,使用“npm uninstall xxx”,假如你是全域安裝,則使用“npm uninstall -g xxx”。
在使用npm安裝某個模組時,它會自動解決依賴。
在命令列環境執行下面的命令來安裝express:
npm install -g express –registry=https://registry.npm.taobao.org
注意,我指定了使用淘寶的鏡像,快一些。
特別說明一下:
我參考了這裡的教學哦:https://github.com/alsotang/node-lessons
很快啦,你就可以看到下面的介面(注意我們安裝的Express版本是4.13.3):
好啦,Express安裝完畢。
需要說明的是,使用-g指令全域安裝Node.js模組後,需要設定環境變數NODE_PATH,否則在我們使用node指令啟動某個應用程式時可能會報找不到指定的模組這種錯誤。在我的Windows 7環境下,全域安裝時npm模組的位置為「C:\Users\Administrator\AppData\Roaming\npm\node_modules」(看上面的圖可知)。至於環境變數的設置,計算機->高級系統設置->高級->環境變量,添加一個名為NODE_PATH的環境變量, 將其值設置為全域模組的根目錄。設定完成後,重新進入命令列環境即可生效。
提一下,如果要在NODE_PATH中新增多個模組路徑,只需用「;」分隔開即可。具體含義,命令列下執行“node -h”可查看幫助。
HelloWorld
程式碼就是這麼簡單:
// 引入 express 模块 var express = require('express'); // 创建 express 实例 var app = express(); // 响应HTTP的GET方法 app.get('/', function (req, res) { res.send('Hello World!'); }); // 监听到8000端口 app.listen(8000, function () { console.log('Hello World is listening at port 8000'); });
儲存為HelloExpress.js,然後在Node.js的命令列環境下執行「node HelloExpress.js」指令,網站就運作起來了。瀏覽器訪問一下,和上次的範例一樣一樣的。
使用Express有什麼不同
沒有使用Express的程式碼是醬紫的:
// 引入http模块 var http = require("http"); // 创建server,指定处理客户端请求的函数 http.createServer( function(request, response) { response.writeHead(200, {"Content-Type": "text/plain"}); response.write("Hello World!"); response.end(); } ).listen(8000); console.log("Hello World is listening at port 8000");
上面的程式碼直接使用Node.js帶的http模組來建立HTTP伺服器,指定了一個處理請求的函數。實際應用時,我們需要在這個函數內區分不同的HTTP請求,例如GET、HEAD、POST等。而Express版本的HelloWorld則有所不同,它可以針對每個路徑和HTTP請求指定回應函數,例如Express版本的HelloWorld實例,只有當你在瀏覽器中輸入「http://localhost:8000」時它才會回到“HelloWorld”,如果你在瀏覽器中輸入“http://localhost:8000/abc”,就看到一條錯誤訊息(會收到404狀態碼
#### ,express自動幫你處理了)。這裡邊有一個URL路由(URL routing)的概念。假如把程式碼修改成下面的樣子:###app.get('*', function (req, res) { res.send('Hello World!'); });
效果就和使用http模块的版本类似了。因为我使用了“*”作为通配符,可以匹配任何路径。Express的get方法原型如下:
app.METHOD(path, callback [, callback …])
具体可以参考这里:http://expressjs.com/4x/api.html#app.METHOD。
使用express创建HelloExpress
express模块有一个命令行工具express,可以用来生成基于express模块的应用结构(网站结构)。
express 4.x之后,express命令被独立出来放在了express-generator模块中。我们用下面的命令全局安装express这个命令行工具:
npm install -g express-generator
安装完成后,在命令行环境下执行“express -V”,可以看到express的版本是4.13.1。
好了,现在我们使用express命令来创建一个默认的网站。
在命令行环境下导航到myprojects这个目录下,执行下面的命令:
express HelloExpress
然后可以看到:
仔细看上面的图哦,它告诉了我们三类非常重要的信息:
express命令创建的网站的目录结构以及创建的文件
安装依赖(进入到HelloExpress下,执行npm install)
使用npm start启动网站(express 4.x后)
好啦,我们先安装依赖。这里要先提一下HelloExpress目录下的package.json文件,其内容如下:
{ "name": "HelloExpress", "version": "0.0.0", "private": true, "scripts": { "start": "node ./bin/www" }, "dependencies": { "body-parser": "~1.13.2", "cookie-parser": "~1.3.5", "debug": "~2.2.0", "express": "~4.13.1", "jade": "~1.11.0", "morgan": "~1.6.1", "serve-favicon": "~2.3.0" } }
这个文件定义了一个Node.js应用的基本信息,我们这次注意的是 dependencies ,它定义了应用依赖的模块。
在HelloExpress下执行“npm install”命令,npm会自动找到package.json,分析它,安装所有依赖模块。这要花费一些时间,休息一下,去喝杯茶。
看看,下面是安装结果:
G:\nodejs\myprojects\HelloExpress>npm install debug@2.2.0 node_modules\debug └── ms@0.7.1 cookie-parser@1.3.5 node_modules\cookie-parser ├── cookie-signature@1.0.6 └── cookie@0.1.3 serve-favicon@2.3.0 node_modules\serve-favicon ├── fresh@0.3.0 ├── etag@1.7.0 ├── parseurl@1.3.0 └── ms@0.7.1 morgan@1.6.1 node_modules\morgan ├── basic-auth@1.0.3 ├── on-headers@1.0.0 ├── depd@1.0.1 └── on-finished@2.3.0 (ee-first@1.1.1) body-parser@1.13.3 node_modules\body-parser ├── content-type@1.0.1 ├── bytes@2.1.0 ├── depd@1.0.1 ├── on-finished@2.3.0 (ee-first@1.1.1) ├── qs@4.0.0 ├── iconv-lite@0.4.11 ├── http-errors@1.3.1 (inherits@2.0.1, statuses@1.2.1) ├── raw-body@2.1.2 (unpipe@1.0.0) └── type-is@1.6.6 (media-typer@0.3.0, mime-types@2.1.4) express@4.13.3 node_modules\express ├── escape-html@1.0.2 ├── merge-descriptors@1.0.0 ├── array-flatten@1.1.1 ├── cookie@0.1.3 ├── cookie-signature@1.0.6 ├── methods@1.1.1 ├── utils-merge@1.0.0 ├── range-parser@1.0.2 ├── fresh@0.3.0 ├── path-to-regexp@0.1.7 ├── vary@1.0.1 ├── content-type@1.0.1 ├── etag@1.7.0 ├── parseurl@1.3.0 ├── content-disposition@0.5.0 ├── serve-static@1.10.0 ├── depd@1.0.1 ├── qs@4.0.0 ├── finalhandler@0.4.0 (unpipe@1.0.0) ├── on-finished@2.3.0 (ee-first@1.1.1) ├── send@0.13.0 (destroy@1.0.3, statuses@1.2.1, ms@0.7.1, mime@1.3.4, http-er rors@1.3.1) ├── accepts@1.2.12 (negotiator@0.5.3, mime-types@2.1.4) ├── type-is@1.6.6 (media-typer@0.3.0, mime-types@2.1.4) └── proxy-addr@1.0.8 (forwarded@0.1.0, ipaddr.js@1.0.1) jade@1.11.0 node_modules\jade ├── character-parser@1.2.1 ├── void-elements@2.0.1 ├── commander@2.6.0 ├── constantinople@3.0.2 (acorn@2.1.0) ├── mkdirp@0.5.1 (minimist@0.0.8) ├── clean-css@3.3.7 (commander@2.8.1, source-map@0.4.4) ├── uglify-js@2.4.24 (uglify-to-browserify@1.0.2, async@0.2.10, source-map@0. 1.34, yargs@3.5.4) ├── with@4.0.3 (acorn@1.2.2, acorn-globals@1.0.5) ├── transformers@2.1.0 (css@1.0.8, uglify-js@2.2.5, promise@2.0.0) └── jstransformer@0.0.2 (is-promise@2.0.0, promise@6.1.0) G:\nodejs\myprojects\HelloExpress>
有兴趣的可以研究下各个依赖模块的信息,现在我们启动网站了。执行 npm start 命令,很快就可以看到下面的图:
看到上图,说明网站已正常运行。你可以在浏览器里访问http://localhost:3000,然后就可以看到这个页面:
OK,大功告成。
这个由express generator创建的HelloExpress和我们基于express手动写的HelloWorld又有一些不同,比如你在浏览器地址栏里输入http://localhost:3000/abc,就会看到一个默认的404页面,显示了具体的错误信息。而我们的HelloWorld,显示的则是“Cannot GET /abc”这个文本串。这就是模板的便利之处,有很多默认处理,可以为我们省很多麻烦。
Express版本的文件服务器
express是在Node.js的http的基础上实现的,相比http模块,封装更多更适用于web服务器场景的功能。之前我们在Node.js开发入门——HTTP文件服务器里使用http模块实现了一个简单的文件服务器。那个版本的文件服务器还有一个缺陷,就是没有根据文件名设置HTTP的Content-Type头部。如果我们使用express来实现文件服务器(用到了Request对象的sendFile方法),哈哈,就只有几行代码,还解决了Content-Type问题!
代码如下:
var express = require('express'); var app = express(); app.get('*', function(req, res){ res.sendFile(req.path, {root: dirname+'/', dotfiles: 'deny'}); }); app.listen(3000);
是不是超级简单?
相信看了本文案例你已经掌握了方法,更多精彩请关注php中文网其它相关文章!
推荐阅读:
以上是Node.js Express安裝與使用步驟詳解的詳細內容。更多資訊請關注PHP中文網其他相關文章!