総合説明書

この説明書では efStat の概要やインストールについての説明をします。

• はじめに
  • 古いefStatを新しいefStatに差し替える際のポイント
• 概要
  • efCount(fcount.cgi)の特徴
  • efStat(fstat.cgi)の特徴
• 動作環境
• 導入
• プログラム側の設定・使用法
• 宣言
• 多謝/関連資料
• 最後に

このソフトウェアは【『できるだけ』リンクウェア】です。
【『できるだけ』リンクウェア】とは、貴方が本プログラムを使い始めて有用だと感じ使用し続ける場合に、貴方のウェブサイトから「有限工房」へ『できるだけ』リンクしていただくという契約のソフトウェアです。
堅苦しさ抜きに書きますと、イイと思ったらウチのページを宣伝してチョ☆、ということです(^^

『できるだけ』ですので、企業サイトに採用する場合など止むを得ない場合はリンク不要です。

プログラムの性格上、efStat の存在を明らかにする必要はありませんが、せめて「ここにはお世話になってます」みたいな感じで上手く誤魔化してリンクを張ってあげて下さい。
カウンタに<A>要素でリンクを張るという方法もよく見かけます。

このスクリプトは、CGI/SSI設置の知識がある程度ある方を対象にしています。
申し訳ありませんが、この説明書を読んでもチンプンカンプンだった方は使用をご遠慮下さい。

■古いefStatを新しいefStatに差し替える際のポイント

特に注意書き(!!caution!!.txt)などがなければ、基本的に：

1. ログファイル・旧fstat.cgi,fcount.cgiのバックアップを取っておく。
   (後者は今までの設定内容を忘れないようにするため)
2. efStatをインストールしたディレクトリに新しいefStatを全て上書きする
   (いったん中身を全て消してしまってからコピーするとなお良し)
3. バックアップを取っておいたログファイルを元に戻す。
4. 前バージョンの設定を新バージョンに移植する。
   (設定方法が変更されていたりするので、説明書と照らし合わせて注意しながら行うこと)

このようにして下さい。　つまり、中身を総入れ替えしてからログと設定を引っ越しさせます。
これが一番安全・確実な方法です。

efCount(fcount.cgi)の特徴

カウンターの機能とアクセスロガーの機能を併せ持っている

ページ毎にログを記録することができる

きめ細かな記録

プロバイダを選ばない、SSI・CGI両用の柔軟設計

同じ人が再読込してもカウントしない

アクセスが何日無かろうと、カウント値が反映される

その他特徴

• カウントアップしたくないホスト・IPアドレスを指定可能
• カウントアップしたくないブラウザを指定可能
• flock を使った強固なファイルロック機構
• 時計表示
  (単純なので役に立たないとは思いますが、まあ、ページの飾りにでも使って下さい(^^；)
• 表示のみを行い、カウントアップをしないようにも指定可能

efStat(fstat.cgi)の特徴

強力なログ分析・解析機能

全て・本日・昨日と範囲を指定して表示できます

練られたユーザ・インターフェース

UNIX系OSなら多分なんでも行けると思います。
厳密には truncate 関数と flock 関数をサポートしたPerl 5以上が必要です。
動作確認は FreeBSD 2.2.7R + Apache/1.2.6 + jperl5.004_04-980303 にて行いました。

2016/08/12追記：「エックスサーバ(Perl5.8.8)」で動作確認しました。
2016/08/15追記：「さくらのレンタルサーバ(Perl5.14.4)」で動作確認しました。

Windows系/MacOS系とPerlの組み合わせでも動作する筈ですが、サポート外とさせていただきます。
私の元にはUNIX以外のOS環境がないので動作確認ができないのです。
少なくとも Win9x + MS IIS + ActivePerl の組み合わせでは修正なしには動きません。

CGI、又はSSIが使用可能になっているかどうかもご確認下さい。
プロバイダ側サーバに Perl がインストールされているかもご確認下さい。

efCount(カウンタ部)はSSI , CGIのどちらでも使えるように作られていますが、efStat(ログ解析部)はCGIでしか使えません。
つまり、efCountを SSI として使う場合は、サーバがSSI だけでなく、 CGI にも対応している必要があります。

☆解凍☆

fstat.lzh を解凍します。
こんな感じでファイルが詰まっているはずです。

<docディレクトリ>	[説明書が格納されています]
readme.html	総合説明書。これ
fcount.html	efCount 取扱説明書
fstat.html	efStat 取扱説明書
history_fc.html	efCount バージョンアップ履歴
history_fs.html	efStat バージョンアップ履歴
makehtml.html	fcount.cgi を呼び出すためのタグを生成するツール。 タグがややこしすぎてワカラン！　という人はどうぞ。
format.csv	ログの仕様。　CSV形式に対応した表計算ソフトでご覧下さい。
default.css	説明書の表示スタイルを定義したファイル(あってもなくても無害)
fstat.gif	バナーです。宜しければお使い下さい。

これらのファイルが出てきましたか？
ちょっと説明書が多いですけど、中身はほとんど同じです。
CGI 設置を経験済みの方なら、いつも CGI を設置しているのと同じ要領で行けますので挫けないで下さい(^^；

☆パーミッションの設定・ディレクトリ構成☆

出てきたファイルをサーバ側の任意のディレクトリ(※)へFTPアップロードします。
そのとき、ディレクトリ名は fstat が適当でしょう。
(※…WindowsやMacで言うところの「フォルダ」です。　以後、UNIXでの呼び方に合わせ「ディレクトリ」とします)

プロバイダから「CGI スクリプトは cgi-bin 以下に置きなさい」など、スクリプトの置き場所を指定されているときは、そのディレクトリの下に fstat ディレクトリを作って下さい。

最終的には、次の様になるようにします。

＜標準のディレクトリ構成＞

                                      (パーミッション)
/cgi-bin                              (705) drwx---r-x  [CGIスクリプト格納ディレクトリ]
   |--/fstat                          (705) drwx---r-x  [efStat格納ディレクトリ]
         |-- fcount.cgi               (705) -rwx---r-x  (カウンタ部)
         |-- fstat.cgi                (705) -rwx---r-x  (ログ表示部)
         |-- /lib                     (705) drwx---r-x  [ライブラリ用ディレクトリ]
         |     |-- start.pl
         |     |-- func.pl
         |     |-- main.pl
         |     |-- menu.pl
         |     |-- jacode.pl
         |     |-- gifcat.pl
         |     |-- e.gif
         |     |-- 0.gif
         |     |-- 1.gif
         |     |-- d.gif
         |     |-- w.jpg
         |     |-- b.gif
         |     +-- /table
         |            |-- agent.tbl
         |            |-- cctld.tbl
         |            |-- gtld.tbl
         |            +-- jpdomain.tbl
         |
         |-- /log                     (705) drwx---r-x  [ログ用ディレクトリ]
         |     |-- index.log          (606) -rw----rw-  (ログファイル(テスト用))
         |     |       ：
         |
         +-- /image                   (705) drwx---r-x  [カウンタ画像用ディレクトリ]
               |-- /fuksan            (705) drwx---r-x  [フォントごとのディレクトリ]
               |      |-- 0fuksan.gif
               |      |       ：
               |      +-- 9fuksan.gif
               |
               |-- /fuksan_
               |      ：

()内はパーミッションの数値

冗長になりますので説明書を分けました。
設定の仕方、使用法などについては各プログラム説明書をご覧下さい。

カウンタ部 efCount については fcount.html をご覧下さい。
ログ表示部 efStat については fstat.html をご覧下さい。

このプログラムはフリーソフトです。
著作権は放棄しません。 プログラム中のコピーライト表記を削除したり、改変しないで下さい。
（画面のレイアウトやメッセージを変更した程度で著作者名を変えられると寂しいって程度です）
大幅な改造を施した場合は問題ありません。
その辺は常識的なさじ加減ということで…(^_^；

自由に改造して使用して下さい。　 改造したものを再配布する事も制限しません。
efCount のログ形式を利用した互換品を開発することも問題ありません。
ただし、改造版のサポートは改造した方が各自責任を持って行って下さい。

オリジナル版の第三者による配布は禁止します。
これは、普及に伴いバージョン管理が困難になってきたためです。
CD-ROMなど、私のページ以外の場所で掲載する場合は必ずご一報下さい。

商用・非商用にかかわらずご利用いただけます。
でも、「はじめに」で書いたとおり「リンクウェア」ですので、極力リンクを貼っていただきたいです。

このプログラムを用いた事による一切の損害について、作者は責任を負わないものとします。

本プログラムを構成しているファイルのうち、

• 日本語コード変換ライブラリ jacode.pl は 稲葉準 氏
• GIF画像連結ライブラリ gifcat.pl は 杜甫々 氏

に著作権があります。
これらの有用なプログラムを開発して下さった方々に深く感謝いたします。

■参考資料(著者敬称略)

• プログラミングPerl 改訂版 / Larry Wall, Tom Christiansen, Randal L. Schwarts
• 「すぐに使える Perl スクリプト CGI & SSI 快適活用ライブラリ」 / ドッシー秋山・キャメル桜田
• 68user's page内「User Agent統計」 / 68user
• Some Gripes on User-Agent / Kabe
• DNS & BIND 第3版 / Paul Albitz, Cricket Liu
• RFC1945 - HTTP/1.0 / T. Berners-Lee他
• RFC2068 - HTTP/1.1 / R. Fielding他
• 「とほほのWWW入門」 / 杜甫々

本ソフトはフリーソフトではありますが、沢山の労力と時間を割いて作られております。
だからといって物質的な見返りはこれっぽっちも期待しておりませんが、皆さんに使ってもらいたい、沢山の反響が欲しい、という自己満足がプログラム製作の原動力になっております。
宣言にもありますとおり、極力私のサイトへリンクをお願いします。　(お客が増える　＞　反響も増える　＞　サイトが盛り上がる　＞　私嬉しい☆)

もしよろしければ不可思議絵の具まで「efStat使ってるよ～」とメールでも掲示板でも何でも構いませんので教えてあげて下さい。
返事をお返し出来ないかもしれませんが、送っていただいたメールには全て目を通しております。
そんな皆様の温かいご声援メールは私の元気の源になっています。　ありがとうございます(^^)
ただ、質問は掲示板にお願いします。　近頃捌ききれないので…(^_^;