perlmodinstall

СОДЕРЖАНИЕ

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

НАЗВАНИЕ

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

ОПИСАНИЕ

Модуль можно рассматривать как основную единицу многократно используемого кода Perl; см. perlmod для получения подробностей. Всякий раз, когда кто-то создаёт фрагмент кода Perl, который, по его мнению, будет полезен, он регистрируется как разработчик Perl на http://www.cpan.org/modules/04pause.html, чтобы затем загрузить свой код на CPAN. CPAN — это всеобъемлющая сеть архивов Perl, к которой можно получить доступ по адресу http://www.cpan.org/, и её можно искать по адресу http://search.cpan.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- или Unix-подобную систему,

  Вы можете использовать модуль CPAN Андрэаса Кёнига ( http://www.cpan.org/modules/by-module/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

  Вы можете использовать утилиту Winzip ( http://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. http://search.cpan.org/dist/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 ) или Leo ( http://www.leo.org ), а затем следуйте инструкциям для 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 отличается от пакета Info-ZIP zip/unzip. Первый — это простой инструмент сжатия, а второй позволяет создавать многофайловые архивы.

  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 или запросить его тестирование.

http://testers.cpan.org/

ПРИМЕЧАНИЕ

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

АВТОР

Jon Orwant

orwant@medita.mit.edu

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

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

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

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

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