[道里千虎の館]

◆ SDcountH 説明書

■ 仕様

• 【ソフト名】 SDnote-H
• 【バージョン】 1.00, 2.02
• 【更新日】 2001/01/21
• 【種別】 CGIカウンター(イメージタグ埋め込み型)
• 【対象】 CGIの使えるユーザー(初心者〜上級者向け)
• 【機能】 Ver1.00： 全体、昨日、今日のカウントを表示可能。リロードカウント防止。
             Ver2.02： Ver1.00の機能＋クッキー対応、各種ログつき。
• 【開発】 道里千虎 (hat@iis.u-tokyo.ac.jp)
• 【最新版】 http://lowpower.iis.u-tokyo.ac.jp/~hat/
• 【著作権】 著作権は道里千虎にあります。転載、再配布などは自由です。
  ※ 雑誌、CD-ROM等、商用メディアへの掲載の際には一言連絡下さいますようお願いします。

• 見本
• 機能
• ソース
• インストール方法
  • インストール
  • カウンターを設置する
• 使い方
  • パラメータ
  • 全体、昨日、今日のカウント数を表示
  • カウンタの桁数を変更する
  • カウンタの画像を変更する
  • リロードをカウントしないようにする
  • ログをとるかどうか指定する (Ver2.00以降のみ)
  • クッキーを使用してユーザー別のカウント数をとる (Ver2.00以降のみ)
• ログを見る (Ver2.00以降のみ)
  • ログを表示する
  • ログファイルの形式
• その他
  • カウント値を変更する
  • 隠しカウンタを作る
• Q&A
• 更新履歴

• 全体、昨日、今日のカウントを別々に表示可能。
• リロードカウント防止。
• 1つのプログラムで複数のカウンターを扱える。
• カウンタごとに自由に異なるgif画像を使用できる。

• ホストごとのログをとっていれば、個別のカウント数を表示可能。
• クッキーを用いて個別のカウント数をとることもできる。
• 各種ログをとることができる。（単純なログ、日ごとのログ、ホストごとのログ）
• ログをブラウザで見ることができる。（パスワード設定で他人に見せないことが可能）

■ ソース

プログラム

Ver.1.00

• SDcountH10.cgi ... 本体
• gifcat.pl ...GIF画像連結用ライブラリ Copyright (c) 1997 s-hasei@mtg.biglobe.ne.jp

Ver.2.02

• SDcountH20.cgi ... 本体
• SDcountlog.cgi ... ログ閲覧用プログラム
• gifcat.pl ...GIF画像連結用ライブラリ Copyright (c) 1997 s-hasei@mtg.biglobe.ne.jp

• default.lzh ... 圧縮ファイル（解凍してご使用ください。） 
  Copyright (c) 2001 Sentora Dori
  

1. ソースから必要なファイルをダウンロードする。カウンタ用のgif画像（０〜９の数字の画像）がなければ、gif画像もダウンロードする。
   
   ※ ネット上のどこからか探してくるか、または自分で作成してもいいです。
   ただし、アニメーション画像は使用できません。他にも使用できない画像があるかもしれませんので、表示がおかしくなるようでしたら、他の画像に変更してください。
   
   
2. SDcountH10.cgi または SDcountH20.cgi （以下、SDcountH**.cgi と省略）の最上部のPerlのパスを正しく設定する。
   
   （例） #!/usr/local/bin/perl
   
   ※ PerlのパスはUNIXの種類やサーバによって異なりますので、わからない場合はサーバの管理者に問い合わせてください。
   
   
3. SDcountH**.cgi の上部にある「変数設定」部分を編集する。
   
   Ver.1.00
   • $basedir ..... カウンタファイルをおくディレクトリのパス（※注１）

   
   Ver.2.02

   • $basedir ..... カウンタファイル、ログファイルをおくディレクトリのパス（※注１）
   • $takelog ..... 1: ログをとる 0:とらない（※注２）（※注３）
   • $takelog_pure ..... 最も単純なログをとる(カウント数、アクセス時間、IPアドレスを順番に記録する)
   • $takelog_day ..... 日ごとのアクセス数をとる
   • $takelog_ip ..... ホストごとのアクセス数をとる
   • $cookiename ..... Cookieの名前 (Cookie使用時) (通常は変更必要なし)
   • $cookiedays ..... Cookieの有効期間 (Cookie使用時) (必要ならば変更)
   • $uselock ..... ファイルロックの方法を指定する (通常は変更必要なし)
     2: flockを使用する 1: ロックファイルでロックする 0: ロックしない
   
   
   ※注１ データファイルをプログラムと同じ場所に置く場合は $basedir=".";のまま。
   ※注２ ログをとる場合は$takelogを1にし、さらにとるログの種類に応じてその下の項目も1に設定してください。0に設定するとそのログはとりません。
   ※注３ イメージタグ内でもログをとるかとらないか指定することができ、指定した場合はそちらが優先されます。イメージタグで指定しない場合は、$takelogの値が有効になります。
   
   
4. SDcountH**.cgi, gifcat.pl を ＦＴＰのアスキーモードで転送し、CGIの使用できるディレクトリに置く（※注４）。パーミッションをそれぞれ755、644にする。
    
   (telnetの場合、以下同様。)
   % chmod 755 SDcountH**.cgi
   % chmod 644 gifcat.pl
   
   ※注４ CGIの使用ディレクトリはサーバによって異なりますので、わからない場合はサーバの管理者に問い合わせてください。（通常は cgi-bin 以下のディレクトリであることが多い。）
   
   
5. Ver2.02 の場合は、SDcountlog.cgi も同様にFTPで転送して上と同じディレクトリに置く。 パーミッションをそれぞれ755、644にする。
   
   % chmod 755 SDcountlog.cgi
   
   
6. 上でファイルを置いたディレクトリにディレクトリ img を作る。パーミッションを755にする。
   
   % mkdir img
   % chmod 755 img
   
   
7. ディレクトリ img に移動し、ディレクトリ default を作る。パーミッションを755にする。
   
   % cd img
   % mkdir default
   % chmod 755 default
   
   
8. ディレクトリ default に移動しこのディレクトリ中に、gif画像ファイルをFTPでバイナリ転送する。画像のファイル名は、0.gif, 1.gif, 〜, 9.gifとする。パーミッションを 644 にする。
   
   (telnetの場合)
   % cd img
   % chmod 644 *.gif
   
   
9. ブラウザからSDnoteH**.cgiにアクセスする。
   　　　→ [no counter data]と表示されたらインストール完了。
   

1. 新しいカウンタの名前を決める。例えば index とする。複数のカウンタを使用する場合は重複しないように名前をつけてください。
   
   ＊使用できる文字は英数字のみです。他の記号は使えません。
   
   
2. カウントデータを保存するための index.txt という空ファイルを作る。それを$basedirで指定したディレクトリ（$basedir="./";の場合は SDcountH**.cgi と同じディレクトリ）におく。パーミッションを 666 に設定する。
   
    (telnetの場合)
   % touch index.txt
   % chmod 666 index.txt.
   
   
3. ログをとる場合には、ログデータを保存するための index.log という空ファイルを作る。それを$basedirで指定したディレクトリ（$basedir="./";の場合は SDcountH**.cgi と同じディレクトリ）におく。パーミッションを 666 に設定する。
   
   ＊すでに機能しているログをとっていないカウンタで、新たにログをとりたいときには、必ずログファイルを作成してください。
   
    (telnetの場合)
   % touch index.log
   % chmod 666 index.log.
   
   
4. HTMLファイル中のカウンタを表示させたい場所に次のようにイメージタグを入れる。
   
   <IMG SRC="http://〜/SDcountH**.cgi?index&1 WIDTH=80 HEIGHT=20">
   
   ※ 上記は一例です。URLは相対パス(../SDcountH**.cgi等)でも絶対パス(http://〜/SDcountH**.cgi)でも構いません。
   ※ WIDTHには （gifファイルの横幅）×桁数（標準では５桁）、HEIGHT には gifファイルの縦幅を書いて下さい。WIDTHとHEIGHTは省略できますが、書いておくとブラウザでの処理が多少速くなりますので、書くことをおすすめします。
   
   
5. 昨日のカウント数を表示させたいときは、HTMLファイル中の表示させたい場所に次のようにイメージタグを入れる。
   
   <IMG SRC="http://〜/SDcountH**.cgi?index&&yesterday&3 WIDTH=80 HEIGHT=20">
   
   ※ ここでは桁数を3桁としています。下も同様。
   
   
6. 今日のカウント数を表示させたいときは、HTMLファイル中の表示させたい場所に次のようにイメージタグを入れる。
   
   <IMG SRC="http://〜/SDcountH**.cgi?index&&today&3 WIDTH=80 HEIGHT=20">
   
   
7. HTMLファイルをサーバーにFTPしてみて、表示されるかどうか確かめる。リロードしたら数字が増えるかも確認する。
   

使い方

● パラメータ

• (1) ... カウンター名 (必須)
• (2) ... 数を増やす場合 → "1" (何も指定しない場合は増えない)
• (3) ... 今日のカウント数を表示→"today"、前日のカウント数を表示→"yesteray" (何も指定しない場合は総合のカウント数)
• (4) ... 表示する桁数 (指定しない場合は５桁)
• (5) ... 画像のディレクトリ名 (指定しない場合は "./img/")
• (6) ... リロードをカウントしない → "1" (何も指定しない場合はリロードもカウントする)

• (7) ... ログをとる → "1" (何も指定しない場合は、SDcountH**.cgi の中の変数 $takelog に指定された値を用いる)
• (8) ... クッキーを使用してユーザー別のカウント数をとる → "1" (指定しない場合は使用しない)

● カウントの桁数を変更する

● カウンタの画像を変更する

1. ディレクトリ img の下に、新しくディレクトリ mygif を作る。パーミッションを755にする。
   
   %cd img
   %mkdir mygif
   %chmod 755 mygif
   
   
2. ディレクトリ mygif に移動しこのディレクトリ中に、gif画像ファイルをFTPでバイナリ転送する。画像のファイル名は、0.gif, 1.gif, 〜, 9.gifとする。パーミッションを 644 にする。
   
   (telnetの場合)
   % cd img
   % chmod 644 *.gif

● リロードをカウントしないようにする

● クッキーを使用するかどうか指定する （Ver.2.00以降のみ）

ログ (Ver2.00以降のみ)

● ログ表示

1. ログは(カウンタ名).logというファイルに格納されます。これはカウンタの設置の3番目で作成します。これを SDcountlog.cgi で見ます。このファイルはインストールの5番目でインストールしているはずです。
   
   ※ とるログの種類はインストールの3番目での設定（SDcountH**.cgi の変数の設定）によって決まります。
   以下の種類があるので、指示に従って設定してください。
   
   • アクセス順の単純なログ 
     　データ形式 ⇒ (カウンタ値, アクセス時間, IPアドレス, ドメイン名)
   • 日にちごとのログ
     　データ形式 ⇒ (年月日, アクセス回数)
   • ホストごとのログ
     　データ形式 ⇒ (IPアドレス, ドメイン名, アクセス回数)
     
     
2. SDcountlog.cgi の最上部のPerlのパスを正しく設定する。
   
   （例） #!/usr/local/bin/perl
   
   ※ PerlのパスはUNIXの種類やサーバによって異なりますので、わからない場合はサーバの管理者に問い合わせてください。
   
   
3. SDcountlog.cgi の上部にある「変数設定」部分を編集する。
   
   • $basedir ..... カウンタファイル、ログファイルをおくディレクトリのパス（※注１）
   • $validpass ..... 管理用のパスワード（※注２）
   • $graphwidth ..... アクセス数を表す棒グラフの最大の幅(値が全体の100%のときの幅)
   • $graphheight ..... アクセス数を表す棒グラフの高さ
   • $usesort ..... 1:ホスト別、ドメイン別のログをアクセス回数順に並び替えて表示する 0:並びかえない（※注３）
   • $showsort ..... 1:ログファイル中のホスト別のログを並びかえるためのボタンを表示する 0:表示しない（※注３）
   • $method ..... フォーム内容の送信方法（※注４）
   
   
   ※注１ ログファイルをプログラムと同じ場所に置く場合は $basedir=".";のまま。
   
   ※注２ ここにパスワードを書いておいて、SDcountlog.cgi にアクセスすると、パスワード入力フォームが表示され、他人にログを見られないようにできます。何もかかないとパスワードなしで誰でも見られるようになります。
   
   ※注３ ホスト別、ドメイン別のログをアクセス回数順に並び替えて表示すると、見やすくはなりますが、ログの数が多いと並び替えに時間がかかるので気になる場合は0にしてください。
   　ばらばらのログデータをいつも並びかえて表示するのは時間がかかるので、$showsort を1にすると、並びかえてログファイル内に書き込むことのできるボタンが現れます。
   
   ※注４ "post" が使えないところでは "get" に変えてください
   
   
4. SDcountlog.cgi にアクセスする。
   　→ パスワードを書いてあれば、パスワード入力画面が表示される。そうでなければ6.へ。
   
   
5. $validpass に設定したのと同じパスワードを入力して送信する。
   
   
6. パスワードが正しければログ選択画面が表示される。
   
   
7. カウンタ名のフォームにログを表示させたいカウンタ名を書き、表示させるログの種類を選択する。以下の種類があります。
   
   
• アクセス順 
  　カウンタ値, アクセス時間, IPアドレス, ドメイン名
• 日にち別
  　年月日, アクセス回数, アクセス回数を示すグラフ
• ホスト別
  　IPアドレス, ドメイン名, アクセス回数, アクセス回数を示すグラフ
• ドメイン別
  　3桁のドメイン名, アクセス回数, アクセス回数を示すグラフ
  
  ※ 全部にするとすべてのログが長々と表示されます。
  
  
8. $usesort を1に設定していれば、ホスト別、ドメイン別のログはアクセス回数順に並び替えて表示される。また、$showsort を1に設定していれば、ファイル中のホスト別のログを並びかえるためのボタンが表示される。
   
   
9. 続けて見たいカウンタログがあれば、カウンタ名を入力して見る。

• アクセス順の単純なログ 
  　カウンタ値, アクセス時間, IPアドレス, ドメイン名
  　(197,2000-1-15 10:32:11,192.168.0.0,sentora.dori.co.jp)
• 日にちごとのログ
  　年月日, アクセス回数
  　(2001-1-15,22)
• ホストごとのログ
  　IPアドレス, ドメイン名, アクセス回数
  　(192.168.0.0,sentora.dori.co.jp,5)

• 全体のアクセス数
• 昨日のアクセス数
• 今日のアクセス数
• 最後にアクセスされた時間の日付
• 最後にアクセスしたユーザーのIPアドレス

• hidden.lzh ... 圧縮ファイル（解凍してご使用ください。） 
  Copyright (c) 2001 Sentora Dori

• 各ファイルのパーミッションは合っていますか。
  

  カウンタ本体	SDcountH**.cgi	755	(Ver1.00は SDcountH10.cgi) (Ver2.02は SDcountH20.cgi)
  ログ閲覧プログラム	SDcountlog.cgi	755	(Ver2.00以降のみ)
  gif連結ライブラリ	gifcat.pl	644
  数字の画像	0.gif, 1.gif, 〜, 9.gif	644
  カウントデータ	(カウンタ名).txt	666
  ログデータ	(カウンタ名).log	666	(Ver2.00以降のみ)

  
  
• SDcountH10.cgi または SDcountH20.cgi の最上部のPerlのパスが正しく設定されていますか。
  
  (例) #!/usr/local/bin/perl
  
  
• ブラウザのアドレス欄に次のように直接パラメータを書いてアクセスしてみる。
  
  http://〜/SDcountH**.cgi?(カウンタ名)&1
  
  ☆ [no counter data] と表示される。
      →カウントデータ (カウンタ名).txt は本体プログラム SDcountH**.cgi の $basedir で指定されたディレクトリに置かれていますか。
      →HTMLファイル内のイメージタグが正しく書かれていますか。(URL部分に本体プログラム名を書き ? を挟んで最初のパラメータに カウンタ名 を書く。後は パラメータ 参照)
  
  ( 例) <IMG SRC="SDcountH**.cgi?index&1 WIDTH=80 HEIGHT=20">
  
  
  ☆ [no image files] と表示される。
      →数字の画像 0.gif, 1.gif, 〜, 9.gif はディレクトリ $img/default またはイメージタグで指定したディレクトリに置かれていますか。
      →イメージタグ内の5番目のパラメータにgif画像ファイルの置いてあるディレクトリ名が正しく設定されていますか。(アニメーションgifなど使用できないgif画像もあります。その場合は他のgif画像に変更してください。)
  
  ( 例) <IMG SRC="SDcountH**.cgi?index&1&&5&img/mygif WIDTH=80 HEIGHT=20">
  
  
  ☆ [lock error] と表示される。
      →ロックができていません。
  　初期設定ではflockを用いていますが、エラーが出る場合は、本体プログラム SDcountH**.cgi の $uselock を1に変更してください。ロックファイルによるロック方式を用います。
  　それでもエラーが出る場合は、 SDcountH**.cgi の $uselock を0に変更してください。この場合、ファイルロックは行いませんので、カウンタデータファイルまたはログファイルが壊れるおそれがありますが、ヒット数が少ないページでしたらたぶん大丈夫でしょう・・・(汗)。
  

• イメージタグ内の2番目のパラメータが1に設定されていますか。
  
  
• イメージタグ内の6番目のパラメータが1に設定されていると、リロードしてもカウントしません。
  
  (例) <IMG SRC="SDcountH**.cgi?index&1&&&&1 WIDTH=80 HEIGHT=20">

• ログデータ (カウンタ名).log は $basedir で指定されたディレクトリに置かれていますか。
  
  
• 本体の $takelog が1に設定されていますか。また、そのすぐ下の $takelog_pure,  $takelog_day,  $takelog_ip のうちとりたいログが1に設定されていますか。
  
  
• イメージタグ内の7番目のパラメータが0に設定されていると、ログをとりません。
  
  (例) <IMG SRC="SDcountH**.cgi?index&1&&&&&0 WIDTH=80 HEIGHT=20">

• 01/01/21  Ver.2.02  ファイルロックをflock、ロックファイル、なしから選べるようにした
• 01/01/16  ログを見るプログラムを作成
• 01/01/12  Ver.2.01  1つのプログラムで複数のカウンタを扱えるようにした
• 01/01/09  Ver.2.00  ログ、クッキーの機能をつけた
• 01/01/07  Ver.1.00  ただのカウンター