Modules Perl

Cette page explique comment installer de nouveaux modules Perl sur votre système à l'aide de Webmin, et comment afficher ou supprimer des modules déjà installés.

Contenu

Introduction aux modules Perl

Le langage de programmation Perl a beaucoup de ses fonctions dans des modules séparés, qui ne sont chargés par les scripts Perl que lorsqu'ils en ont besoin. La distribution standard de Perl comprend de nombreux modules, mais il y en a beaucoup plus disponibles qui peuvent être installés séparément. Les modules existent pour une grande variété d'objectifs, tels que la connexion à des bases de données, la création d'images, l'utilisation de protocoles réseau et l'analyse de formats de données.

Tous les modules Perl ont des noms courts comme GD ou Net::Telnet. Tous ceux qui ont des noms en plusieurs parties séparés par des doubles-virgules font partie d'une famille de modules connexes, qui sont souvent regroupés. Les modules sont distribués dans des fichiers tar.gz qui doivent être extraits et compilés avant de pouvoir être installés. Souvent, un seul fichier de distribution contiendra plusieurs modules qui doivent tous être installés ensemble.

La meilleure source de modules Perl est CPAN (le réseau d'archives complet de Perl ), situé à http://www.cpan.org/. Il dispose d'une vaste base de données de presque tous les modules tiers disponibles et est facilement consultable. Webmin peut installer un module Perl pour vous directement depuis CPAN si vous connaissez le nom du module que vous souhaitez.

Comme Webmin est lui-même écrit en Perl, il peut utiliser certains modules optionnels. Par exemple, pour exécuter Webmin en mode SSL (comme expliqué au chapitre 2), il est nécessaire d'installer le module Net::SSLeay. Pour vous connecter et gérer de manière fiable les bases de données [[MySQL Database}} et PostgreSQL, vous devez installer respectivement les modules DBD::mysql et DBD:Pg.

Modules Perl dans Webmin

Dans la catégorie Autres de Webmin se trouve un module appelé Modules Perl, qui peut être utilisé pour afficher, installer et supprimer des modules Perl de votre système. Lorsque vous y entrez, la page principale répertorie tous les modules actuellement installés, comme indiqué dans l'image ci-dessous. Pour chacun, le nom du module, une courte description, la date d'installation et le nombre de sous-modules sont affichés. Les sous-modules sont le terme de Webmin pour les modules Perl qui sont inclus dans le fichier tar.gz de distribution avec un module principal.

Comme Perl se comporte de la même manière sur toutes les versions d'Unix, ce module Webmin a la même interface utilisateur et les mêmes fonctionnalités sur tous les systèmes d'exploitation. Le seul problème que vous pouvez rencontrer sur les systèmes non-Linux est l'absence d'un compilateur C, qui est souvent nécessaire lors de l'installation de modules Perl. Toutes les versions de Linux incluent le compilateur gcc en standard, mais de nombreuses variantes commerciales d'Unix ne sont pas livrées avec un compilateur C gratuit.

Sélectionnez le module perl à installer

Installer un module Perl

Si vous avez besoin d'installer un nouveau module Perl pour une utilisation par Webmin ou pour développer vos propres scripts, cela peut être fait facilement en utilisant ce module Webmin. Les étapes à suivre sont :

1. Au bas de la page principale du module se trouve le formulaire d'installation. Il offre quatre options pour les types de source à partir desquels installer un module au format de fichier de distribution tar.gz, mais la plus courante et la plus utile est De CPAN . Sélectionnez-le simplement et entrez le nom du module (tel que Net::Telnet) dans le champ de texte adjacent. Si le fichier du module est déjà sur votre système, vous pouvez choisir l'option Depuis le fichier local option et entrez le chemin d'accès au fichier tar.gz dans le champ à côté. Ou si vous avez le fichier sur le système sur lequel vous exécutez votre navigateur, sélectionnez Depuis le fichier téléchargé et sélectionnez-le à l'aide de Parcourir bouton. La source finale à partir de laquelle un module peut être installé est une URL sur un autre serveur. Pour que Webmin le télécharge pour vous, sélectionnez l'option De l'URL ftp ou http option et entrez l'URL dans le champ à côté.
2. Si le De CPAN l'option a été choisie et ce n'est pas le premier module que vous avez installé à partir de cette source, la Actualiser la liste des modules à partir du CPAN la case à cocher à côté du champ du nom du module sera visible. Si cette case est cochée, Webmin téléchargera à nouveau la liste complète des modules et les URL auxquelles ils peuvent être trouvés sur le site Web du CPAN. Sinon, il utilisera un cache local de la liste du téléchargement précédent. La liste des modules doit être retéléchargée périodiquement pour s'assurer que la copie locale reste à jour. Pour cette raison, la case sera cochée par défaut tous les 30 jours, ou quelle que soit la période que vous aurez définie dans la configuration du module Webmin.
3. Lorsque vous avez sélectionné la source, cliquez sur Installer bouton. Cela vous amènera à une page montrant la progression de la liste des modules CPAN téléchargés et le fichier du module lui-même, si nécessaire. Si le module Perl est introuvable sur CPAN ou si le fichier tar.gz sélectionné ne semble pas être au format correct, un message d'erreur approprié s'affichera. Cependant, si le fichier du module a été téléchargé et vérifié avec succès, un formulaire d'options d'installation comme celui de l'image ci-dessous s'affichera.
4. L'action d'installation détermine quelles étapes du processus d'installation du module seront effectuées par Webmin. Les options disponibles sont :

   Faire uniquement

   Le fichier sera extrait, son Makefile généré avec la commande perl Makefile.PL puis la commande make exécutée pour construire les modules qu'il contient. Aucune installation réelle n'aura lieu.

   Fabriquer et tester

   J'aime le Make only mode, mais le module compilé sera également testé avec la commande make test. Presque tous les modules Perl incluent un code de test pour vérifier qu'ils ont été correctement compilés.

   Créer et installer

   Le fichier de module sera extrait, les modules qu'il contient seront construits, puis la commande make install sera exécutée pour copier les fichiers compilés dans les répertoires Perl appropriés de votre système. Une fois installés, les modules seront utilisables par d'autres scripts et programmes Perl (comme Webmin).

   Créer, tester et installer

   Comme le mode *Make and install*, mais la commande make test sera exécutée sur les modules compilés avant qu'ils ne soient installés pour vérifier qu'ils ont été compilés correctement. C'est le mode par défaut, mais pour certains modules, il peut ne pas être approprié si la phase de test est susceptible d'échouer de manière incorrecte.

5. Pour certains modules Perl, des paramètres supplémentaires peuvent avoir besoin d'être passés à la commande perl Makefile.PL pour qu'ils soient construits correctement. Si c'est le cas, vous pouvez les entrer dans les arguments Makefile.PL domaine. Le module Net::SSLeay par exemple nécessite de donner en paramètre le chemin du répertoire OpenSSL, s'il n'a pas été installé dans le répertoire standard. En général cependant, vous n'aurez pas besoin de remplir ce champ.
6. Certains modules Perl nécessitent que certaines variables d'environnement soient définies avant l'exécution de perl Makefile.PL. Si c'est le cas du module que vous tentez d'installer, renseignez le tableau *Variables d'environnement Makefile.PL* avec les noms et les valeurs de celles qui doivent être définies. Le module moyen ne nécessite cependant aucune variable spéciale.
7. Pour que Webmin effectue les étapes de compilation et d'installation choisies à l'étape 4 ci-dessus, cliquez sur Continuer avec l'installation bouton en bas du formulaire. Cela vous amènera à la page montrant chaque commande exécutée pour construire le module, et toute sortie ou message d'erreur qu'elle produit. Ce n'est que si tout est réussi qu'un message du type *Créer, tester et installer Net::SSLeay réussi* apparaîtra au bas de la page. Si quelque chose ne va pas, vérifiez les messages d'erreur pour trouver des indices. De nombreux modules Perl fournissent une interface à certaines bibliothèques C et nécessitent donc que les fichiers d'inclusion de cette bibliothèque soient installés. Sur de nombreuses distributions Linux, ceux-ci se trouvent dans un package différent de la bibliothèque elle-même. Par exemple, Net::SSLeay utilise la bibliothèque OpenSSL C, dont les fichiers d'inclusion se trouvent souvent dans un package openssl-devel séparé. Voir Packages logiciels pour obtenir des instructions sur la façon d'installer des packages sur votre système.
8. En supposant que tout a fonctionné et que vous avez choisi d'installer le module, vous pouvez maintenant revenir à la page principale. Le nouveau module devrait y figurer et sera utilisable dans les scripts et programmes Perl.

Modules perl suggérés

Certaines distributions Linux incluent divers modules Perl au format RPM. Ils doivent être installés à l'aide du module Progiciels, pas celui-ci. Soyez averti que si vous avez mis à jour Perl à partir de la version incluse avec votre distribution, ces RPM ne fonctionneront pas. Pour cette raison, il est presque toujours préférable d'installer les modules Perl à l'aide de ce module Webmin.

Afficher et supprimer un module Perl

La page principale de ce module Webmin affiche tous les modules Perl non essentiels installés sur votre système pour lesquels un fichier .packlist peut être trouvé. Malheureusement, certains modules ne créent pas de fichier .packlist. Des modules comme celui-ci seront toujours utilisables dans les scripts Perl, mais ne peuvent pas être visualisés ou désinstallés par Webmin.

La plupart des modules Perl incluent une documentation sur leur API pour les programmeurs qui souhaitent les utiliser dans des scripts. Pour afficher la documentation d'un module, les étapes à suivre sont :

1. Sur la page principale, cliquez sur le nom du module sous le Module du tableau colonne. Cela vous amènera à une page montrant sa documentation complète, telle que générée par la commande perldoc. Cependant, tous les modules n'ont pas de documentation, donc dans certains cas, aucune ne sera affichée.
2. Si le module a des sous-modules, ils seront également listés. Chacun peut avoir une documentation supplémentaire que vous pouvez consulter en cliquant sur son nom.

Webmin peut également être utilisé pour supprimer des modules Perl de votre système, tant qu'ils ont des fichiers .packlist correctement formatés. Le processus pour supprimer un module est :

1. Sur la page principale, cliquez sur le nom du module pour accéder à la page de documentation.
2. Si le Désinstaller le module et les sous-modules bouton existe, cliquez dessus. Si le bouton n'est pas affiché, alors Webmin ne peut pas supprimer ce module Perl.
3. Une fois que vous avez cliqué sur le bouton, une page listant tous les fichiers qui seront supprimés s'affiche. Pour poursuivre la désinstallation, cliquez sur Désinstaller maintenant bouton en bas de la page de confirmation. Tous les fichiers du module seront supprimés et vous serez renvoyé à la page principale.

Dans les versions récentes de Webmin, les modules Perl installés à partir de RPM ou de Debpackages peuvent également être supprimés en utilisant ce même processus. Le RPM correct sera supprimé, plutôt que Webmin ne supprime les fichiers du module Perl lui-même.

Modules perl existants