Skip to content

Latest commit

 

History

History
868 lines (539 loc) · 23.6 KB

perlmodinstall.pod

File metadata and controls

868 lines (539 loc) · 23.6 KB
Raw

NAME

perlmodinstall - CPAN モジュールのインストール

DESCRIPTION

モジュールは、再利用可能な Perl コードの基本単位と考えることができます; 詳しくは、perlmod を参照してください。 誰かが世界に役立つと思う Perl コードの塊を作成したら、 https://www.cpan.org/modules/04pause.html に Perl 開発者として登録し、 CPAN にコードをアップロードできるようにします。 CPAN は Comprehensive Perl Archive Network で、 https://www.cpan.org/ でアクセスでき、https://metacpan.org/ で 検索できます。

この文書は、CPAN モジュールをダウンロードして自分のコンピュータに インストールしたい人のためのものです。

PREAMBLE

まず、モジュールがまだシステムにインストールされていないことを 確認しましたか? perl -MFoo -e 1 を試してみてください。 ("Foo" をモジュールの名前に置き換え、 例えば perl -MCGI::Carp -e 1 のようにします。)

エラーメッセージが表示されない場合は、モジュールがあります (エラーメッセージが表示された場合は、モジュールはまだありますが、 そのモジュールがパスにない可能性があります。 パスは perl -e "print qq(@INC)" で表示できます)。 この文書の残りの部分では、そのモジュールは実際に本当に絶対に インストールされておらず、 しかし CPAN 上にはモジュールがあると仮定します。

それで、今あなたは .tar.gz (または、それほど頻繁ではありませんが .zip)で 終わるファイルを持っています。 中においしいモジュールがあることは知っています。 次の四つのステップを踏む必要があります:

DECOMPRESS the file

(ファイルを 伸張 する)

UNPACK the file into a directory

(ファイルをディレクトリに 展開 する)

BUILD the module (sometimes unnecessary)

(モジュールを ビルド する (不要の場合もあります))

INSTALL the module.

(モジュールを インストール する)

ここでは、各オペレーティングシステムに対して各ステップを実行する方法を 説明します。 これは、モジュールに付属している README ファイルと INSTALL ファイルを 読む代わりでは <ありません>!

また、これらの指示は、システムの Perl モジュールのリポジトリにモジュールを インストールするように調整されていることにも注意してください; ただし、モジュールは任意のディレクトリにインストールできます。 例えば、perl Makefile.PL の場合、 /my/perl_directory にインストールするために perl Makefile.PL PREFIX=/my/perl_directory と 置き換えることができます。 次に、Perl プログラムのモジュールを use lib "/my/perl_directory/lib/site_perl"; で使用することもできますし、 場合によっては単に use "/my/perl_directory"; で使用することもできます。 perl -e "print qq(@INC)" と入力したときに表示されるディレクトリに モジュールをインストールするためにスーパーユーザー /root アクセスを 必要とするシステムを使用している場合は、ローカルディレクトリ (ホームディレクトリなど)にモジュールをインストールし、 この方法を使用します。

  • Unix または Unix 風のシステムの場合

    Andreas Koenig の CPAN モジュール (http://www.cpan.org/modules/by-module/CPAN) を使えば、 DECOMPRESS から INSTALL までのステップを自動化することができます。

    A. 伸張

    gzip -d yourmodule.tar.gz でファイルを伸張します。

    ftp://prep.ai.mit.edu/pub/gnu/ から gzip を入手できます。

    または、この手順と次の手順を組み合わせてディスク領域を節約することもできます:

    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 と一緒にインストールすることができますし、 ここで他の手順に煩わされることもありません。 上の「Unix または Linux」セクションにある CPAN の指示も 使えるかもしれません; 試してみてください。 そうでなければ、以下の手順に従わなければなりません。

    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++ などのコンパイラが必要になります。 あるいは、ActiveState からビルド済みの PPM パッケージを ダウンロードすることもできます。 http://aspn.activestate.com/ASPN/Downloads/ActivePerl/PPM/

    新しく作成されたディレクトリに移動し、次のように入力します:

    perl Makefile.PL
nmake test

   D. INSTALL

    そのディレクトリにいる状態で、次のように入力します:

    nmake install

  • OS/2 を使用している場合

    Hobbes (http://hobbes.nmsu.edu/h-browse.php?dir=/pub/os2/dev/emx/v0.9d) から EMX 開発スイートと gzip/tar を入手し、Unix 用の指示に従ってください。

  • VMS を使用している場合

    CPAN からダウンロードする場合は、ファイルを .tar.gz ではなく .tgz 拡張子で保存します。 ファイル名の他のすべてのピリオドはアンダースコアに置き換える必要があります。 たとえば、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 から 入手可能)があることを確認してください。 次に次のように入力してモジュール用の DESIPP.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

    BUILD と INSTALL の手順は Unix の場合と同じです。 いくつかのモジュールは GNU make でより良く動作する Makefile を生成します; これは http://www.mks.com/s390/gnu/ から入手できます。

PORTABILITY

(移植性)

すべてのモジュールがすべてのプラットフォームで 動作するわけではないことに注意してください。 移植性の問題についての詳細は perlport を参照してください。 モジュールがお使いのシステムで動作するかどうかは、 文書を読んで確認してください。 すべてのプラットフォームで「そのままで」動作しないモジュールには、 基本的に三つのカテゴリがあります(重複する可能性もあります):

  • 動作するはずなのに動作しない。 これらは修正する必要があります; 作者に連絡してパッチを書くことを検討してください。

  • コンパイルする必要があるけれども、ターゲットプラットフォームに はすぐに入手できるコンパイラがない。 (これらのモジュールには、通常 .xs または .c ファイルが含まれています。) CPAN やその他の場所で既存のバイナリを見つけることができるかもしれませんし、 あるいはコンパイラを入手して自分でビルドしてみて、他の不運な人々が 使えるようにバイナリをリリースすることもできます。

  • 特定のプラットフォームをターゲットにしたモジュール。 (Win32:: モジュールなど。) モジュールがあなたのものでないプラットフォームをターゲットにしている場合は、 おそらく運がありません。

モジュールがあなたのプラットフォームで 動作するはずなのに期待通りに動作しないか、またはモジュールが あなたのプラットフォームで動作するかどうか分からない場合は、 CPAN Testers をチェックしてください。 必要なモジュールがリストにない場合は、自分でテストして CPAN Testers に知らせたり、CPAN Testers に参加したり、テストを リクエストしたりできます。

https://cpantesters.org/

HEY

このページで提案された変更点がありましたら、お知らせください。 モジュールのインストール方法に関するヘルプを求めるメールを私に 送らないでください。 モジュールは多すぎ、Orwants は少なすぎます; 私はあなたの質問に答えることも、すべての質問に答えることもできません。 モジュールの作成者に問い合わせるか、 オペレーティングシステムの Perl に精通した人に尋ねて、 どれもうまく行かなかった場合は、https://rt.cpan.org/ にチケットを 登録してください。

AUTHOR

Jon Orwant

orwant@medita.mit.edu

Chris Nandor からの貴重な支援、そして Brandon Allbery, Charles Bailey, Graham Barr, Dominic Dunlop, Jarkko Hietaniemi, Ben Holzman, Tom Horsley, Nick Ing-Simmons, Tuomas J. Lukka, Laszlo Molnar, Alan Olsen, Peter Prymmer, Gurusamy Sarathy, Christoph Spalinger, Dan Sugalski, Larry Virden, Ilya Zakharevich からの 価値ある助けと共に。

First version July 22, 1998; last revised November 21, 2001.

COPYRIGHT

Copyright (C) 1998, 2002, 2003 Jon Orwant. All Rights Reserved.

This document may be distributed under the same terms as Perl itself.