https://github.com/tbrowder/cgi-stats

Use Raku programming to track website visits with CGI variables and an SQLite database
https://github.com/tbrowder/cgi-stats

Last synced: 23 days ago
JSON representation

Use Raku programming to track website visits with CGI variables and an SQLite database

• Host: GitHub
• URL: https://github.com/tbrowder/cgi-stats
• Owner: tbrowder
• License: artistic-2.0
• Created: 2019-10-14T12:25:56.000Z (about 5 years ago)
• Default Branch: master
• Last Pushed: 2019-12-20T12:32:47.000Z (about 5 years ago)
• Last Synced: 2024-12-09T19:50:08.706Z (about 1 month ago)
• Language: Perl 6
• Homepage:
• Size: 2.61 MB
• Stars: 1
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# CGI::Stats

Use CGI variables, and the Raku programming language, to keep website

visit statistics

**(Note: This solution set is for my long-running Apache web server

running multiple virtual hosts. A similar solution set should be

available using other web servers, but that is left as an exercise for

others.  Pull requests are welcome!)**

## Anonymous website visits

Use the Raku programming language, and an SQLite database, to record

anonymous website visits. The recording algorithms attempt to reject

web crawlers and other drive-by visitors which exaggerate a website's

"popularity" when using website counters commonly found in the early

days of the Internet.

## Known-user website visits

Additionally, track specific users when they access the site via a TLS

client certificate that includes their e-mail address.

The specific use case is for my college class

[website](https://usafa-1965.org) which uses TLS client certificates

to access a classmates-only

[restricted](https://usafa-1965.org/login/index.shtml) area.

## Details

The system requires several CGI programs and supporting modules, all

written in Raku.  Also required is an SQLite database to keep the

data. One interface to the Internet is via the **Server Side

Includes** (SSI) interface in the `` section of the home page's

`index.shtml` file. Such an interface line looks something like this:

    

That line executes the "virtual" program `cgi-stats.raku.cgi` with

option `update` every time the page is accessed, and that program

updates the database.  In order to allow the visitor to see the

current statistics we provide another interface via an href in the

`` section with a link that calls the same program with another

option. For example:

    Site Statistics

## Files

## Directory structure

## References

1. [SQLite](https://sqlite.org)

2. [Apache SSI](https://httpd.apache.org/docs/2.4/howto/ssi.html)

3. [Apache CGI](https://httpd.apache.org/docs/2.4/howto/cgi.html)

4. [Raku](https://raku.org)

AUTHOR

======

Tom Browder, ``

COPYRIGHT & LICENSE

===================

Copyright (c) 2019-2020 Tom Browder, all rights reserved.

This program is free software; you can redistribute it or modify

it under the same terms as Perl 6 itself.

See that license [here](./LICENSE).