Avez-vous une question? (216) 97 656 803 hajjriadh@gmail.com
Laravel

Installer et gérer des paquets avec npm (versions, package-lock, audit)

Cette leçon apprend à gérer les dépendances d'un projet avec npm : installer un paquet, plusieurs paquets, une version précise ou une dépendance de développement ; lire les plages de versions ^, ~ et ...

0 chapitres 0 QCM Accès gratuit
Dans cet article

À propos de ce cours

Cette leçon apprend à gérer les dépendances d'un projet avec npm : installer un paquet, plusieurs paquets, une version précise ou une dépendance de développement ; lire les plages de versions ^, ~ et les versions exactes, y compris le cas des versions 0.x. Elle explique le rôle du fichier package-lock.json, la différence entre npm install et npm ci, puis les commandes npm ls, npm view, npm outdated (colonnes Current, Wanted et Latest), npm update, npm uninstall et npm audit, avec un vrai rapport de sécurité commenté. Deux activités corrigées (lire des plages, cycle de vie complet d'une dépendance) et un quiz terminent la leçon.
  1. Objectifs

    • Installer, mettre à jour et supprimer des paquets dans un projet.
    • Lire les plages de versions : ^, ~, version exacte.
    • Comprendre le rôle de package-lock.json et la différence entre npm install et npm ci.
    • Surveiller les mises à jour avec npm outdated et la sécurité avec npm audit.
  2. Installer des paquets

    • Toutes les commandes se lancent dans le dossier du projet, là où se trouve package.json.
    CommandeEffet
    npm install dayjs (ou npm i dayjs)Installe la dernière version et l'ajoute dans dependencies
    npm install express dayjsInstalle plusieurs paquets en une commande
    npm install -D nodemonInstalle un outil de développement dans devDependencies
    npm install dayjs@1.11.10Installe une version précise
    npm install express@4Installe la dernière version de la branche 4
    npm install -E dayjsEnregistre la version exacte, sans ^
    npm installInstalle tout ce que listent package.json et package-lock.json (après un git clone, par exemple)
    npm install --omit=devInstalle seulement les dépendances de production
    • Après une installation, npm affiche un résumé, par exemple added 1 package, and audited 2 packages in 1s. Le nombre de paquets ajoutés est souvent plus grand que ce que vous avez demandé : npm installe aussi les dépendances des dépendances. Ainsi, nodemon seul ajoute une trentaine de paquets dans node_modules.
  3. Les numéros de version et les plages

    • Les paquets suivent le versionnage sémantique MAJEUR.MINEUR.CORRECTIF. Dans package.json, chaque dépendance n'indique pas une version, mais une plage de versions acceptées :
    • Versionnage sémantique : MAJEUR.MINEUR.CORRECTIF et les plages ^, ~ et version exacte
    ÉcritureVersions acceptéesUsage
    "^1.11.10"de 1.11.10 à moins de 2.0.0: nouveaux correctifs et nouvelles fonctionnalitésValeur par défaut de npm install
    "~1.11.10"de 1.11.10 à moins de 1.12.0: correctifs seulementPrudence sur un paquet sensible
    "1.11.10"exactement 1.11.10Version figée (-E)
    ">=18", "*"toute version supérieure ou égale ; n'importe quelle versionRare pour les dépendances, courant dans engines
    • Attention au cas des versions 0.x: tant qu'un paquet n'a pas atteint 1.0.0, ^0.4.2 n'accepte que les versions 0.4.x, car chaque version mineure peut casser la compatibilité.
    • Pour vérifier une plage, le site semver.npmjs.com liste les versions d'un paquet qu'elle accepte.
  4. Le fichier package-lock.json

    • Une plage comme ^1.11.10 pose un problème : aujourd'hui elle installe 1.11.23, dans six mois peut-être 1.12.0. Deux développeurs pourraient donc avoir des versions différentes du même paquet.
    • package-lock.json règle ce problème : npm y note la version exacte installée de chaque paquet, y compris les dépendances des dépendances, avec l'adresse du téléchargement et une empreinte de contrôle (integrity). Extrait réel :
    "node_modules/dayjs": {
      "version": "1.11.23",
      "resolved": "https://registry.npmjs.org/dayjs/-/dayjs-1.11.23.tgz",
      "integrity": "sha512-QDTCU0M0MxR3hQfnlDJfwekQiaanm1ubOD231u73WBckQ/fsamw...",
      "license": "MIT"
    }
  5. Ce fichier est généré et mis à jour par npm : on ne le modifie jamais à la main, mais on le versionne dans Git.
  6. Deux commandes l'utilisent différemment :
  7. npm installnpm ci
    UtilisationDéveloppement courantServeur d'intégration continue, déploiement
    package-lock.jsonLe respecte, mais peut le mettre à jourLe respecte strictement, ne le modifie jamais
    node_modulesComplète l'existantLe supprime puis le recrée entièrement
    Si les deux fichiers ne concordent pasCorrige le lockS'arrête avec une erreur
  8. Lister et inspecter les paquets

    • npm ls --depth=0 affiche les paquets installés directement par le projet :
    demo@1.0.0 /home/riadh/demo
    +-- dayjs@1.11.23
    `-- nodemon@3.1.14
  9. npm ls nom explique pourquoi un paquet est présent (qui en dépend), npm view nom versions liste toutes les versions publiées, et npm view nom version donne la dernière.
  10. Mettre à jour les paquets

    • npm outdated compare les versions installées avec le registre :
    Package  Current   Wanted   Latest  Location            Depended by
    dayjs    1.11.10  1.11.23  1.11.23  node_modules/dayjs  demo
  11. Current est la version installée, Wanted la plus récente autorisée par la plage de package.json, et Latest la dernière publiée. Si la commande n'affiche rien, tout est à jour.
  12. npm update installe les versions Wanted: elle reste dans la plage et ne franchit jamais une version majeure. Elle met à jour package-lock.json et la plage de package.json.
  13. Pour passer à une nouvelle version majeure, on le fait explicitement, après avoir lu les notes de version du paquet : npm install express@latest.
  14. Supprimer un paquet

    • npm uninstall dayjs (ou npm rm dayjs) supprime le paquet de node_modules, de package.json et de package-lock.json.
    • Supprimer un dossier dans node_modules à la main ne suffit pas : le paquet resterait déclaré et reviendrait au prochain npm install.
    • En cas de comportement étrange, la réinstallation complète règle la plupart des problèmes : supprimer node_modules, puis lancer npm install.
  15. La sécurité avec npm audit

    • npm audit compare les versions installées avec une base de failles de sécurité connues. Exemple réel sur un projet qui utilise nodemon :
    # npm audit report
    
    minimatch  7.0.0 - 11.0.0
    Severity: moderate
    minimatch has potential denial of service via globparts amplification
    fix available via `npm audit fix --force`
    Will install nodemon@3.1.11, which is a breaking change
    node_modules/minimatch
      nodemon  >=3.1.12
      Depends on vulnerable versions of minimatch
  16. Le rapport indique le paquet fautif (minimatch, une dépendance indirecte), la gravité (low, moderate, high, critical) et la correction proposée.
  17. npm audit fix applique les corrections compatibles avec les plages. npm audit fix --force peut changer de version majeure, voire revenir en arrière comme ici : on ne l'utilise qu'après avoir lu le rapport. Une faille dans un outil de développement comme nodemon est aussi moins grave qu'une faille dans une dépendance de production.
  18. Activité 1 : lire des plages de versions

    • Pour chaque plage, indiquez si la version proposée est acceptée.
    PlageVersionAcceptée ?
    ^4.18.24.21.0?
    ^4.18.25.0.0?
    ~4.18.24.19.0?
    ~4.18.24.18.9?
    ^0.4.20.5.0?
    4.18.24.18.3?
      Voir le corrigé
      1. Oui : ^ accepte les nouvelles versions mineures tant que la majeure reste 4.
      2. Non : 5.0.0 change la version majeure.
      3. Non : ~ n'accepte que les correctifs de 4.18.
      4. Oui : c'est un correctif de 4.18.
      5. Non : pour les versions 0.x, ^0.4.2 reste dans 0.4.x.
      6. Non : sans symbole, seule la version exacte 4.18.2 est acceptée.
  19. Activité 2 : cycle de vie d'une dépendance

    • Dans un nouveau projet cycle:
      1. installez l'ancienne version dayjs@1.11.10;
      2. vérifiez avec npm outdated qu'une mise à jour existe, puis appliquez-la ;
      3. contrôlez la version installée et la plage écrite dans package.json;
      4. supprimez node_modules, puis réinstallez avec npm ci;
      5. désinstallez dayjs et vérifiez package.json.
    • Voir le corrigé
      mkdir cycle && cd cycle
      npm init -y
      npm install dayjs@1.11.10      # package.json : "dayjs": "^1.11.10"
      npm outdated                   # Current 1.11.10, Wanted et Latest 1.11.23
      npm update
      npm ls --depth=0               # dayjs@1.11.23
      npm pkg get dependencies       # "dayjs": "^1.11.23"
      rm -rf node_modules            # sous Windows : rmdir /s /q node_modules
      npm ci                         # réinstalle exactement les versions du lock
      npm uninstall dayjs
      npm pkg get dependencies       # {} : la dépendance a disparu

      Les numéros affichés dépendent de la date de l'exercice. L'étape 4 montre que package-lock.json suffit à reconstruire node_modules à l'identique.

  20. À retenir

    • npm install nom ajoute une dépendance ; -D pour le développement ; nom@version pour une version précise.
    • ^ accepte mineures et correctifs, ~ seulement les correctifs, une version sans symbole est figée.
    • package-lock.json fige les versions exactes : il se versionne et ne se modifie pas à la main. npm ci le respecte strictement.
    • npm outdated puis npm update pour les mises à jour sans risque ; une version majeure s'installe explicitement.
    • npm uninstall supprime proprement ; npm audit signale les failles connues.
  21. Testez-vous

    • 1. Quelle est la différence entre ^2.3.1 et ~2.3.1?
    • 2. Faut-il ajouter package-lock.json au .gitignore?
    • 3. Pourquoi npm update n'installe-t-il pas Express 5 dans un projet qui a "express": "^4.21.0"?
    • 4. Quand utiliser npm ci plutôt que npm install?
    • Voir les réponses
      1. ^2.3.1 accepte jusqu'à 3.0.0 non compris ; ~2.3.1 jusqu'à 2.4.0 non compris.
      2. Non : il doit être versionné pour que tout le monde installe exactement les mêmes versions.
      3. Parce que la plage ^4.21.0 exclut les versions 5.x, qui peuvent casser la compatibilité.
      4. Pour une installation reproductible et stricte : intégration continue, déploiement, ou après un git clone quand on veut exactement l'environnement du lock.

Cet article vous a-t-il aidé ?