用 Node.js 搭建 Web 伺服器,是學習 Node.js 相當全面的一道入門練習。因為要完成一個簡單的 Web 伺服器,你會需要用到幾個重要模組:http 協議模組、檔案系統、url 解析模組、路徑解析模組,還得處理 301 重定向的問題。下面我們就一步步來打造它。
作為一個 Web 伺服器,它應該具備以下功能:
1、能顯示以 .html/.htm 結尾的網頁;
2、能直接開啟以 .js/.css/.json/.text 結尾的檔案內容;
3、顯示圖片資源;
4、自動下載以 .apk/.docx/.zip 結尾的檔案;
5、當網址形如 https://xxx.com/a/b/ 時,查找 b 目錄下是否有 index.html,有的話就顯示,沒有則列出該目錄下所有檔案與資料夾,並可進一步點擊訪問;
6、當網址形如 https://xxx.com/a/b(結尾無斜線)時,作 301 重定向到 https://xxx.com/a/b/,以解決內部資源引用錯位的問題。
先引入需要用到的模組:
//http協議模塊 var http = require('http'); //url解析模塊 var url = require('url'); //文件系統模塊 var fs = require("fs"); //路徑解析模塊 var path = require("path");
建立服務並在指定埠口監聽:
//創建一個服務 var httpServer = http.createServer(this.processRequest.bind(this)); //在指定的端口監聽服務 httpServer.listen(port,function(){ console.log("[HttpServer][Start]","runing at https://"+ip+":"+port+"/"); console.timeEnd("[HttpServer][Start]"); });
建立服務時需傳入一個匿名函式 processRequest 來處理請求,它接收 request 與 response 兩個參數:request 物件包含請求的所有內容,response 則用來設定回應標頭並對客戶端做出回應。
processRequest:function(request,response){ var hasExt = true; var requestUrl = request.url; var pathName = url.parse(requestUrl).pathname; //對請求的路徑進行解碼,防止中文亂碼 pathName = decodeURI(pathName); //如果路徑中沒有擴展名 if(path.extname(pathName) === ''){ //如果不是以/結尾的,加/並作301重定向 if (pathName.charAt(pathName.length-1) != "/"){ pathName += "/"; var redirect = "https://"+request.headers.host + pathName; response.writeHead(301, { location:redirect }); response.end(); } //添加默認的訪問頁面,但這個頁面不一定存在,後面會處理 pathName += "index.html"; hasExt = false; //標記默認頁面是程序自動添加的 } //獲取資源文件的相對路徑 var filePath = path.join("http/webroot",pathName); //獲取對應文件的文檔類型 var contentType = this.getContentType(filePath); //如果文件名存在 fs.exists(filePath,function(exists){ if(exists){ response.writeHead(200, {"content-type":contentType}); var stream = fs.createReadStream(filePath,{flags:"r",encoding:null}); stream.on("error", function() { response.writeHead(500,{"content-type": "text/html"}); response.end("<h1>500 Server Error</h1>"); }); //返回文件內容 stream.pipe(response); }else { //文件名不存在的情況 if(hasExt){ //如果這個文件不是程序自動添加的,直接返回404 response.writeHead(404, {"content-type": "text/html"}); response.end("<h1>404 Not Found</h1>"); }else { //如果文件是程序自動添加的且不存在,則表示用戶希望訪問的是該目錄下的文件列表 var html = "<head><meta charset='utf-8'></head>"; try{ //用戶訪問目錄 var filedir = filePath.substring(0,filePath.lastIndexOf('\\')); //獲取用戶訪問路徑下的文件列表 var files = fs.readdirSync(filedir); //將訪問路徑下的所以文件一一列舉出來,並添加超鏈接,以便用戶進一步訪問 for(var i in files){ var filename = files[i]; html += "<div><a href='"+filename+"'>"+filename+"</a></div>"; } }catch (e){ html += "<h1>您訪問的目錄不存在</h1>" } response.writeHead(200, {"content-type": "text/html"}); response.end(html); } } }); },
請求處理函式裡有幾個重點值得留意:
對於路徑中含中文的情況,瀏覽器會自動編碼(英文不變、中文變編碼),因此接收到網址後必須解碼,否則最後得到的路徑會與真實路徑不符;
當訪問路徑不是以具體檔案結尾、也不是以 / 結尾時,需透過重定向補上 /,表示當前目錄,否則該路徑下的靜態資源會找不到;
若訪問的是目錄,則列出該目錄下所有檔案與資料夾並可點擊訪問,為了讓中文目錄正常顯示,還要在 header 中設定 charset=utf-8。
核心程式碼差不多 140 行左右,完整程式碼已上傳至 GitHub:https://github.com/git-onepixel/Node
若要運行 demo,打開 cmd 切換到根目錄,執行 node start 即可。以上就是本文的全部內容,希望對你的學習有所幫助。