Node.js Installer des paquets


Exemple

introduction

Package est un terme utilisé par npm pour désigner les outils que les développeurs peuvent utiliser pour leurs projets. Cela inclut tout, des bibliothèques et des frameworks tels que jQuery et AngularJS aux exécuteurs de tâches tels que Gulp.js. Les paquets seront fournis dans un dossier généralement appelé node_modules , qui contiendra également un fichier package.json . Ce fichier contient des informations concernant tous les packages, y compris les dépendances, qui sont des modules supplémentaires nécessaires pour utiliser un package particulier.

Npm utilise la ligne de commande pour installer et gérer les packages, de sorte que les utilisateurs essayant d'utiliser npm doivent être familiarisés avec les commandes de base de leur système d'exploitation: parcourir les répertoires et voir le contenu des répertoires.


Installation de NPM

Notez que pour installer des packages, NPM doit être installé.

La méthode recommandée pour installer NPM consiste à utiliser l'un des programmes d'installation de la page de téléchargement de Node.js. Vous pouvez vérifier si vous avez déjà installé node.js en exécutant la commande npm -v ou npm version .

Après avoir installé NPM via le programme d'installation de Node.js, assurez-vous de vérifier les mises à jour. Cela est dû au fait que NPM est mis à jour plus fréquemment que le programme d'installation de Node.js. Pour vérifier les mises à jour, exécutez la commande suivante:

npm install npm@latest -g

Comment installer les paquets

Pour installer un ou plusieurs packages, procédez comme suit:

npm install <package-name>
# or
npm i <package-name>...

# e.g. to install lodash and express
npm install lodash express

Note : Ceci installera le paquet dans le répertoire dans lequel se trouve la ligne de commande, il est donc important de vérifier si le répertoire approprié a été choisi

Si vous avez déjà un fichier package.json dans votre répertoire de travail actuel et que des dépendances y sont définies, alors npm install résoudra et installera automatiquement toutes les dépendances répertoriées dans le fichier. Vous pouvez également utiliser la version abrégée de la commande npm install : npm i

Si vous souhaitez installer une version spécifique d'un package, utilisez:

npm install <name>@<version>

# e.g. to install version 4.11.1 of the package lodash
npm install lodash@4.11.1

Si vous souhaitez installer une version correspondant à une plage de version spécifique, utilisez:

npm install <name>@<version range>

# e.g. to install a version which matches "version >= 4.10.1" and "version < 4.11.1"
# of the package lodash
npm install lodash@">=4.10.1 <4.11.1"

Si vous souhaitez installer la dernière version, utilisez:

npm install <name>@latest

Les commandes ci-dessus rechercheront les paquets dans le dépôt central npm à npmjs.com . Si vous ne souhaitez pas installer depuis le registre npm , d'autres options sont prises en charge, telles que:

# packages distributed as a tarball
npm install <tarball file>
npm install <tarball url>

# packages available locally
npm install <local path>

# packages available as a git repository
npm install <git remote url>

# packages available on GitHub
npm install <username>/<repository>

# packages available as gist (need a package.json)
npm install gist:<gist-id>

# packages from a specific repository
npm install --registry=http://myreg.mycompany.com <package name>

# packages from a related group of packages 
# See npm scope
npm install @<scope>/<name>(@<version>)

# Scoping is useful for separating private packages hosted on private registry from
# public ones by setting registry for specific scope
npm config set @mycompany:registry http://myreg.mycompany.com
npm install @mycompany/<package name>

Généralement, les modules seront installés localement dans un dossier nommé node_modules , qui se trouve dans votre répertoire de travail actuel. C'est le répertoire que require() pour charger les modules afin de les mettre à votre disposition.

Si vous avez déjà créé un fichier package.json , vous pouvez utiliser l' --save ( --save -S ) ou l'une de ses variantes pour ajouter automatiquement le package installé à votre package.json tant que dépendance. Si quelqu'un installe votre paquet, npm lira automatiquement les dépendances du fichier package.json et installera les versions listées. Notez que vous pouvez toujours ajouter et gérer vos dépendances en éditant le fichier ultérieurement. Il est donc recommandé de suivre les dépendances, par exemple en utilisant:

npm install --save <name> # Install dependencies 
# or
npm install -S <name> # shortcut version --save 
# or
npm i -S <name>

Pour installer les packages et les enregistrer uniquement s'ils sont nécessaires au développement, pas pour les exécuter, pas s'ils sont nécessaires à l'exécution de l'application, suivez la commande suivante:

npm install --save-dev <name> # Install dependencies for development purposes
# or
npm install -D <name> # shortcut version --save-dev
# or
npm i -D <name>

Installation de dépendances

Certains modules fournissent non seulement une bibliothèque à utiliser, mais fournissent également un ou plusieurs fichiers binaires destinés à être utilisés via la ligne de commande. Bien que vous puissiez toujours installer ces packages localement, il est souvent préférable de les installer globalement pour que les outils de ligne de commande puissent être activés. Dans ce cas, npm liera automatiquement les fichiers binaires aux chemins appropriés (par exemple /usr/local/bin/<name> ) afin qu'ils puissent être utilisés à partir de la ligne de commande. Pour installer un package globalement, utilisez:

npm install --global <name>
# or
npm install -g <name>
# or
npm i -g <name>

# e.g. to install the grunt command line tool
npm install -g grunt-cli

Si vous souhaitez voir une liste de tous les packages installés et de leurs versions associées dans l'espace de travail actuel, utilisez:

npm list
npm list <name>

L'ajout d'un argument de nom facultatif permet de vérifier la version d'un package spécifique.


Remarque: Si vous rencontrez des problèmes de permission en essayant d'installer un module npm globalement, résistez à la tentation de sudo npm install -g ... un sudo npm install -g ... pour résoudre le problème. Accorder des scripts tiers pour s'exécuter sur votre système avec des privilèges élevés est dangereux. Le problème de la permission peut signifier que vous avez un problème avec la façon dont npm été installé. Si vous êtes intéressé par l'installation de Node dans des environnements utilisateur en bac à sable, vous pouvez essayer d'utiliser nvm .

Si vous disposez d'outils de génération ou d'autres dépendances de développement uniquement (par exemple Grunt), vous ne souhaiterez peut-être pas les regrouper avec l'application que vous déployez. Si tel est le cas, vous voudrez l’avoir comme une dépendance de développement, qui est répertoriée dans le package.json sous devDependencies . Pour installer un package en tant que dépendance de développement uniquement, utilisez --save-dev (ou -D ).

npm install --save-dev <name> // Install development dependencies which is not included in production 
# or
npm install -D <name>

Vous verrez que le paquet est ensuite ajouté aux devDependencies de votre package.json .

Pour installer des dépendances d’un projet node.js téléchargé / cloné, vous pouvez simplement utiliser

npm install
# or
npm i

npm lit automatiquement les dépendances à partir de package.json et les installe.

MNP derrière un serveur proxy

Si votre accès Internet se fait via un serveur proxy, vous devrez peut-être modifier les commandes npm install qui accèdent aux référentiels distants. npm utilise un fichier de configuration qui peut être mis à jour via la ligne de commande:

npm config set

Vous pouvez localiser vos paramètres de proxy depuis le panneau de configuration de votre navigateur. Une fois que vous avez obtenu les paramètres de proxy (URL du serveur, port, nom d'utilisateur et mot de passe); vous devez configurer vos configurations npm comme suit.

$ npm config set proxy http://<username>:<password>@<proxy-server-url>:<port>
$ npm config set https-proxy http://<username>:<password>@<proxy-server-url>:<port>

username , password , port champs de port sont facultatifs. Une fois ces paramètres définis, votre npm install npm i -g , npm i -g etc. fonctionnerait correctement.