MyTools.NET - CGI設置基礎講座

ソースをダウンロードする

　各説明ページの上部にある「ファイル一覧」からファイルをダウンロードする方法は以下の通りです。

■ Netscapeの場合

1. ファイル名（tnote.cgi等）のところのリンクを左クリックする。
   　　　→ プログラムが表示される。
2. ブラウザ上部のメニューバーから「ファイル ― 名前をつけて保存」を選択する。
3. 説明で指示されている通りに名前を付けなおし、「保存」を押す。

■ Internet Explorerの場合

1. ファイル名のリンクを右クリックする
2. 「対象をファイルに保存」を選ぶ
3. 説明で指示されている通りに名前を付けなおし、「保存」を押す。

※ ダウンロードの都合で、元々のファイル名は正式なファイル名とは違うものになっています。必ずこの「名前の付けなおし」を行ってください。

[index]

Perlのパスを設定する

　各.cgiファイルの一番上の行に、

#!/bin/perl

という表示があります。これはこのファイルがPerlスクリプトであることを教える為のもので、各プロバイダによって設定が違います。ここが違っているとPerlスクリプトとして認識されません。ここに何と記述するかは、ご自分のプロバイダのホームページのCGI関連のところを見れば大抵書いてあります。もし書いてない時は、サポートに直接メールを出して聞きましょう。

「CGIをPerlで書きたいのですが、Perlのパスを教えて下さい。」

と聞けばよいでしょう。

もし、あなたのプロバイダがtelnetを使用できるのでしたら、コマンドラインから、

% which perl

と打ち込めば、「/usr/bin/perl」という具合に表示されます。
表示されたパスの頭に「#!」を付けたものを各.cgiファイルの一番上に書いてください。（上の場合は #!/usr/bin/perl）

[index]

プログラムをＦＴＰで送る

　ＦＴＰの転送モードには「バイナリモード」と「アスキーモード」の２種類があります。普通のHTMLを送る場合はどちらでも大丈夫ですが、ＣＧＩプログラムはアスキーモードで転送しないとサーバーエラーになります。どのＦＴＰソフトにも必ず転送モードを切り替える機能がついています。.cgi という拡張子のファイルは、必ずアスキーモードにしてから転送してください。（転送モードの変更方法は、お使いのFTPソフトのヘルプなどを御覧下さい。）

[index]

パーミッションを設定する

　普通のHTMLはただＦＴＰで転送するだけで表示できますが、CGIプログラムはファイルのアクセス権（パーミッション）を適切に設定しないと動きません。各ファイルのパーミッションはＦＴＰソフト又はtelnetによって変更します。

● telnetで変更する場合

コマンドラインから以下のように打ち込みます。(XXXのところには数字（後述）が入ります)

% chmod XXX <filename>

● Windows の ftp.exe で変更する場合

FTP> quote site chmod XXX <filename>

● ＦＴＰソフトを使って変更する方法

各ＦＴＰソフトによってやり方が違います。それぞれのヘルプをご覧下さい。

　CGIファイルのパーミッションはプロバイダによって違います。各プロバイダの「ホームページの作成方法」に、どのファイルをどのパーミッションにすれば良いかが書いてあります。大抵は下記のようにすれば動きます。（プロバイダに指定されている場合はそっちを優先して下さい。）

• プログラム (.cgi) ... 705
• データファイル (.txt) ... 606
• ディレクトリ ... 707

(例)
% chmod 705 vote.cgi
% chmod 606 data.txt
% chmod 707 lockdir

[index]

ブラウザでアクセスする

　プログラムの最終動作チェックはブラウザからアクセスすることによって行います。各説明ページに方法が書いてありますので、それに従い、書いてあるとおりのメッセージが出れば成功です。上手くいかないときは、「Server Error」等で動かないときにまずチェックすることの全項目を片っ端からチェックしていって下さい。

　エラーメッセージとその原因の組み合わせをいくつか挙げておきます。

• 「Server Error」と出る
  ..... ＦＴＰの際アスキーモードにしなかった、.cgi のパーミッションが適切でない、jcode.plが正しい位置にない詳細、サーバがUNIXではなくてWindows系等の原因が考えられます。

• 「ロック中です」と出る
  ..... lockdir が $basedir の位置にない、lockdir のパーミッションが間違っている、等の原因が考えられます。

• ファイルがそのまま表示される
  .....プロバイダ自体がＣＧＩを禁止している、特定のディレクトリに置く必要がある、設定ファイル (.htaccess) を置く必要がある等の原因が考えられます。

　telnetが使える環境の場合、シェルテストでより詳細な原因を探ることができます。

[index]

空ファイルの作り方

　当ページ内のＣＧＩプログラムにおいて、データファイルとして空ファイル（中に何も入っていない、サイズが０のファイル）が必要な場合があります。サイズが０のファイルはブラウザを通してダウンロードできないので、各自で作成する必要があります。作り方は以下の通り。

● Windows 上で作って転送する場合

1. エクスプローラー又はマイコンピュータ上で右クリックする。
2. 「新規作成 → テキスト文書」を選択
   　　　→「新規テキスト文書.txt」という空ファイルが作られる。
3. ファイル名を変更する。
4. ＦＴＰで指定の場所に転送する。

● サーバーにtelnetして作成する場合

1. 空ファイルを置きたい場所にcd（チェンジディレクトリ）する。
2. % touch [ファイル名]
   と打ちこむ。

　各プログラムの説明で「空ファイル」と書かれているものは全てこの方法で作成して下さい。改行一文字でも入っているとエラーになります。

[index]

お使いのプロバイダはＣＧＩを許可していますか？

　ＣＧＩは普通のＨＴＭＬページと違って「プログラム」ですので、実行することによりサーバーに負荷がかかります。そのため、プロバイダによってはＣＧＩプログラムを置くことを禁止している場合もあります。ご自分のプロバイダのホームページを見れば、ＣＧＩを許可しているかしていないかはすぐに分かると思います。プロバイダ自体がＣＧＩを禁止している場合、残念ですが当ページのＣＧＩプログラムは使用できません。ＣＧＩを使用できるプロバイダかどうかを事前に調査して契約することをお勧めします。

※ 当ページは「プログラムの配布」を行っているだけです。「掲示板、投票等の貸し出し」は行っていませんのでご注意下さい。

[index]

プロバイダ指定のディレクトリに入れていますか？

　プロバイダによっては、CGIプログラムは指定のディレクトリ（cgi-bin等）に入れる必要があるところもあります。（プロバイダの説明ページをご覧下さい。）その場合、通常のHTMLと同じ場所に置いてもプログラムは実行されず、プログラムの中身がそのまま表示されてしまいます。

　特に指定が無い場合は、通常のHTMLと同じディレクトリに入れても動くはずです。

[index]

設定ファイルが必要ではないですか？

　プロバイダによっては「.htaccess」という設定ファイルを置く必要があるところもあります。（お使いのプロバイダの説明ページをご覧ください。）

　具体的には、以下のように書いた .htaccessというファイルを、.cgiと同じかそれより上のディレクトリに置きます：

Options ExecCGI
AddType application/x-httpd-cgi .cgi

　しかし、Windowsでは「.」から始まるファイルは作ることができないようです。その場合は、「dmy.htaccess」という仮の名前で作っておいて、FTPで転送してからサーバ上で「.htaccess」に名前を変えれば大丈夫です。

[index]

ＦＴＰで転送する際、アスキーモードにしましたか？

　ＣＧＩプログラムはＦＴＰの際必ずアスキーモードで転送する必要があります。詳しくはプログラムをＦＴＰで送るを参照してください。

[index]

パーミッションは正しく設定されていますか？

　ＣＧＩプログラムはパーミッションを正しく設定する必要があります。詳しくはパーミッションを設定するをご覧下さい。

[index]

jcode.plは正しい位置にありますか？

　jcode.pl は、日本語処理に必要なライブラリです。掲示板、チャットなど、フォームに日本語を入力するＣＧＩに必須です。jcode.pl を使うにはそのパスを指定しなければなりません。.cgiファイルの上部で、

require './jcode.pl';

というふうに記述されているのがパスの指定部分です。この位置に jcode.pl がないと Server Error になります。上記の場合は .cgiファイルと同じディレクトリに置きます。もし違うディレクトリに置く場合はそのパスを、

require '/home/nishida/public_html/cgi-bin/jcode.pl';

という具合に指定します。

※ 相対パスでも大丈夫です。[例] require '../jcode.pl'

[index]

$basedir のパスはあってますか？

　各.cgiファイルにある「$basedir」という変数は、データファイル（〜.txt等）が置いてある場所へのパスを示します。全てのデータファイルを.cgiファイルと同じ場所に置く場合は、

$basedir = ".";

と書きます。

　しかしプロバイダによっては、.cgiファイルを置く場所には他のファイルを置いてはいけないことになっている場合もあります。この場合データファイルの位置をパスで指定します。パスは相対パスでも絶対パスでもＯＫです。

（例１：絶対パス） $basedir="/home/nishida/cgidata";
（例２：相対パス） $basedir="../cgidata/note";

　下記のように末尾に「/」をつけるとエラーになるので気をつけて下さい。

(誤例) $basedir="/home/nishida/cgidata/";

　データファイルをHTML用ディレクトリに入れておくと、ＵＲＬで直接指定されたときそのデータファイルの中身を見られてしまいます。例えば、クイズのデータファイルを直接ＵＲＬで指定して、回答などを見ることもできてしまうのです。中身を直接のぞかれたくない場合は、データファイルはHTML用ディレクトリに入れないようにしましょう。

[index]

プログラムが途中で途切れていませんか？

　サーバーの混雑等の理由により、プログラムが途中で途切れてることがあります。自分がダウンロードしたプログラムと、実際ページにおいてあるプログラムをもう一度よく見比べて見ましょう。

[index]

自動巡回ソフトを使っていませんか？

　当ページのＣＧＩプログラムを自動巡回ソフト（WebAutoなど）でダウンロードすると、プログラム内部のパス記述等が勝手に書きかえられてしまい、正常に動かなくなることがあります。プログラムのダウンロードはブラウザからリンクを右クリックし「ファイルを保存する」を選択することによって行ってください。

[index]

ファイル名を間違えていませんか？

　説明ページにおいてあるソースファイルは、ダウンロードできるように名前を変えています。ＣＧＩプログラムとして動作させるには説明どおりに名前を変更する必要があります。例えば、"xxx-cgi.txt"となっているファイルは"xxx.cgi"に変える訳ですが、その際にファイルの名前を下記間違える可能性があります。「File Not Found」というエラーが表示される場合は、ファイル名をもう一度チェックし直してください。

[index]

Perlのバージョンは最新ですか？（推奨）

　当ページのプログラムは一応全て Perl4 でも Perl5 でも動くように設計しているつもりです。ですが、Perl4 の中でも古いものだとかなりの確率で動かないことがあるようです。推奨は Perl5.000 以上、最低でも Perl4.035が必要です。もしこれより古いバージョンだった場合はプロバイダ若しくは管理者にメールを送ってPerlを最新のものに入れ替えてもらいましょう。

[index]

サーバはUNIXではなくてＮＴですか？

　最近サーバーをＮＴ等のWindows系サーバーで運用しているプロバイダがあります。（自分のサーバーがＮＴをかどうかは、プロバイダのホームページ内を探すか、管理者にメールを出して聞くかして調べて下さい。）当ページのプログラムはWindows系のサーバーでも動作するように設計されていますが、そのままでは使用できません。具体的には、ファイルロックの方式を変える必要があります。.cgi ファイル又は .pl ファイル全てをチェックして、下の方にある「symlinkが使えないサーバー用のファイルロック」の各行の頭の「#」を取り除き、元々あったロック関数（lock、又は、file_lock という名前）は削除してください。

[index]

telnetでプログラムの動作テストをする方法

　ＣＧＩプログラムが「Server Error」で動かないとき、telnet ができるプロバイダでは以下の方法でエラーの原因を詳しく探ることができます。これを「シェルテスト」といいます。例えば、tnote.cgi というＣＧＩプログラムをテストしたい場合、tnote.cgi のあるディレクトリへ移動して、

% ./tnote.cgi

と打ちこみます。正常に動く場合はHTMLのソースが吐き出されます。
プログラム中に何らかのエラーがある時は、その内容や行数がエラーメッセージとして表示されます。

▼ シェルテストの代表的なエラーメッセージ例

• tnote.cgi: Permission denied.
  　　　→ tnote.cgi のパーミッションが755になっていない。
• tnote.cgi: Command not found.
  　　　→ プログラム最上部のPerlのパスが間違っている
• syntax error at tnote.cgi line 55, near "if"
  　　　→ tnote.cgi の５５行目の "if" という文字の側に文法的な間違いがある。

　メッセージをよく読んで対処してください。

[index]

ファイルロックが解けないときの対処方法

　「ファイルロック」とは、データファイルが同時アクセスによって消滅することを防ぐための仕組みです。当ページ内のプログラムは必要な部分には全てファイルロック機能をつけています。これがあるとファイルの消滅を防ぐことはできるのですが、時々サーバーの不具合などでファイルロックがかかりっぱなしになることがあります。その場合、telnet 又は FTP で lockdir の中にある "〜.lock" というファイルを削除してください。

　lockdirの中にファイルが何もないのにまだ「ロック中」の場合は、lockdirのパーミッションが707になっていない可能性があります。 又、lockdirが存在しない場合や、位置が間違っている場合も「ロック中」は出っ放しになります。インストールの説明をもう一度よく読んで、ファイルのパーミッション、配置が正確かどうか確かめてください。

[index]