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.)

Если сообщение об ошибке не выводится, модуль у вас есть. (Если сообщение об ошибке выводится, возможно, модуль у вас есть, но он не находится в вашем пути, который можно отобразить с помощью 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 или подобной ей,

  Вы можете использовать модуль 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 из оболочки и проверьте, есть ли ваш модуль в репозитории PPM ActiveState. Если да, вы можете установить его с помощью ppm, и вам не придётся выполнять другие шаги. Вы также можете попробовать использовать инструкции CPAN из раздела «Unix или Linux» выше. В противном случае вам придётся выполнить шаги ниже.

  A. DECOMPRESS

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

  B. UNPACK

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

  C. BUILD

  Вам понадобится либо nmake или gmake.

  Требуется ли компиляция модуля (т.е. есть ли у него файлы с расширениями .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

• Если вы работаете в 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.