Premiers pas avec express

Hello World App, utilisant ExpressJS 4 et Node >= 4 #

Préface #

Vous aurez besoin de node >= 4 et express 4 pour ce projet. Vous pouvez obtenir la dernière distribution node à partir de [leur page de téléchargement] (https://nodejs.org/en/download/).

Avant ce didacticiel, vous devez initialiser votre projet de nœud en exécutant

$ npm init

à partir de la ligne de commande et en remplissant les informations souhaitées. Notez que vous pouvez modifier les informations à tout moment en modifiant le fichier package.json.

#Mise en place

Installez express avec npm :

$ npm install --save express

Après avoir installé Express en tant que module de nœud, nous pouvons créer notre point d’entrée. Cela devrait être dans le même répertoire que notre package.json

$ touch app.js

Contenu du répertoire #

Le dossier doit avoir la structure de répertoires suivante :

<project_root>
 |-> app.js
 |-> node_modules/
 '-> package.json

code #

Ouvrez app.js dans votre éditeur préféré et suivez ces quatre étapes pour créer votre première application Express :

// 1. Import the express library.
import express from 'express';

// 2. Create an Express instance.
const app = express();

// 3. Map a route. Let's map it to "/", so we can visit "[server]/".
app.get('/', function(req, res) {
   res.send('Hello World');
});

// 4. Listen on port 8080
app.listen(8080, function() {
   console.log('Server is running on port 8080...');
});

Exécution #

Depuis le répertoire du projet, nous pouvons exécuter notre serveur à l’aide de la commande

$ node app.js

Vous devriez voir le texte

$ Our Express App Server is listening on 8080...

Maintenant, visitez http://localhost:8080/ et vous verrez le texte “Hello World!”

Félicitations, vous avez créé votre première application Express !

Installation #

Express JS est le framework incontournable pour développer des Applications Web, des API et presque tous les types de Backend utilisant Node.

Pour installer express, il vous suffit d’exécuter la commande npm

npm install express --save

Et tu as fini.

Pour créer et exécuter un nouveau serveur express #

créez un fichier app.js et ajoutez ce code

// require express
var express = require('express');
var app = express();

// when "/" is opened in url, this function will be called.
app.get('/', function (req, res) {
  res.json({ code: 200, message: 'success' });
})

app.listen( 3000, function () {
  console.log('Express server running at http://localhost:3000');
});

• Dans votre terminal, lancez node app.js et
• Ouvrez l’URL http://localhost:3000 dans le navigateur Web pour voir votre serveur express nouvellement créé.

C’est aussi une bonne idée d’installer body-parser et express-session avec express car la plupart du temps, vous voudrez lire les données envoyées dans la requête POST et gérer les sessions utilisateur.

• [analyseur de corps sur github][1]
• [session express sur github ][2]

[1] : https://github.com/expressjs/body-parser [2] : https://github.com/expressjs/session

Démarrer une application avec le générateur Express #

Pour démarrer rapidement avec Express, vous pouvez utiliser le générateur Express qui créera pour vous un squelette d’application.

Tout d’abord, installez-le globalement avec npm :

npm install express-generator -g

Vous devrez peut-être mettre sudo avant cette commande si vous obtenez une erreur “autorisation refusée”.

Une fois le générateur installé, vous pouvez démarrer un nouveau projet comme celui-ci :

express my_app

La commande ci-dessus créera un dossier appelé my_app avec un fichier package.json, un fichier app.js et quelques sous-dossiers comme bin, public, routes, views.

Accédez maintenant au dossier et installez les dépendances :

cd first_app
npm install

Si vous êtes sous Linux ou macOS, vous pouvez démarrer l’application comme ceci :

DEBUG=myapp:* npm start

Ou, si vous êtes sous Windows :

set DEBUG=myapp:* & npm start

Maintenant, chargez http://localhost:3000/ dans votre navigateur Web et vous devriez voir les mots “Welcome to Express”.

[1] : http://localhost:3000/

Création d’une application EJS #

a@coolbox:~/workspace$ express --ejs my-app
a@coolbox:~/workspace$ cd my-app
a@coolbox:~/workspace/my-app$ npm install
a@coolbox:~/workspace/my-app$ npm start