Explication détaillée de l'utilisation du serveur de fichiers statiques de nœud-js tutoriel-php.cn

Cette fois, je vais vous apporter une explication détaillée de l'utilisation du serveur de fichiers statiques de nœud. Quelles sont les précautions lors de l'utilisation du serveur de fichiers statiques de nœud. Ce qui suit est un cas pratique, jetons un coup d'œil.

Cet article présente principalement des exemples de serveurs de fichiers statiques de nœuds réels et les partage avec tout le monde. Les détails sont les suivants :

Fonctions prises en charge :

. Lire les fichiers statiques
peut trouver automatiquement le fichier index.html suivant lors de l'accès au répertoire. S'il n'y a pas d'index.html, la liste des fichiers sera répertoriée
Prise en charge du type MIME
Prise en charge/contrôle du cache
Prise en charge de la compression gzip
Prise en charge de la plage, suite à partir du point d'arrêt Pass
Exécution globale de la commande
Exécution du sous-processus

1 . Créez un service pour lire le fichier statique

présente d'abord le module http, crée un serveur et écoute le port de configuration :

 const http = require('http');
 
 const server = http.createServer();
 
 // 监听请求
 server.on('request', request.bind(this));
 
 server.listen(config.port, () => {
  console.log(`静态文件服务启动成功, 访问localhost:${config.port}`);
 });

Copier après la connexion

Écrivez un fn pour gérer spécifiquement les requêtes et renvoyer du statique. fichiers. Le module url obtient le chemin :

 const url = require('url');
 const fs = require('fs');
 function request(req, res) {
 const { pathname } = url.parse(req.url); // 访问路径
 
 const filepath = path.join(config.root, pathname); // 文件路径
 
 fs.createReadStream(filepath).pipe(res); // 读取文件，并响应
 }

Copier après la connexion

Prise en charge de la recherche d'index.html :

 if (pathname === '/') {
  const rootPath = path.join(config.root, 'index.html');
  try{
   const indexStat = fs.statSync(rootPath);
   if (indexStat) {
    filepath = rootPath;
   }
  } catch(e) {
   
  }
 }

Copier après la connexion

Lors de l'accès au répertoire, répertoriez le répertoire de fichiers :

 fs.stat(filepath, (err, stats) => {
 if (err) {
  res.end('not found');
  return;
 }
 if (stats.isDirectory()) {
  let files = fs.readdirSync(filepath);
  files = files.map(file => ({
   name: file,
   url: path.join(pathname, file)
  }));
  let html = this.list()({
   title: pathname,
   files
  });
  res.setHeader('Content-Type', 'text/html');
  res.end(html);
 }
 }

Copier après la connexion

Modèle HTML :

 function list() {
  let tmpl = fs.readFileSync(path.resolve(dirname, 'template', 'list.html'), 'utf8');
  return handlebars.compile(tmpl);
 }

Copier après la connexion

 <!DOCTYPE html>
 <html lang="en">
 <head>
 <meta charset="UTF-8">
 <meta name="viewport" content="width=device-width, initial-scale=1.0">
 <meta http-equiv="X-UA-Compatible" content="ie=edge">
 <title>{{title}}</title>
 </head>
 <body>
 <h1>hope-server静态文件服务器</h1>
 <ul>
  {{#each files}}
  <li>
   <a href={{url}}>{{name}}</a>
  </li>
  {{/each}}
 </ul>
 </body>
 </html>

Copier après la connexion

2. Prise en charge du type MIME

Utilisez le module MIME pour obtenir le type de fichier et définir l'encodage :

res.setHeader('Content-Type', mime.getType(filepath) + ';charset=utf-8');

Copier après la connexion

3. Prise en charge du cache

Cache du protocole http :

Cache-Control : contenu http1.1, indique au client comment

mettre en cache les données et les règles

les clients privés peuvent mettre en cache
public Le client et le serveur proxy peuvent mettre en cache
max-age=60 mis en cache le contenu expirera après 60 secondes
no-cache doit utiliser le cache de comparaison pour vérifier les données et forcer à nouveau la vérification sur le serveur source
no-store Tout le contenu ne sera pas mis en cache, et ni la mise en cache forcée ni la mise en cache de comparaison ne seront déclenchées

Expire : le contenu http1.0, le contrôle du cache l'écrasera et le dira. le client lorsque le cache expirera

ETag : la valeur de hachage du contenu dans lequel se trouvera la prochaine requête du client. Ajouter if-none-match : valeur etag

Last-Modified : heure de la dernière modification dans l'en-tête de la requête, la prochaine fois que le client demandera, ajoutez la valeur if-modified-since : Last-Modified

4. et indique au serveur quels formats de compression sont pris en charge via l'en-tête de requête Accept-Encoding : gzip, deflate Le serveur compresse le contenu en fonction des formats de compression pris en charge. Si le serveur ne le prend pas en charge, aucune compression ne sera effectuée.

 handleCache(req, res, stats, hash) {
 // 当资源过期时, 客户端发现上一次请求资源，服务器有发送Last-Modified, 则再次请求时带上if-modified-since
 const ifModifiedSince = req.headers['if-modified-since'];
 // 服务器发送了etag,客户端再次请求时用If-None-Match字段来询问是否过期
 const ifNoneMatch = req.headers['if-none-match'];
 // http1.1内容 max-age=30 为强行缓存30秒 30秒内再次请求则用缓存 private 仅客户端缓存，代理服务器不可缓存
 res.setHeader('Cache-Control', 'private,max-age=30');
 // http1.0内容 作用与Cache-Control一致 告诉客户端什么时间，资源过期 优先级低于Cache-Control
 res.setHeader('Expires', new Date(Date.now() + 30 * 1000).toGMTString());
 // 设置ETag 根据内容生成的hash
 res.setHeader('ETag', hash);
 // 设置Last-Modified 文件最后修改时间
 const lastModified = stats.ctime.toGMTString();
 res.setHeader('Last-Modified', lastModified);
 
 // 判断ETag是否过期
 if (ifNoneMatch && ifNoneMatch != hash) {
  return false;
 }
 // 判断文件最后修改时间
 if (ifModifiedSince && ifModifiedSince != lastModified) {
  return false;
 }
 // 如果存在且相等，走缓存304
 if (ifNoneMatch || ifModifiedSince) {
  res.writeHead(304);
  res.end();
  return true;
 } else {
  return false;
 }
 }

Copier après la connexion

5. Reprise du point d'arrêt

Le serveur utilise Range : bytes=0-xxx dans l'en-tête de la requête pour déterminer s'il effectue une requête Range si cette valeur existe et est valide. , puis seule la partie demandée du contenu du fichier est renvoyée et la réponse

 getEncoding(req, res) {
  const acceptEncoding = req.headers['accept-encoding'];
  // gzip和deflate压缩
  if (/\bgzip\b/.test(acceptEncoding)) {
   res.setHeader('Content-Encoding', 'gzip');
   return zlib.createGzip();
  } else if (/\bdeflate\b/.test(acceptEncoding)) {
   res.setHeader('Content-Encoding', 'deflate');
   return zlib.createDeflate();
  } else {
   return null;
  }
 }

Copier après la connexion

code d'état

devient 206, indiquant un contenu partiel, et Content-Range est défini. S'il n'est pas valide, un code d'état 416 est renvoyé, indiquant que la plage de demande n'est pas satisfaisante. Si l’en-tête de requête Range n’est pas inclus, continuez à répondre de la manière habituelle.

6. Exécution globale de la commande

implémentée via le lien npm

 getStream(req, res, filepath, statObj) {
  let start = 0;
  let end = statObj.size - 1;
  const range = req.headers['range'];
  if (range) {
   res.setHeader('Accept-Range', 'bytes');
   res.statusCode = 206;//返回整个内容的一块
   let result = range.match(/bytes=(\d*)-(\d*)/);
   if (result) {
    start = isNaN(result[1]) ? start : parseInt(result[1]);
    end = isNaN(result[2]) ? end : parseInt(result[2]) - 1;
   }
  }
  return fs.createReadStream(filepath, {
   start, end
  });
 }

Copier après la connexion

Créez un lien symbolique pour le répertoire du package npm et liez-le à { prefix }/lib/node_modules/

Créez un lien symbolique pour le fichier exécutable (bin) et liez-le à {prefix}/bin/{name}
La commande npm link rend la commande npm package globalement exécutable en liant les répertoires et les fichiers exécutables.

Créez le fichier Hope du répertoire bin sous le projet et utilisez la ligne de commande de configuration yargs pour transmettre les paramètres

 {
 bin: {
 "hope-server": "bin/hope"
 }
 }

Copier après la connexion

7 . Exécutez le processus enfant

Réalisé via spawn

 // 告诉电脑用node运行我的文件
 #! /usr/bin/env node
 
 const yargs = require('yargs');
 const init = require('../src/index.js');
 const argv = yargs.option('d', {
 alias: 'root',
 demand: 'false',
 type: 'string',
 default: process.cwd(),
 description: '静态文件根目录'
 }).option('o', {
 alias: 'host',
 demand: 'false',
 default: 'localhost',
 type: 'string',
 description: '配置监听的主机'
 }).option('p', {
 alias: 'port',
 demand: 'false',
 type: 'number',
 default: 8080,
 description: '配置端口号'
 }).option('c', {
 alias: 'child',
 demand: 'false',
 type: 'boolean',
 default: false,
 description: '是否子进程运行'
 })
 .usage('hope-server [options]')
 .example(
 'hope-server -d / -p 9090 -o localhost', '在本机的9090端口上监听客户端的请求'
 ).help('h').argv;
 
 // 启动服务
 init(argv);

Copier après la connexion

index.js

8 Code source et tests

Adresse du code source : espérons-. serveur

 const { spawn } = require('child_process');
 const Server = require('./hope');
 
 function init(argv) {
  // 如果配置为子进程开启服务
  if (argv.child) {
   //子进程启动服务
   const child = spawn('node', ['hope.js', JSON.stringify(argv)], {
    cwd: dirname,
    detached: true,
    stdio: 'inherit'
   });
 
   //后台运行
   child.unref();
   //退出主线程，让子线程单独运行
   process.exit(0);
  } else {
   const server = new Server(argv);
   server.start();
  }
 }
 
 module.exports = init;
hope.js
 if (process.argv[2] && process.argv[2].startsWith('{')) {
 const argv = JSON.parse(process.argv[2]);
 const server = new Hope(argv);
 server.start();
 }

Copier après la connexion

Entrez n'importe quel répertoire

npm install hope-server -g

Copier après la connexion

Je pense que vous maîtrisez la méthode après avoir lu le cas dans cet article. Pour des informations plus intéressantes, veuillez prêter attention aux autres articles connexes sur. le site PHP chinois !

Lecture recommandée :