インストール
Apache::ASP のインストールは、perl、Apache、および、Unixシステムのインストール経験がものをいいます。こうした経験がないなら、学習曲線(慣れる事)が大事であることを理解して下さい。でも、その結果、あなたを待ち受けてるのは、優れたオープン・ソース・ソフトウェア上で動作しているウェブ・サイトであることでしょう。
Windowsオペレーティング・システムへのインストールは、Win32インストール セクションを見てください。
必要な手助け
Apacheサーバーへのmod_perlインストールは、最も難しい部分の事が、しばしば、あります。こうしたケースに出会ったら、このセクションの「Apache構築」ノートを見るとともに、より詳しいヘルプを得るため、FAQとサポートセクションをよく調べて下さい。
同じように、mod_perl プロジェクトを扱う前に、http://perl.apache.org/guide にある、mod_perl ガイドを精読すべきです。
ダウンロードと CPAN のインストール
最新の Apache::ASP は、最も近い CPAN サイトや、次の URL でダウンロードできます。
http://cpan.org/modules/by-module/Apache/
ftp://ftp.duke.edu/pub/perl/modules/by-module/Apache/
あなたが、Perl ユーザなら、CPAN.pm モジュールで、Apache::ASP のインストールと関連した他のモジュールを使い慣れてください。Perl からの、初めて行う、Apache::ASP のインストールのいちばん簡単な方法は、CPAN シェルで次のように、タイプすることです。
shell prompt> perl -MCPAN -e shell
...
cpan> install Bundle::Apache::ASP
一連のファイルのインストールで、Apache::ASP そのものを含めて必要なすべてのモジュールを自動的にインストールします。ここでトラブルがあるようなら、必要なモジュールを次のように、(cpanシェルで)一つづつインストールしてください。
cpan> install Data::Dumper
cpan> install MLDBM
cpan> install MLDBM::Sync
cpan> install Digest::MD5
cpan> install Apache::ASP
Version 2.31 以降の Apache::ASP で、
FormFill、 XSLT、 ないし SSI を
サポートするような、特別/オプションの関数は、
CPAN 経由で、Bundle(一束)としてインストール可能です。
cpan> install Bundle::Apache::ASP::Extra
通常のPerl モジュールのインストール
CPAN でのインストールを使わないなら、Apache::ASP のダウンロードとインストールは、make か nmake コマンドで以下のようにします。または、ASP.pm を $PERLLIB/site/Apache に直接コピーします。
> perl Makefile.PL
> make
> make test
> make install
* win32 環境では、nmake を使ってください。
Apache ウェブサーバ
とmod_perl を、ウェブサーバ環境でこれらのモジュールを使う前に、インストールしなければならない事に留意してください。また、静的なHTML 構築でのオフラインモードでは、./cgi/asp ディレクトリで、Perl を使えるようにしてください。
Win32 / Windows でのインストール
WinNT か Windows 2000のような、Win32 プラットフォームなら、
http://perl.apache.org/distributions.html
から、win32 バイナリをダウンロードできます。
以下のサイトから、
ftp://theoryx5.uwinnipeg.ca/pub/other/
mod_perl のバイナリでのインストールと、最新の、perl-win32-bin-*.exe 実行ファイルをインストールする事を推奨します。
Randy Kobes 氏には、善意でコンパイルした perl, mod_perl, apache, mod_sslと、Apache::ASP で必要なすべてのモジュールと、Apache::ASP そのものも提供していただきました。
コンパイラなしで最新の Apache::ASP にアップグレードするには、最新版の、Apache::ASP をダウンして、旧版で作られた、perl ライブラリの、ASP.pm を置き換えてください。Apache::ASP は、純粋に、perlで書かれているので、インストール時には、コンパイルする必要はありません。
WinME / 98 / 95 での flock() 回避
これらの Windows オペーレションシステムでは、flock() がサポートされていないので、Apache::ASP v2.25 以降で、mod_perl のインストール後に、Apache の httpd.conf に次のように追加し、調整してください。
<Perl>
*CORE::GLOBAL::flock = sub { 1 };
</Perl>
この設定は、Apache::ASP が、
PerlModule ないし PerlRequire 宣言を介して、
読み込まれる前に、追加 を行うようにしてください。
DSO としてのLinux ディストリビューション
RedHat Linux サーバなどLinux 環境で、RPM を使って、
Apache + mod_perlをインストールしているなら、httpd サーバを、DSO ではなく、スタティック(静的)に、構築するよう、強く推奨します。
DSO は、mod_perl では、まだ実験的で、しばしば、うまく稼動せず、
"no request object" というエラーメッセージが出るほかに、
予測しがたい動作になり、デバック困難であることは、よくある話です。
Apache と mod_perl の構築
Apache をてっとり早く構築するためのスクリプトが配布されています。./make_httpd/build_httpds.sh は、ソースコンパイルし、
Apache を、スタティック(静的)に、mod_ssl と mod_perlをリンクします。
ソースファイルを、make_httpd ディレクトリに入れ、動作環境を、適切に設定し、次のようにスクリプトを実行させます。
make_httpd> ./build_httpds.sh
これらの作業に役に立つサイトが2つあります。
Stas氏の mod_perl インストールガイドセクション
Apache ツールボックス
Apache ツールボックスを使うと、さまざまな要素を自動的にインストールできるので非常にうまくゆきます。
クイックスタート
Apache Web サーバとmod_perl が構築できたら、
(元のソースの) Apache::ASP から ./site/eg/ ディレクトリを、Apache のドキュメントツリーにコピーし、試してみてください。 httpd.conf の、<Directory> 設定のセクションに、"AllowOverride All" を書き込むと、./site/eg での .htaccess ファイルでインストールしたディレクトリが (Apache::ASPとして)動作するようになります。
Apache::ASP 動作の設定状況は、./site/eg/ ディレクトリの .htaccess ファイルです。
Apache の httpd.conf ファイルで、./site/eg でのスクリプト動作のための設定は次の通りです。
<Directory / >
Options FollowSymLinks
AllowOverride All
</Directory>
実例を含む、site を完全な形で、コピーするには、そのまま、
shell> cp -rpd ./site $DOCUMENT_ROOT/asp
としてください。
それで、あなたのサイトでは、Apache::ASP ドキュメントを /asp/ で、
実例を /asp/eg/ で参照できます。
これは。良好な設定例ではありません。
FollowSymLinks を使っているので安全でないからです。また、Apache は、/ (ルートディレクトリ)以下の全体のディレクトリに対して、.htaccess を参照しますから、効率が悪いのですが、開発のためだけなら手軽と言えます。
./site/eg/ でのスクリプトがエラーなく動作するなら、Apache::ASP は正常に稼動しています。よく遭遇しがちな問題点は、FAQ セクション
をみてください。