Servir des fichiers statiques avec Node

Cet article présente principalement l'utilisation de Node pour fournir des services de fichiers statiques. Il a une certaine valeur de référence. Maintenant, je le partage avec tout le monde. Les amis dans le besoin peuvent s'y référer

Avant-propos

. Pour les applications web, il est souvent nécessaire de servir des fichiers statiques (CSS, JavaScript, images). Cet article explique comment créer votre propre serveur de fichiers statiques.

Créer un serveur de fichiers statiques

Chaque serveur de fichiers statiques possède un 根目录, qui est le répertoire de base qui fournit les services de fichiers. Nous devons donc définir une variable racine sur le serveur que nous nous apprêtons à créer, qui servira de répertoire racine de notre serveur de fichiers statiques :

var http = require('http')
var join = require('path').join
var fs = require('fs')

var root = __dirname

__dirname est une variable magique dans Node, et sa valeur est le chemin d'accès au répertoire où se trouve le fichier. Dans cet exemple, le serveur utilisera le répertoire où se trouve ce script comme répertoire racine des fichiers statiques.

Avec le chemin du fichier, vous devez également transférer le contenu du fichier.
Cela peut être fait avec fs.ReadStream, qui est l'une des classes Stream de Node. Un appel réussi à fs.createReadStream() renvoie un nouvel objet fs.ReadStream.
Le code ci-dessous implémente un serveur de fichiers simple mais entièrement fonctionnel.

var server = http.createServer(function(req, res){
  let path = join(root, req.url)
  let stream = fs.createReadStream(path)
  stream.on('data', function(chunk){
    res.write(chunk)
  })
  stream.on('end', function(){
    res.end()
  })
})

server.listen(3000)

Ce serveur de fichiers fonctionne généralement, mais de nombreux détails doivent être pris en compte. Ensuite, nous devons optimiser la transmission des données et rationaliser le code du serveur.

Utilisez STREAM.PIPE() pour optimiser la transmission des données

Bien que le code ci-dessus semble bon, Node fournit également un mécanisme d'implémentation plus avancé : Stream.pipe(). L'utilisation de cette méthode peut grandement simplifier le code du serveur. Le code optimisé est le suivant :

var server = http.createServer(function(req, res){
  let path = join(root, req.url)
  let stream = fs.createReadStream(path)
  stream.pipe(res)
})

server.listen(3000)

Cette façon d'écrire est-elle plus simple et plus claire ?

Comprendre les flux et les tuyaux

Le flux est un concept très important dans Node Vous pouvez considérer les tuyaux dans Node comme des conduites d'eau si vous voulez une certaine source (comme un chauffe-eau). pour s'écouler Si l'eau s'écoule vers une destination (comme un robinet de cuisine), vous pouvez ajouter un tuyau au milieu pour les connecter, de sorte que l'eau s'écoule le long du tuyau de la source à la destination. La même chose est vraie pour les tuyaux de
Node, mais ce qui y coule n'est pas de l'eau, mais des données de la source (c'est-à-dire ReadableStream), et le pipeline leur permet de « couler » vers une certaine destination (c'est-à-dire WritableStream). Vous pouvez utiliser la méthode pipe pour connecter des tuyaux :

ReadableStream.pipe(WritableStream)

Lire un fichier (ReadableStream) et écrire le contenu dans un autre fichier (WritableStream) à l'aide d'un tube :

let readStream = fs.createReadStream('./original.txt') 
let writeStream = fs.createWriteStream('./copy.txt') 
readStream.pipe(writeStream)

All ReadableStreams peut être connecté à n’importe quel WritableStream. Par exemple, l'objet de requête HTTP (req)
est un ReadableStream, et vous pouvez laisser le contenu circuler dans un fichier :

req.pipe(fs.createWriteStream('./req-body.txt'))

Exécuter

Exécutons maintenant le code ci-dessus , nous mettons une image dans le répertoire racine, comme peiqi.jpg.
Entrez http://127.0.0.1:3000/peiqi.jpg dans le navigateur et constatez que le mignon peiqi est apparu devant vous. peiqi.jpg est envoyé du serveur http au client (navigateur) en tant que corps de réponse.

Bien qu'il ait goûté au succès, ce serveur de fichiers statique n'est pas assez complet car sujet aux erreurs. Imaginez que si l'utilisateur saisit accidentellement une ressource qui n'existe pas, telle que abc.html, le serveur plantera immédiatement. Nous devons donc ajouter un mécanisme de gestion des erreurs à ce serveur de fichiers pour le rendre suffisant 健壮.

Gestion des erreurs du serveur

Dans Node, toutes les classes qui héritent d'EventEmitter peuvent émettre des événements d'erreur. Afin de surveiller les erreurs, enregistrez un gestionnaire d'événements d'erreur (tel que le code suivant) sur fs.ReadStream et renvoyez le code d'état de réponse 500 pour indiquer une erreur interne du serveur :

  stream.on('error', function(err){
    res.statusCode = 500
    res.end('服务器内部错误')
  })

Utilisez fs.stat( ) pour implémenter la gestion des erreurs

Nous pouvons utiliser fs.stat() pour obtenir des informations relatives au fichier si le fichier n'existe pas, fs.stat() mettra ENOENT dans err.code en réponse, et vous pouvez alors renvoyer un code d'erreur 404 indiquant au client que le fichier n'est pas trouvé. Si fs.stat() renvoie d'autres codes d'erreur, vous pouvez renvoyer le code d'erreur générique 500.
Le code refactorisé est le suivant :

var server = http.createServer(function(req, res){
  let path = join(root, req.url)

  fs.stat(path, function(err, stat) {
    if (err) {
      if ('ENOENT' == err.code) {
        res.statusCode = 404
        res.end('Not Found')
      } else {
        res.statusCode = 500
        res.end('服务器内部错误')
      }
    } else { // 有该文件
      res.setHeader('Content-Length', stat.size)
      var stream = fs.createReadStream(path)
      stream.pipe(res)

      stream.on('error', function(err) { // 如果读取文件出错
        res.statusCode = 500
        res.end('服务器内部错误')
      })
    }
  })
})

server.listen(3000)

Remarque

Le serveur de fichiers construit dans cette section est une version simplifiée. Si vous souhaitez placer cela dans un environnement de production, vous devez vérifier plus minutieusement la validité de l'entrée pour empêcher les utilisateurs d'accéder à des parties du contenu via des attaques par traversée de répertoires que vous n'aviez pas l'intention de leur ouvrir.

Résumé

Après avoir lu ceci, je pense que vous êtes intelligent et que vous maîtrisez comment utiliser Node pour créer un serveur statique. Dans le prochain article, je vais vous présenter comment utiliser Node pour. traiter les fichiers téléchargés par les utilisateurs et les stocker sur le serveur.

Ce qui précède représente l'intégralité du contenu de cet article. J'espère qu'il sera utile à l'étude de chacun. Pour plus de contenu connexe, veuillez faire attention au site Web PHP chinois !

Recommandations associées :

Utilisez Node pour traiter les téléchargements de fichiers

Interpréter une partie du code source de Redux via l'écriture ES6

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!