• カウンタ数字を1画像に合成して表示するアクセスカウンタです
• 利用者が用意した数字画像ファイル（GIFフォーマット）をカウンタ画像として使用可能
• トータル、今日、昨日、今月、先月、今年、去年、およびコンテンツ毎のカウンタを表示可能（それぞれ異なるカウンタ画像にすることも可能）
• アクセスログをファイルに出力することが可能、アクセスログ表示CGI（Real Standard Access Log）で使用できます
• 指定IPアドレスのアクセスでは訪問数をカウントさせないことが可能（管理者のIPアドレスを指定しておけば、純粋な訪問数がカウントされます）
• 同一IPアドレスの一定時間内の連続アクセスでは訪問数をカウントさせないことが可能（ブラウザの更新ボタンの連打で訪問数がカウントされるのを防ぎます）
• 一つのCGI設置で複数のアクセスカウンタを設置可能（URLデータディレクトリ指定方式）
• カウンタを更新させない指定可能
• カウンタを表示させない指定可能

既に当CGIのバージョン1.00および1.01を運用している場合は、バージョン1.02に含まれているコンバータCGIを使用して既存データを変換してから、当CGIの運用を再開して下さい。

cgi.real-interactive.jpで公開しているフリーソフトもしくはシェアウェアのCGIプログラムを利用するには、当ウェブサイトの利用規定に同意して頂く必要があります。CGIプログラムを利用する前に、下記のリンクから利用規定ページを開き内容を確認して下さい。

• 利用規定

当CGIプログラムを設置するウェブサーバが、以下の環境に対応しているか確認して下さい。判らない場合は、サーバ管理者に問い合わせして下さい。

• Perl5.8以降が実装されていること。
• Perl5.8以降の標準モジュールJcode.pm（日本語文字集合ハンドラ）が実装されていること。

※

上記のモジュールが実装されていない場合は、小飼弾氏が管理されているJcodeオープンラボからモジュールスクリプトをダウンロード可能です。

※

Jcode.pm（日本語文字集合ハンドラ）のインストールについては、上記のウェブページを参照して下さい。

以下の圧縮ファイルをダウンロードして下さい。

また、杜甫々氏が無料で配布されているgifcat.pl（GIFファイル連結ライブラリ）が必要です。杜甫々氏が管理されているとほほのCGIソフト集からGIFファイル連結ライブラリをダウンロードできます。

ダウンロードした圧縮ファイルを解凍すると以下のフォルダ・ファイルが展開・作成されます。

• rls_real_std_acc_cnt
• css ………………………………………………… （データ変換が必要であればアップロード）
• real_std_acc.css
• real_std_acc_base.css
• data
• access.log
• address.dat
• contents.dat
• counter.dat
• hour.dat
• month.dat
• referrer.dat
• week.dat
• html ……………………………………………… （データ変換が必要であればアップロード）
• convert.html
• auth.html
• complete.html
• error.html
• head.html
• cnvhead.html
• cnvfoot.html
• image
• main
• 0.gif
• 1.gif
• 2.gif
• 3.gif
• 4.gif
• 5.gif
• 6.gif
• 7.gif
• 8.gif
• 9.gif
• dmy.gif
• lib
• real_std_cgi_lib.cgi
• real_std_file_lib.cgi
• sample …………………………………………… （アクセスカウンタ表示サンプル、アップロード不要）
• real_std_acc_cnt_smp.css
• real_std_acc_cnt_smp.html
• real_std_acc_cnt.cgi
• real_std_acc_cnv.cgi ……………………… （データ変換が必要であればアップロード）
• real_std_acc_def.cgi
• real_std_acc_file.cgi

※ 上記のアイコンはフォルダを表し、アイコンはファイルを表す。

1. real_std_acc_cnt.cgi（アクセスカウンタメインプログラム）の編集
• 1行目のPerlパスを確認し、設置するウェブサーバのPerlインタプリタパスと異なる場合は変更が必要です。判らない場合は、サーバ管理者に問い合わせして下さい。

#!/usr/bin/perl

例）Perlパスが/usr/local/bin/perlの場合は、以下の様に変更します。

#!/usr/local/bin/perl

2. real_std_acc_def.cgi（定義プログラム）の編集
• ウェブサーバでflock命令が使えない場合は、ファイルの同時多重書込禁止処理を無効にします。判らない場合は、サーバ管理者に問い合わせして下さい。

	$LockSw = 'ON';
#	$LockSw = 'OFF';

例）無効にする場合は、以下の様に変更します。

#	$LockSw = 'ON';
	$LockSw = 'OFF';

• ログファイル最大記録件数を変えるには、以下の値を変更して下さい。

$LogLmt = 30000;

例）10000件にする場合は、以下の様に変更します。

$LogLmt = 10000;

• コンテンツファイル最大記録件数を変えるには、以下の値を変更して下さい。

$CttLmt = 1000;

例）100件にする場合は、以下の様に変更します。

$CttLmt = 100;

• リファラー（参照元）ファイル最大記録件数を変えるには、以下の値を変更して下さい。

$RefLmt = 1000;

例）500件にする場合は、以下の様に変更します。

$RefLmt = 500;

• アドレスファイル最大記録件数を変えるには、以下の値を変更して下さい。

$AddrLmt = 10000;

例）15000件にする場合は、以下の様に変更します。

$AddrLmt = 15000;

• 以下の時間カウンタファイル最大記録件数、曜日カウンタファイル最大記録件数、月カウンタファイル最大記録件数の値は変更しないで下さい。

$HourLmt = 30;
$WeekLmt = 10;
$MntLmt = 15;

• パスワード最大文字数を変えるには、以下の値を変更して下さい（但し、パスワード認証機能はコンバータCGI専用です）。
  パスワード最大文字数を0に設定するとパスワード認証を行いません。

$PassLmt = 20;

例）最大10文字にする場合は、以下の様に変更します。

$PassLmt = 10;

例）パスワード認証を使用しない場合は、以下の様に変更します。

$PassLmt = 0;

• パスワード承認URLを変えるには、以下の値（URLを半角スペース区切りで複数設定可能）を変更して下さい（但し、パスワード認証機能はコンバータCGI専用です）。
  参照元URLが設定した承認URLに存在すると承認を許可します。通常は当CGIプログラムを設置したサイトURLを設定して下さい。

$ApproveUrl = 'http://www.real-interactive.jp/';

例）http://www.abc.123.jp/にする場合は、以下の様に変更します。

$ApproveUrl = 'http://www.abc.123.jp/';

例）パスワード承認URL機能を使用しない場合は、以下の様に変更します。

$ApproveUrl = '';

• パスワード承認IPアドレスを変えるには、以下の値（IPアドレスを半角スペース区切りで複数設定可能）を変更して下さい（但し、パスワード認証機能はコンバータCGI専用です）。
  通常は管理者のIPアドレスを設定します。

$ApproveAddr = '';

例）255.255.11.111と255.255.22.222にする場合は、以下の様に変更します。

$ApproveAddr = '255.255.11.111 255.255.22.222';

例）パスワード承認IPアドレス機能を使用しない場合は、以下の様に変更します。

$ApproveAddr = '';

• 連続同一IPアドレス抑制タイムを変えるには、以下の値（秒単位で指定）を変更して下さい。
  設定した秒数内の同一IPアドレスでの連続アクセスであればカウンタを更新しません。

$ScsnCtrlTime = 10;

例）30秒にする場合は、以下の様に変更します。

$ScsnCtrlTime = 30;

例）抑制させない場合は、以下の様に変更します。

$ScsnCtrlTime = 0;

• 除外URLを変えるには、以下の値（URLを半角スペース区切りで複数設定可能）を変更して下さい。
  参照元URLが設定した除外URLに存在するとカウンタを更新しません（アクセスログは対象外）。通常は当CGIプログラムを設置したサイトURLを設定して下さい。

$ExceptUrl = 'http://255.0.0.1/';

例）http://www.abc.123.jp/にする場合は、以下の様に変更します。

$ExceptUrl = 'http://www.abc.123.jp/';

例）除外URL機能を使用しない場合は、以下の様に変更します。

$ExceptUrl = '';

• 除外IPアドレスを変えるには、以下の値（IPアドレスを半角スペース区切りで複数設定可能）を変更して下さい。
  訪問者のIPアドレスが設定した除外IPアドレスに存在するとカウンタを更新しません（アクセスログは対象外）。管理者のIPアドレスを指定しておけば、純粋な訪問数がカウントされます。

$ExceptAddr = '255.0.0.1';

例）127.0.0.1と255.0.0.1にする場合は、以下の様に変更します。

$ExceptAddr = '127.0.0.1 255.0.0.1';

例）除外IPアドレス機能を使用しない場合は、以下の様に変更します。

$ExceptAddr = '';

下記のディレクトリ・ファイル構成図を参考に、以下の手順でファイルをウェブサーバに転送します。

1. ウェブサーバに必要なディレクトリを作成して下さい。
2. ウェブサーバの所定ディレクトリに解凍・編集したファイルをFTPでアップロードします。
3. gifcat.pl（GIFファイル連結ライブラリ）は、cgi-binディレクトリ直下にアップロードして下さい。
4. アップロードしたディレクトリ・ファイルのパーミッション（アクセス権、FTPでは属性とも呼ぶ）を設定して下さい。

ディレクトリ・ファイル構成

パーミッション

転送モード

• cgi-bin
• 755 or 705
• 作成
• lib
• 755 or 705
• 作成
• real_std_cgi_lib.cgi
• 755 or 705
• アスキー転送
• real_std_file_lib.cgi
• 755 or 705
• アスキー転送
• real_std_acc
• 755 or 705
• 作成
• css
• 755 or 705
• 作成
• real_std_acc.css
• 644 or 604
• アスキー転送
• real_std_acc_base.css
• 644 or 604
• アスキー転送
• data
• 777 or 707
• 作成
• access.log
• 666 or 606
• アスキー転送
• address.dat
• 666 or 606
• アスキー転送
• contents.dat
• 666 or 606
• アスキー転送
• counter.dat
• 666 or 606
• アスキー転送
• hour.dat
• 666 or 606
• アスキー転送
• month.dat
• 666 or 606
• アスキー転送
• referrer.dat
• 666 or 606
• アスキー転送
• week.dat
• 666 or 606
• アスキー転送
• html
• 755 or 705
• 作成
• convert.html
• 644 or 604
• アスキー転送
• auth.html
• 644 or 604
• アスキー転送
• complete.html
• 644 or 604
• アスキー転送
• error.html
• 644 or 604
• アスキー転送
• head.html
• 644 or 604
• アスキー転送
• cnvhead.html
• 644 or 604
• アスキー転送
• cnvfoot.html
• 644 or 604
• アスキー転送
• image
• 755 or 705
• 作成
• main
• 755 or 705
• 作成
• 0.gif
• 644 or 604
• バイナリー転送
• 1.gif
• 644 or 604
• バイナリー転送
• 2.gif
• 644 or 604
• バイナリー転送
• 3.gif
• 644 or 604
• バイナリー転送
• 4.gif
• 644 or 604
• バイナリー転送
• 5.gif
• 644 or 604
• バイナリー転送
• 6.gif
• 644 or 604
• バイナリー転送
• 7.gif
• 644 or 604
• バイナリー転送
• 8.gif
• 644 or 604
• バイナリー転送
• 9.gif
• 644 or 604
• バイナリー転送
• dmy.gif
• 644 or 604
• バイナリー転送
• real_std_acc_cnt.cgi
• 755 or 705
• アスキー転送
• real_std_acc_cnv.cgi
• 755 or 705
• アスキー転送
• real_std_acc_def.cgi
• 755 or 705
• アスキー転送
• real_std_acc_file.cgi
• 755 or 705
• アスキー転送
• gifcat.pl
• 755 or 705
• アスキー転送

※ 上記のアイコンはディレクトリを表し、アイコンはファイルを表す。

1. 当CGIバージョン1.02は、以前のバージョンのファイルデータ項目と互換性がありません。従いまして、既に当CGIのバージョン1.00および1.01を運用している場合は、バージョン1.02に含まれているReal Standard Access Converter（データ変換）CGIを使用して、既存データを変換する必要があります。
2. データ変換CGIは、アクセスカウンタCGIバージョン1.02の運用前に一度だけ実行して下さい。その為、一時的にアクセスカウンタのカウンタ更新有無オプションを使用して、カウンタ更新を停止（下記の実行方法を参照）して下さい。また、ウェブサーバからアクセスカウンタの全データファイルをローカルディスク等にバックアップして下さい。
3. Real Standard Access Converter（データ変換）は、以下のURLをブラウザのURL指定で実行して下さい（但し、ディレクトリ、ファイル名を初期設定通りにしている場合）。

http://ホスト名/cgi-bin/real_std_acc/real_std_acc_cnv.cgi?data

ホスト名は、当CGIを設置したウェブサーバのホスト名に変更して下さい。

4. アクセスコンバータページの指示に従いデータ変換を行います。データ変換作業が完了した後、カウンタ更新の停止を解除（下記の実行方法を参照）して下さい。
5. 最後に、アクセスカウンタCGIが問題なく動作していることを確認して下さい。確認後、データ変換CGIは一度しか使用しない（データ変換後のファイルに当バージョンのデータ変換を再実行しない）ので、データ変換CGI関連のファイル（上記の圧縮ファイルの解凍を参照）を削除して下さい。

1. Real Standard Access Counterは、以下の実行オプション書式（オプション指定順は変えないで下さい）で実行します。但し、タブルクォート（"）で括られている文字列は、一行で記述すること。

<img src="/cgi-bin/real_std_acc/real_std_acc_cnt.cgi?データディレクトリ名+カウンタ画像ディレクトリ名+カウンタ更新有無+ログ出力有無+表示カウンタ種類&ctt=コンテンツ名" />

• データディレクトリ名オプション（省略不可）

データファイルが格納されるディレクトリ名を指定して下さい（上記のディレクトリ・ファイル構成図では、dataディレクトリを示す）

※

データディレクトリ名を変更することで複数セットのアクセスカウンタ（トータル、今日、昨日、今月、先月、今年、去年、およびコンテンツ毎のカウンタを1セットとする）を設置できます。但し、ウェブサーバ上に対応するデータディレクトリとその配下のファイルを用意しておく必要があります。

• カウンタ画像ディレクトリ名オプション（省略不可）

カウンタ画像ファイル（GIFフォーマット）を格納するディレクトリ名を指定します（上記のディレクトリ・ファイル構成図では、imageディレクトリ配下のmainディレクトリを示す）

※

カウンタ画像ファイルは数字0〜9の画像をファイル名'0.gif'〜'9.gif'で用意し、カウンタ画像ディレクトリに転送します（画像縦横サイズは自由）

※

また、カウンタ非表示画像ファイル（全体が透過色の画像）をファイル名'dmy.gif'で用意し、カウンタ画像ディレクトリに転送して下さい（画像縦横サイズはカウンタ画像と同じにすること）

※

表示カウンタ種類オプション別に異なるカウンタ画像ディレクトリを指定すると、表示されるカウンタ画像を変えられます

• カウンタ更新有無オプション（省略不可）

カウンタ更新の有無を指定、カウンタを表示するだけであれば'none'を指定して下さい

modi

カウンタ更新有り

none

カウンタ更新無し

• ログ出力有無オプション（省略不可）

ログ出力の有無を指定、出力したログの内容はアクセスログ表示CGI（Real Standard Access Log）で確認できます

log

ログ出力有り

none

ログ出力無し

• 表示カウンタ種類オプション（省略可）

表示したいカウンタの種類を以下の何れかから指定、省略した場合はコンテンツカウンタを表示可能（コンテンツ名オプションを参照）

m

メインカウンタ

t

今日カウンタ

y

昨日カウンタ

tm

今月カウンタ

lm

先月カウンタ

ty

今年カウンタ

ly

去年カウンタ

• コンテンツ名オプション（省略可）

Real Standard Access Counter実行ページのコンテンツ名（半角英数字および半角アンダーバーを使用し20文字以内で指定）を'&ctt='の後に指定、指定したコンテンツ名に対応したコンテンツカウンタが使用可能になります

※

カウンタ更新有無オプションにカウンタ更新有りを指定しておけば、指定コンテンツ名に対応したコンテンツカウンタを更新します

※

表示カウンタ種類オプションを省略しコンテンツ名オプションを指定すると、指定コンテンツカウンタを表示します

※

また、表示カウンタ種類オプションとコンテンツ名オプションの両方を省略すると、カウンタ非表示画像ファイル（全体が透過色の画像）が表示されカウンタは見えなくなります

2. 実行用XHTMLイメージタグの記述例を示します。但し、タブルクォート（"）で括られている文字列は、一行で記述すること。
• 標準的なカウンタ設置

オプション指定内容は、データディレクトリ名=data、カウンタ画像ディレクトリ名=main、カウンタ更新有無=有り、ログ出力有無=有り、表示カウンタ種類=メインカウンタ、コンテンツ名=home

※

コンテンツカウンタ以外のカウンタと指定コンテンツカウンタが更新されます

<img src="/cgi-bin/real_std_acc/real_std_acc_cnt.cgi?data+main+modi+log+m&ctt=home" />

• 今日カウンタと昨日カウンタの表示のみ（メインカウンタと違うカウンタ画像を使用）

オプション指定内容は、データディレクトリ名=data、カウンタ画像ディレクトリ名=sub、カウンタ更新有無=無し、ログ出力有無=無し、表示カウンタ種類=今日カウンタと昨日カウンタ、コンテンツ名=指定無し

<img src="/cgi-bin/real_std_acc/real_std_acc_cnt.cgi?data+sub+none+none+t" />
<img src="/cgi-bin/real_std_acc/real_std_acc_cnt.cgi?data+sub+none+none+y" />

• コンテンツカウンタの表示と更新

オプション指定内容は、データディレクトリ名=data、カウンタ画像ディレクトリ名=main、カウンタ更新有無=有り、ログ出力有無=有り、表示カウンタ種類=指定無し、コンテンツ名=about

※

定義プログラムの除外URLに、当CGIプログラムを設置したサイトURLを設定しておけば、コンテンツカウンタ以外のカウンタは更新されません

<img src="/cgi-bin/real_std_acc/real_std_acc_cnt.cgi?data+main+modi+log&ctt=about" />

• カウンタの非表示と更新

オプション指定内容は、データディレクトリ名=data、カウンタ画像ディレクトリ名=main、カウンタ更新有無=有り、ログ出力有無=無し、表示カウンタ種類=指定無し、コンテンツ名=指定無し

※

コンテンツカウンタ以外のカウンタが更新されます

<img src="/cgi-bin/real_std_acc/real_std_acc_cnt.cgi?data+main+modi+none" />

2010/02/21

Ver. 1.02

Real Standard Access Logのバージョンアップに伴う改変（カウンタファイルおよびリファラーファイルの項目追加）

2009/06/04

Ver. 1.01

サンプルページのスタイルシートのエラスティックレイアウト廃止と全てのフォントサイズ縮小化

2009/03/13

Ver. 1.00

正式リリース

---