perlmodinstall

СОДЕРЖАНИЕ

• ИМЯ
• ОПИСАНИЕ
  • ПРЕДИСЛОВИЕ
• ПЕРЕНОСИМОСТЬ
• ПРИМЕЧАНИЕ
• АВТОР
• АВТОРСКИЕ ПРАВА

ИМЯ

perlmodinstall - Установка модулей CPAN

ОПИСАНИЕ

Модуль можно рассматривать как основную единицу повторно используемого Perl-кода; см. perlmod для подробностей. Всякий раз, когда кто-то создает фрагмент Perl-кода, который, по их мнению, будет полезен миру, они регистрируются как разработчик Perl на https://www.cpan.org/modules/04pause.html, чтобы затем загрузить свой код на CPAN. CPAN — это всеобъемлющая сеть архивов Perl, доступная по адресу https://www.cpan.org/ и поисковая система https://metacpan.org/.

Данная документация предназначена для людей, которые хотят загрузить модули CPAN и установить их на свой компьютер.

ПРЕДИСЛОВИЕ

Сначала, вы уверены, что модуль еще не установлен на вашей системе? Попробуйте perl -MFoo -e 1. (Замените "Foo" на имя модуля; например, perl -MCGI::Carp -e 1.)

Если вы не видите сообщение об ошибке, модуль у вас есть. (Если вы видите сообщение об ошибке, возможно, модуль у вас есть, но он не в вашей переменной среды PATH, которую вы можете отобразить с помощью perl -e "print qq(@INC)".) В остальной части этой документации мы будем исходить из того, что у вас действительно нет установленного модуля, но вы нашли его на CPAN.

Итак, теперь у вас есть файл с расширением .tar.gz (или, реже, .zip). Вы знаете, что внутри находится вкусный модуль. Вам теперь необходимо выполнить четыре шага:

РАСПАКОВКА файла

ИЗВЛЕЧЕНИЕ файла в каталог

КОМПИЛЯЦИЯ модуля (иногда не требуется)

УСТАНОВКА модуля.

Вот как выполнить каждый шаг для каждой операционной системы. Это НЕ заменяет чтение файлов README и INSTALL, которые могли поставляться с вашим модулем!

Также обратите внимание, что эти инструкции предназначены для установки модуля в хранилище Perl-модулей вашей системы, но вы можете установить модули в любой каталог. Например, там, где я говорю perl Makefile.PL, вы можете заменить perl Makefile.PL PREFIX=/my/perl_directory для установки модулей в каталог /my/perl_directory. Затем вы можете использовать модули из своих Perl-программ с use lib "/my/perl_directory/lib/site_perl"; или иногда просто use "/my/perl_directory";. Если ваша система требует доступа суперпользователя/root для установки модулей в каталоги, которые вы видите, когда печатаете perl -e "print qq(@INC)", вы должны установить их в локальный каталог (например, в свой домашний каталог) и использовать этот подход.

• Если вы работаете на системе Unix или подобной Unix,

  Вы можете использовать модуль CPAN Андрея Кёнига ( https://metacpan.org/release/CPAN ), чтобы автоматизировать следующие шаги: от РАСПАКОВКИ до УСТАНОВКИ.

  A. РАСПАКОВКА

  Распакуйте файл с помощью gzip -d yourmodule.tar.gz

  Вы можете получить gzip от ftp://prep.ai.mit.edu/pub/gnu/

  Или вы можете объединить этот шаг со следующим, чтобы сэкономить место на диске:

  gzip -dc yourmodule.tar.gz | tar -xof -

  B. ИЗВЛЕЧЕНИЕ

  Извлеките результат с помощью tar -xof yourmodule.tar

  C. КОМПИЛЯЦИЯ

  Перейдите в только что созданный каталог и введите:

  perl Makefile.PL
  make test

  или

  perl Makefile.PL PREFIX=/my/perl_directory

  чтобы установить его локально. (Помните, что в этом случае вам нужно будет поместить use lib "/my/perl_directory"; в начало программы, которая должна использовать этот модуль.)

  D. УСТАНОВКА

  Находясь в этом каталоге, введите:

  make install

  Убедитесь, что у вас есть соответствующие разрешения для установки модуля в каталог вашей Perl 5 библиотеки. Часто вам потребуется доступ root.

  Это все, что нужно сделать на системах Unix с динамической подгрузкой. Большинство систем Unix используют динамическую подгрузку. Если ваша система не использует динамическую подгрузку или по другой причине у вас статически связанный Perl, и модуль требует компиляции, вам потребуется создать новую двоичную программу Perl, включающую модуль. Снова, вам, вероятно, потребуется доступ root.

• Если вы используете ActivePerl (Win95/98/2K/NT/XP, Linux, Solaris),

  Сначала введите ppm из командной строки и посмотрите, содержит ли хранилище ActiveState PPM ваш модуль. Если да, вы можете установить его с помощью ppm и вам не придется выполнять другие шаги. Возможно, вы сможете использовать инструкции CPAN из раздела "Unix или Linux" выше; попробуйте. В противном случае, вам придется выполнить следующие шаги.

  A. DECOMPRESS

  Для распаковки и извлечения модулей можно использовать бесплатный 7-Zip ( https://www.7-zip.org/ ) или утилиту WinZip ( https://www.winzip.com ).

  B. UNPACK

  Если вы использовали WinZip, это уже было сделано за вас.

  C. BUILD

  Вам понадобится утилита nmake , доступная по адресу http://download.microsoft.com/download/vc15/Patch/1.52/W95/EN-US/nmake15.exe или dmake, доступная на CPAN. https://metacpan.org/release/dmake

  Требует ли модуль компиляции (то есть содержит ли он файлы с расширением .xs, .c, .h, .y, .cc, .cxx или .C)? Если да, вам придется самостоятельно скомпилировать модуль (на Windows это нелегко). Вам понадобится компилятор, такой как Visual C++. Кроме того, вы можете загрузить предварительно собранный пакет PPM с ActiveState. http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/

  Перейдите в только что созданный каталог и введите:

     perl Makefile.PL
     nmake test
  
  
  D. INSTALL

  Находясь в этом каталоге, введите:

  nmake install

• Если вы используете DJGPP для DOS,

  A. DECOMPRESS

  djtarx ( ftp://ftp.delorie.com/pub/djgpp/current/v2/ ) одновременно распакует и извлечёт.

  B. UNPACK

  См. выше.

  C. BUILD

  Перейдите в только что созданный каталог и введите:

  perl Makefile.PL
  make test

  Вам потребуются пакеты, указанные в файле README.dos в пакете Perl.

  D. INSTALL

  Находясь в этом каталоге, введите:

  make install       

  Вам потребуются пакеты, указанные в файле README.dos в пакете Perl.

• Если вы используете OS/2,

  Получите комплект разработки EMX и gzip/tar от Hobbes ( http://hobbes.nmsu.edu/h-browse.php?dir=/pub/os2/dev/emx/v0.9d ), а затем следуйте инструкциям для Unix.

• Если вы используете VMS,

  При загрузке с CPAN сохраните свой файл с расширением .tgz вместо .tar.gz. Все остальные точки в имени файла должны быть заменены подчёркиваниями. Например, Your-Module-1.33.tar.gz нужно загружать как Your-Module-1_33.tgz.

  A. РАСПАКОВКА

  Введите

  gzip -d Your-Module.tgz

  Или, для архивов zip, введите

  unzip Your-Module.zip

  Исполняемые файлы gzip, zip и VMStar:

  http://www.hp.com/go/openvms/freeware/

  и их исходный код:

  http://www.fsf.org/order/ftp.html

  Обратите внимание, что GNU gzip/gunzip отличается от пакета zip/unzip от Info-ZIP. Первый — это простой инструмент сжатия; второй позволяет создавать многофайловые архивы.

  B. ИЗВЛЕЧЕНИЕ

  Если вы используете VMStar:

  VMStar xf Your-Module.tar

  Или, если вы предпочитаете синтаксис команд VMS:

  tar/extract/verbose Your_Module.tar

  C. КОМПИЛЯЦИЯ

  Убедитесь, что у вас есть MMS (от Digital) или бесплатный MMK (доступный на сайте MadGoat по адресу http://www.madgoat.com). Затем введите эту команду для создания DESCRIP.MMS для модуля:

  perl Makefile.PL

  Теперь вы готовы к компиляции:

  mms test

  Замените mmk на mms выше, если вы используете MMK.

  D. УСТАНОВКА

  Введите

  mms install

  Замените mmk на mms выше, если вы используете MMK.

• Если вы используете MVS,

  Вставьте файл .tar.gz в HFS как двоичный файл; не переводите из ASCII в EBCDIC.

  A. РАСПАКОВКА

  Распакуйте файл с помощью gzip -d yourmodule.tar.gz

  Вы можете получить gzip по адресу http://www.s390.ibm.com/products/oe/bpxqp1.html

  B. ИЗВЛЕЧЕНИЕ

  Извлеките результат с помощью

  pax -o to=IBM-1047,from=ISO8859-1 -r < yourmodule.tar

  Шаги КОМПИЛЯЦИИ и УСТАНОВКИ аналогичны шагам для Unix. Некоторые модули генерируют файлы Make, которые лучше работают с GNU make, доступным по адресу http://www.mks.com/s390/gnu/

ПЕРЕНОСИМОСТЬ

Обратите внимание, что не все модули будут работать на всех платформах. См. perlport для получения дополнительной информации о проблемах переносимости. Прочитайте документацию, чтобы узнать, будет ли модуль работать на вашей системе. Существует три основных категории модулей, которые не будут работать "из коробки" на всех платформах (с некоторым возможным перекрытием):

• Те, которые должны работать, но не работают. Их нужно исправить; рассмотрите возможность связаться с автором и, возможно, написать исправление.

• Те, которые требуют компиляции, где на целевой платформе нет доступных компиляторов. (Эти модули содержат файлы .xs или .c, как правило.) Возможно, вы сможете найти готовые двоичные файлы на CPAN или где-либо ещё, или вы можете попробовать получить компиляторы и скомпилировать их самостоятельно, а затем выпустить двоичные файлы для других людей.

• Те, которые ориентированы на определённую платформу. (Например, модули Win32::.) Если модуль предназначен для платформы, отличной от вашей, скорее всего, вы не сможете его использовать.

Проверьте CPAN Testers, если модуль должен работать на вашей платформе, но он не работает так, как ожидалось, или вы не уверены, будет ли модуль работать на вашей платформе. Если нужный вам модуль там не указан, вы можете протестировать его самостоятельно и сообщить об этом CPAN Testers, присоединиться к CPAN Testers или запросить его тестирование.

https://cpantesters.org/

ПРИМЕЧАНИЕ

Если у вас есть предложения по улучшению этой страницы, сообщите мне. Пожалуйста, не присылайте мне письма, прося помощи в установке ваших модулей. Модулей слишком много, а Орвантов слишком мало, чтобы я мог ответить или даже признать все ваши вопросы. Обратитесь к автору модуля, спросите у кого-то, кто знаком с Perl на вашей операционной системе, или, в крайнем случае, откройте тикет на https://rt.cpan.org/.

АВТОР

Джон Орвант

orwant@medita.mit.edu

с неоценимой помощью Криса Нандора и ценной помощью Брэндона Оллбери, Чарльза Бейли, Грэма Барра, Доминика Данлопа, Яркко Хietaniemi, Бена Холцмана, Тома Хорсли, Ника Инг-Симмонса, Туомаса Ю. Лукка, Ласло Молнар, Алана Олсена, Питера Прайммера, Гурусами Сарати, Кристофа Спалингера, Дэна Сугальского, Ларри Вирдена и Илья Захаревич.

Первая версия 22 июля 1998 г.; последняя редакция 21 ноября 2001 г.

АВТОРСКИЕ ПРАВА

Авторские права (C) 1998, 2002, 2003 Джон Орвант. Все права защищены.

Этот документ может быть распространен на тех же условиях, что и сам Perl.