PerlゼミCPAN - CPANからモジュールインストール
CPANモジュールを使用すればCPANからモジュールインストールすることができます。CPANは無料で利用できるモジュールがたくさん集められたサイトです。CPANモジュールはコマンドラインから利用することが想定されており、cpanコマンドから各種機能を利用することができます。
コマンドラインでcpanコマンドを実行するとモジュールをインストールすることができます。
# モジュールのインストール cpan モジュール名
またcpanシェルと呼ばれる対話的にインストールを行う機能もあります。cpanコマンドに引数を指定しなければcpanシェルが起動します。(ActivePerlでYAMLエラーがでる場合がありますが対処ほうはこちらにあります。)
# cpanシェルの起動 cpan # モジュールのインストール(cpanシェル) install モジュール名
cpanシェルを終了するにはexitコマンドを使用します。
# cpanシェルの終了(cpanシェル) exit
もしcpanを実行するのが始めてであれば、初回起動時にcpanの設定を行う必要があります。たくさんの設定について聞かれるので驚いてしまうかもしれませんが、Enterを押してデフォルトの設定を進めていきましょう。後で設定を変更することもできます。
最近のcpanはすべてを自動で設定してくれるようになっていますが、少し古いものであれば、一部手動で設定しなければならない項目があります。
どのミラーサイトからインストールするかを決める項目です。CPANには世界中にミラーサイトがあるので一番近いミラーサイトを選択しましょう。
# CPANミラーの選択 First, pick a nearby continent and country (you can pick several of each, separated by spaces, or none if you just want to keep your existing selections). Then, you will be presented with a list of URLs of CPAN mirrors in the countries you selected, along with previously selected URLs. Select some of those URLs, or just keep the old list. Finally, you will be prompted for any extra URLs -- file:, ftp:, or http: -- that host a CPAN mirror. (1) Africa (2) Asia <---------これを選択 (3) Australasia (4) Central America (5) Europe (6) North America (7) South America Select your continent (or several nearby continents) [] 2 (1) China (2) Hong Kong (3) Indonesia (4) Israel (5) Japan <----------これを選択 (6) Saudi-Arabia (7) Singapore (8) South Korea (9) Taiwan (10) Thailand Select your country (or several nearby countries) [] 5 (1) ftp://ftp.dti.ad.jp/pub/lang/CPAN/ (2) ftp://ftp.jaist.ac.jp/pub/lang/perl/CPAN/ (3) ftp://ftp.lab.kdd.co.jp/lang/perl/CPAN/ (4) ftp://ftp.meisei-u.ac.jp/pub/CPAN/ (5) ftp://ftp.ring.gr.jp/pub/lang/perl/CPAN/ <----- どれでもよいが今回は5を選択 (6) ftp://mirror.nucba.ac.jp/mirror/Perl/ Select as many URLs as you like [] 5
cpanの設定をやり直したい場合はcpanシェルで「o conf init」コマンドを使用します。
# 設定をやり直す(cpanシェル) o conf init
cpanの設定の変更
cpanの設定を変更するにはcpanシェルを起動してから「o conf」コマンドを使用します。すべての設定値を見るには「o conf」とします。
# すべての設定を見る(cpanシェル) o conf
次のように設定の一覧が表示されます。
# cpanの設定の一覧
applypatch []
auto_commit [0]
build_cache [100]
build_dir [/root/.cpan/build]
.
. (省略)
.
username undef
wait_list undef
wget [/usr/bin/wget]
yaml_load_code [0]
yaml_module [YAML]
設定項目は変更することができます。
# 設定の変更(cpanシェル) o conf build_cache 200
設定した項目はcpanシェルが起動している間だけ有効です。設定を保存するためにはcommitを実行する必要があります。
# 設定の保存(cpanシェル) o conf commit
設定項目がリストの場合はunshift,push,pop,shiftコマンドを利用することもできます。
# 先頭に追加 o conf urllist unshift http://cpan.dev.local/CPAN # 末尾に追加 o conf urllist push http://cpan.dev.local/CPAN # 末尾を削除 o conf urllist pop # 先頭を削除 o conf urllist shift
CPANモジュールのインストールに失敗する場合
CPANモジュールのインストールが失敗することはよくあります。これこれの原因を特定することは難しいですが考えられる状況をいくつか書いておきます。
1. CPANミラーが落ちている
-> urllistの先頭に利用できるCPANミラーを追加する
2. モジュールが巨大なのでモジュールをビルドするために確保しておく領域が足りない
-> build_cache の値を100Mくらいに増やしてみる
3. モジュールがUnix環境しか想定していない。あるいは、Windowsで失敗する試験を含めている。
-> 試験が失敗していることだけが原因であると思うならば、強制的にインストールしてみることもできるが、報告してあげるのが望ましい。
4. XSを含んでいるのがgccコンパイラがないためにインストールできない。
-> gccのパッケージをLinuxの場合であれば、yumやapt-getでgccをインストール、Windowsの場合は5.10.1以降のActivePerlであればMinGWが梱包されておりgcc環境がある。
5. プロキシ接続でしか、インターネットを利用できない環境にある
->企業などのネットワークの場合はプロキシサーバを介してしてインターネットに接続できない場合があるでしょう。その場合にはプロキシを設定することができます。プロキシのドメイン名とポート番号は調べる必要があります。
# プロキシの設定 o conf http_proxy ftp_proxy=http://proxy.you.com:8000/ o conf ftp_proxy http_proxy=http://proxy.you.com:8000/
また外部に対してHTTP接続しか許可されていないのに、urllistにftpのURLが含まれていると接続に失敗してしまいます。下記のURLのどれかをurllistの先頭に含めましょう。
# HTTP接続でインストールする場合 http://ftp.nara.wide.ad.jp/pub/CPAN/ http://ftp.jaist.ac.jp/pub/CPAN/ http://ftp.riken.jp/lang/CPAN/ http://ftp.yz.yamagata-u.ac.jp/pub/lang/cpan/
6. モジュールが他の(Perlではない)ライブラリに依存している
-> たとえばXML::LibXMLはlibxml2というライブラリに依存しています。そのライブラリがインストールされていない場合はCPANでのインストールに失敗します。yumやapt-getなどのコマンドでlibxml2を含むパッケージをインストールする必要があります。
CPANモジュールに関するFAQ
Q. 依存するモジュールをインストールするときに自動的にyesと答えることはできますか。
A. はい。できます。cpanシェルからprerequisites_policyをfollowに設定します。
# 依存するモジュールを自動的にインストール o conf prerequisites_policy follow o conf commit
askを指定するとインストールするかどうかを確認します。ignoreを指定すると依存するモジュールをインストールしません。
Q. CPANミラーのURL一覧が掲載されているサイトはありますか。
A. 下記のサイトになります。
Q. Windowsでもcpanは利用できますか。
A. はいできます。以前はWindowsでcpanを利用するにはmakeコマンドの変わりになるnmakeというコマンドが必要でした。現在では、ActivePerlが5.10.1以降であればMinGWという開発用のツールが梱包されています。これにはmakeコマンドの変わりになるものやCのコンパイラが含まれているので、Windowsでもcpanがうまく利用できるようになりました。
Q. モジュールのインストール履歴を見ることができますか?
A. perllocalというドキュメントにインストール履歴が記録されます。
# インストール履歴を見る perldoc perllocal
次のようにインストール履歴が表示されます。
Tue Jun 8 20:15:01 2010: "Module" Mail::Address::MobileJp
・ "installed into: /usr/lib/perl5/site_perl/5.8.8"
・ "LINKTYPE: dynamic"
・ "VERSION: 0.09"
・ "EXE_FILES: "
Tue Jun 8 20:24:46 2010: "Module" Business::CreditCard
・ "installed into: /usr/lib/perl5/site_perl/5.8.8"
・ "LINKTYPE: dynamic"
・ "VERSION: 0.31"
・ "EXE_FILES: "
Q. インストールされているモジュールの一覧の名前だけが欲しいです。
A. 次のスクリプトを使ってください。ExtUtils::Installedが利用できます。
# インストールされているモジュール名の一覧 use ExtUtils::Installed; print join "\n", ExtUtils::Installed->new->modules;
Q. あたらしい環境にまとめてモジュールをインストールするにはどうすればよいでしょうか。
A. 上記で作成したファイルをcpanに食べさせてください。xargsと組み合わせるとよいでしょう。
# CPANモジュールをまとめてインストールする cat installed.txt | xargs cpan
Q. インストールされているモジュールのディストリビューション名を知りたいです。
A. ディストリビューション名は「ADAMK/DBD-SQLite-1.29.tar.gz」のような
「作者名/モジュール名-バージョン.tar.gz」のような構成になります。
これは「cpan -a」で知ることができます。
# インストールされているモジュールとディストリビューション名の表示 cpan -a
でもこれはたくさんのモジュールの重複があるので、重複をなくすには次のようにします。少し時間がかかります。
cpan -a | awk '{print $4;}' | sort -u
Q. root権限を持っていないのですがcpanを利用したいです。ユーザ領域にインストールすることはできますか?
A. cpanの代わりにcpanmというツールを使うのがよいでしょう。
Q. 確実に他の環境にCPANモジュールをデプロイする方法はありませんか。実務で確実性を求められています。
A. cpanfileというファイルに必要なモジュールを記述してcpanmを使ってインストールするのがよいでしょう。
cpanとcpanmの比較
CPANからモジュールをインストールするコマンドであるcpanとcpanmを比較してみます。
cpan
- 対話型
- モジュールのインストール先はシステムディレクトリが前提
- Perl標準のコマンド
cpanm
- コマンドラインツール
- モジュールのインストール先はユーザーディレクトリ
- 別途インストールが必要
- cpanfileでインストールしたいモジュールを定義可能
業務に役立つPerl
Perlテキスト処理のエッセンス
PerlでポータブルなLinuxファイル管理入門
