◆ ダウンロードカウンタ ◆

概要

どのファイルがどれだけダウンロードされたかをカウントするスクリプトです。

画像ファイルでも zip 等に圧縮しないでそのままダウンロードしてもらうことができます。（Mac IE 5.x を除く）

主な解析項目は、日単位、月単位、ファイル名、ホスト名から任意の解析が行えます。

指定したディレクトリにあるファイル以外に、外部にあるファイルのダウンロード数をカウントすることもできます。

オプションにより、指定された参照元からのみ許可、1日当たりのダウンロード数の上限や多重ダウンロードの防止といった簡易制限も可能です。

正確なダウンロード数を取得するためにファイルへの直リンクを防止することもできます。（通常モードで CGI 実行権限がオーナー権限のみ）

ログのフォーマットはカンマ区切りの CSV 形式として出力されます。

ログは管理画面にて閲覧することができ、サーバの容量が許す限り全て保存することができます。

ログのダウンロード、削除が管理画面で行なえますので管理が容易に行なえます。

ログを添付ファイルとして指定メールアドレスに送信することもできます。

ダウンロードに指定できるファイルの種類

*.7z	*.bin	*.bmp	*.cab	*.doc *.docx	*.exe
*.gif	*.hqx	*.jpg *.jpeg	*.lzh	*.mid *.midi	*.mp3
*.mpg *.mpeg	*.pdf	*.png	*.ppt *.pptx	*.rar	*.sit
*.swf	*.txt	*.wav	*.xls *.xlsx	*.zip

※上記以外の拡張子のファイルを使用する場合は設定ファイルに追加してください。

ダウンロード

スクリプト利用規定（お読みください）

ダウンロード (download.zip)

バージョンアップ方法（旧バージョンをお使いの方）

ファイル設定

オプション設定の詳細

ログイン許可ドメイン

管理画面にログインを許可するドメイン（IP アドレス・ホスト名）を設定することができます。セキュリティを強化するために設定することをおすすめします。

不要の場合は (@AllowLoginDomain) = (); としてください。使用する場合はログインを許可するドメイン名（ご利用されているプロバイダの IP アドレスやホスト名の一部）をクォーテーションで括り、複数を設定する場合は一番最後の値以外をカンマ[,]で区切ってください。不完全な IP アドレスやホスト名を記入する場合はワイルドカード[*]を使用してください。

たとえば、example.com が含まれるドメインのみ管理画面にログインを許可する場合は以下のように記述します。

(@AllowLoginDomain) = ('example.com');

.foo.example.net が含まれるホスト名と 192.168. が含まれる IP アドレスのみ管理画面にログインを許可する場合は以下のように記述します。

(@AllowLoginDomain) = ('*.foo.example.net', '192.168.*.*');

※この設定をすると管理パスワードが正しくても設定値と一致しない IP アドレス・ホスト名はログインできなくなりますのでご注意ください。誤ってログインできなくなった場合は設定値を見直してください。

総ダウンロード回数の公開

総ダウンロード回数を記録している場合、訪問者にダウンロードのランキング（総ダウンロード回数）を公開することができます。

総ダウンロード回数を公開しない場合。（管理画面内のみ閲覧可能）

$ViewTotalCount = 0;

総ダウンロード回数を公開する場合。

$ViewTotalCount = 1;

公開する場合、download.cgi の引数に ?c=1 として呼び出すと総ダウンロード回数を表示します。

http://www.example.com/cgi-bin/download/download.cgi?c=1

たとえば、リンクにするには以下のようになります。

<a href="http://www.example.com/cgi-bin/download/download.cgi?c=1">ダウンロードの集計</a>

※通常のログファイル（ダウンロードログ、エラーログ）を公開することはできません。
※総ダウンロード回数を記録していない場合や $ViewTotalCount = 0; としている場合は上記の呼び出しをしても表示されません。

テキストファイルの改行コード変換

ダウンロードしてもらうファイルがテキストファイルの場合、ダウンロード時にクライアントの OS にあった改行コードに変換することができます。

ほとんどの FTP ソフトでは、アスキー（テキスト）モードでサーバにアップロードされるテキストファイルは改行コードの変換（主に CR+LF → LF）が自動で行われますので、この変換された改行コードをクライアントの OS にあった改行コードにすることができます。

また、ダウンロード（ファイルオープン）時に改行コードが LF 以外の（主に Windows や Macintosh の環境で作成された）テキストファイルをダウンロードしてもらう場合に改行コードが LF に自動変換されてしまいますので、同様に改行コードを変換してダウンロードすることができます。

ファイルの改行コードを変換しないでダウンロードしてもらう場合。（デフォルト値）

$LineFeedChange = 0;

ファイルの改行コードを Windows は CR+LF、Macintosh (Classic Mac OS) は CR に変換してダウンロードしてもらう場合。

$LineFeedChange = 1;

変換する場合の対象となるファイルは、ファイル保存ディレクトリにアスキー（テキスト）モードでアップロードされたファイルと拡張子が「.txt」のファイルです。

※変換する場合は改行コードが変わりますので、サーバ上にあるファイルとダウンロードされるファイルのサイズが一致しない場合があります。つまり、サーバ上にあるファイルとダウンロードされるファイルのファイル内の文字列は同一ですが、チェックサムは一致しなくなります。

※URL モードのファイルは変換できません。
※クライアントの OS が UNIX 系の場合や OS の判別ができない場合は変換いたしません。

URL モード（ファイルディレクトリ以外のファイルのダウンロード）

※通常のダウンロードと URL モードを併用することも可能です。

URL モードとは、ファイル保存ディレクトリ（file フォルダ）以外の外部にあるファイルをダウンロードしてもらう場合にその URL を設定します。

URL モードを有効にするには、downcfg.cgi の設定項目にある $UrlDirectory にファイルがある URL の一部を記述しておきます。
URL は http から始まって、最後はスラッシュで終わるように記述してください。

たとえば、 http://www.example.com/cgi-bin/download/download.cgi にこの CGI を設置したとして、http://www.example.com/archive/ にある aaa.zip というファイルをダウンロードしてもらうには次のように記述します。

$UrlDirectory = 'http://www.example.com/archive/';

これにより http://www.example.com/archive/ 以下のディレクトリ内のファイルがダウンロードの対象となります。

ダウンロードしてもらうファイルのリンクは、download.cgi の引数に ?url=ダウンロードファイルのパス として url= に URL を記述してください。また、url= の変わりにパス指定（環境変数 PATH_INFO）も可能です。

<a href="http://www.example.com/cgi-bin/download/download.cgi?url=aaa.zip">ダウンロード</a>

<a href="http://www.example.com/cgi-bin/download/download.cgi/aaa.zip">ダウンロード</a>

$UrlDirectory = 'http://www.example.com/';

とした場合、http://www.example.com/ 以下のディレクトリ内のファイルがダウンロードの対象となりますので次のようになります。

<a href="http://www.example.com/cgi-bin/download/download.cgi?url=/archive/aaa.zip">ダウンロード</a>

<a href="http://www.example.com/cgi-bin/download/download.cgi/archive/aaa.zip">ダウンロード</a>

このように $UrlDirectory と url= に指定したパスを結合した URL が実際のダウンロード先となりますので、上記のリンクをクリックすると http://www.example.com/archive/aaa.zip のファイルをダウンロードしてもらうことができます。

URL モードはリダイレクトなので、画像ファイル等は通常ダウンロードのダイアログは表示されないで直接表示されます。（リダイレクト先のサーバのファイルに対する MIME タイプに依存します）

通常時に表示されるファイル（JPG や GIF 等）を URL モードを使用してダウンロードのダイアログを表示させたい場合には、AddType の項目に MIME タイプを記述した .htaccess を URL モードに指定しているファイルのディレクトリに設置してください。（.htaccess はアスキーモードで転送してください）

.htaccess の記述例（URL モードで JPG ファイルをダウンロードのダイアログを表示させる）

AddType application/image/jpeg jpeg jpg

上記の記述でダイアログが表示されない場合は JPG ファイルの MIME タイプをバイナリファイルとする

AddType application/octet-stream jpeg jpg

上記の .htaccess を URL モードに指定しているファイルのディレクトリに設置すると、JPG ファイルはダウンロードのダイアログを表示させることができます。ただし、Mac IE 5.x やクライアントの環境によってこの .htaccess を設置しても直接表示されてしまいますので、全てがこれに当てはまる保証はいたしません。

※.htaccess を設置する場合 .htaccess の設置を許可されていて、なおかつ AddType の項目の使用が許可されている必要があります。また、サーバの環境にもよりますので全てがこの限りではありません。

※.htaccess は設置したディレクトリ以下に全て適用されますので、通常どおり表示させたいファイルはこのディレクトリより下の階層に置かないようにしてください。なお、例外もありますので詳しくは Apache のディレクティブの適用のされ方を参照してください。

URL モードオプション（任意）

URL モード（url=?? に指定しているファイル）ではリダイレクト先のファイルが存在しない場合でもリダイレクトされますので、URL モードに指定しているファイルを @UrlFileList に定義しておくことでエラーログの取得といたずら等によるリダイレクトを防止することができます。

使用しない場合は何も記述しないでください。記述する（使用する）場合はファイル名をクォーテーションで括り、複数を設定する場合は一番最後の値以外をカンマ[,]で区切ってください。

たとえば、URL モードで aaa.zip bbb.lzh ccc.txt がダウンロードの対象ならば、以下のように記述します。

(@UrlFileList) = ('aaa.zip', 'bbb.lzh', 'ccc.txt');

※この項目は URL モード使用時の任意設定ですが、記述するとここで指定したファイル名のみダウンロードが許可されますので、URL モードに指定しているファイル名を全て記述しないとダウンロードに支障が起こります。

※URL にディレクトリが含まれる場合 (url=/files/aaa.zip 等) は完全に制御することはできませんので、使用する場合は URL にディレクトリが含まれないように $UrlDirectory を設定してください。

ダウンロードされたファイル名の別名記録

通常はダウンロードされたファイル名をログに記録しますが、このファイル名を別の名前に変更してログに記録することができます。

使用しない場合は (%AliasFileName) = (); としてください。
使用する場合は名前を変更して記録するファイルのみ「 '変更対象のファイル名' => '記録用ファイル名' 」としてクォーテーションで括ったのを1セットとして記述してください。

ファイル名には半角英数字、ハイフン、ドット、アンダースコア (0-9 A-Z a-z - . _) のみ使用することができます。複数を設定する場合は一番最後のセット以外をカンマ[,]で区切ってください。（改行は任意ですがセット単位にしてください）

(%AliasFileName) = (
	'download.zip' => 'download120.zip',
	'picture800_600.jpg' => 'picture.jpg',
	'picture1024_768.jpg' => 'picture.jpg'
);

上記の例は、download.zip がダウンロードされたら download120.zip としてログに記録、picture800_600.jpg と picture1024_768.jpg は picture.jpg としてログに記録して、その他のファイルは通常どおりダウンロードされたファイル名を記録します。

ファイルの種類を追加する場合

※ファイルタイプを新規に追加する場合のみ記述してください。

標準に無いファイルの種類をダウンロードしてもらうには、downcfg.cgi にある %AddMime に拡張子と MIME タイプを追加してください。
追加するには、「 '拡張子' => 'MIMEタイプ' 」としてクォーテーションで括ったのを1セットとして記述してください。

拡張子の大文字小文字はどちらでも OK です。拡張子の部分には拡張構文を除く一部の正規表現(^ と $ は不可)も使用できます。MIME タイプは該当拡張子の application/xxxxxxx の xxxxxxx の部分だけ記述してください。

たとえば、exe ファイルの場合通常 application/octet-stream ですが、application/ の部分は記述しないで octet-stream としてください。複数を設定する場合は一番最後のセット以外をカンマ[,]で区切ってください。（改行は任意ですがセット単位にしてください）

(%AddMime) = (
	'\.tar' => 'x-tar',
	'\.t?gz' => 'x-gzip',		# x-gzip-compressed
	'\.ico' => 'image/x-icon'	# image/vnd.microsoft.icon
);

上記の例は、TAR アーカイブ (.tar)、TGZ (.tgz) と GNU ZIP (.gz) のアーカイブ、アイコンファイル (.ico) の4拡張子3種類をダウンロードファイルとして追加する場合の記述例です。

拡張子に対応する MIME タイプの種類は、こちらに mime.types の一部が掲載されていますので参考にしてみてください。

ほとんどの場合ここに追加するだけで問題ないですが、あまり一般的ではない拡張子の場合、正常にダウンロードされない可能性があります。その場合は別途 .htaccess に AddType の項目として追加してください。

※.htaccess を設置する場合、.htaccess の設置を許可されていて、なおかつ AddType の項目の使用が許可されている必要がありますので、詳しくはお使いのサーバ管理者にお問い合わせください。

制限設定の詳細（通常は使用しないことをおすすめします）

ダウンロードを許可する URL

指定した URL 以外からのダウンロードを拒否することができます。指定する場合、必ず http から記述してください。

参照元に指定した URL の一部が含まれている場合のみダウンロードを許可するには以下のように記述します。

$SetReferer = 'http://www.example.com/';

この場合、http://www.example.com/picture/index.html からのダウンロードは http://www.example.com/ が含まれていますのでダウンロードされます。

参照元が指定した URL の場合のみダウンロードを許可するには以下のように記述します。

$SetReferer = 'http://www.example.com/picture/download/download.html';

この場合、上記以外の URL からはダウンロードをすることはできません。

※ここに URL を記述するとコンテキストメニューの「名前を付けて保存」や「ファイルに保存」からは参照元が送信されないため、ダウンロードすることができなくなります。（一部のブラウザを除く）

※ここに URL を記述すると参照元を遮断するソフト (Norton Internet Security) 等を使用しているユーザーは、参照元を許可するようにしないとダウンロードに支障が起こります。また、参照元は偽装することもできますので完全ではありません。

ダウンロードの上限数

1人のユーザーが1日にダウンロードできる最大数を指定することができます。

ダウンロードの上限数は指定しない場合。（デフォルト値）

$DownloadLimit = 0;

ダウンロードの上限数を指定する場合は $DownloadLimit に回数を記述してください。

$DownloadLimit = 30;

この場合、1ユーザー当たり1日に30回までダウンロードを許可します。上限を超えるとエラー表示します。

上限数を指定した場合、1日のダウンロード数のチェックをクッキーにて行いますので、クッキーの受け入れを無効にしていると上限数を超えてもダウンロードすることができますので、クッキーの受け入れ状態をチェックすることができます。

クッキーを有効にしているユーザーに対してのみ上限数を設定する場合。

$NeedCookie = 0;

クッキーを有効にしていないユーザーは無条件でダウンロードを拒否する場合。（拒否したときはエラー表示します）

$NeedCookie = 1;

$NeedCookie = 1; とすると、クッキーの受け入れを無効にしているユーザー以外にも携帯端末や検索エンジンのクローラ等（一部除く）は一切ダウンロードすることができなくなります。

※$NeedCookie は $DownloadLimit に回数を指定した場合のみ適用されます。

※上限数に達した場合でもユーザーがクッキーを削除された場合は再度その時点からの回数になりますので、完全に1日の上限数を指定できるものではありません。

同時ダウンロード制限

同一 IP アドレスのクライアントが最後にダウンロードしてから次のファイルをダウンロードするまでの待機時間を指定することができます。

連続した（多重）ダウンロードを許可します。（デフォルト値）

$WaitTime = 0;

制限時間内の多重ダウンロードを拒否する場合は $WaitTime に待機時間（秒）を記述してください。

$WaitTime = 10;

この場合、同一 IP アドレスによる10秒以内の連続したダウンロードは拒否します。（拒否したときはエラー表示します）

次に、この IP アドレスを記録するファイル名を $DenyIPFile に記述してください。なお、使用しない場合でも記述しておいてかまいません。

$DenyIPFile = './denyip.cgi';

このファイルはカレントディレクトリに指定してください。同時ダウンロード制限を使用時に自動作成されます。

ファイル転送

設置完了確認

ダウンロードリンクの作成

<a href="http://www.example.com/cgi-bin/download/download.cgi?name=aaa.zip">ダウンロード</a>

<a href="../cgi-bin/download/download.cgi?name=bbb.jpg">ダウンロード</a>

管理画面の使用方法

その他

[PR] 世界にたった一つ、あなただけのドメインを登録しよう！