Difference between revisions of "Pclog"

From ProgClub
Jump to: navigation, search
(Adding initial project documentation...)
(Links: updating links...)
Line 65: Line 65:
  $ bugslist --all -a= -c=s -o=sk -t=s > doc/links.wiki
  $ bugslist --all -a= -c=s -o=sk -t=s > doc/links.wiki
* [http://php.net/manual/en/errorfunc.constants.php PHP error constants]: [https://www.progclub.org/pcrepo/phpbom/branches/0.1/src/module/63-error-handler.php?pathrev=3309#l65 63-error-handler.php]
* [http://stackoverflow.com/a/21963136/868138 fast JavaScript hashing]: [https://www.progclub.org/pcrepo/pclog/branches/0.1/src/logic/client/browser.js?pathrev=3309#l415 browser.js]
* [http://stackoverflow.com/questions/10113562/pdo-mysql-use-pdoattr-emulate-prepares-or-not#10455228 ATTR_EMULATE_PREPARES recommendation]: [https://www.progclub.org/pcrepo/phpbom/branches/0.1/src/class/pdo/PdoMySql.php?pathrev=3309#l88 PdoMySql.php]
* [http://stackoverflow.com/questions/18277233/pdo-closing-connection#18277327 article about closing PDO]: [https://www.progclub.org/pcrepo/phpbom/branches/0.1/src/class/pdo/PdoMySql.php?pathrev=3309#l521 PdoMySql.php]
* [http://stackoverflow.com/questions/2040240/php-function-to-generate-v4-uuid From StackOverflow]: [https://www.progclub.org/pcrepo/pclog/branches/0.1/src/logic/client/pclog.php?pathrev=3309#l452 pclog.php]
* [http://stackoverflow.com/questions/24560881/changing-time-zone-after-connecting-to-database-using-set-time-zone MYSQL_ATTR_INIT_COMMAND]: [https://www.progclub.org/pcrepo/phpbom/branches/0.1/src/class/pdo/PdoMySql.php?pathrev=3309#l141 PdoMySql.php]
* [http://stackoverflow.com/questions/2510434/format-bytes-to-kilobytes-megabytes-gigabytes#2510459 formatBytes from StackOverflow]: [https://www.progclub.org/pcrepo/pclog/branches/0.1/src/module/40-format.php?pathrev=3309#l13 40-format.php]
* [http://stackoverflow.com/questions/6346674/pdo-support-for-multiple-queries-pdo-mysql-pdo-mysqlnd#6461110 PDO support for multiple queries]: [https://www.progclub.org/pcrepo/phpbom/branches/0.1/src/class/pdo/PdoMySql.php?pathrev=3309#l399 PdoMySql.php]
* [http://www.binarytides.com/php-check-running-cli/ CLI detection]: [https://www.progclub.org/pcrepo/phpbom/branches/0.1/src/module/07-defaults.php?pathrev=3309#l11 07-defaults.php]
* [https://en.wikipedia.org/wiki/List_of_HTTP_status_codes#3xx_Redirection HTTP Redirection Status Codes]: [https://www.progclub.org/pcrepo/phpbom/branches/0.1/src/module/92-http.php?pathrev=3309#l428 92-http.php]
= Specifications =
= Specifications =

Revision as of 07:12, 23 February 2017

Pclog is the ProgClub event logger. That's the software we use to log errors that occur in our software so that we can fix them! In addition to the logging components are reporting components. For other projects see projects.


We use semantic versioning. Latest production version: unreleased. Latest development version: 0.1.0.

See tasks for work that still needs to be done.


Why this software? The services facilitated by this software allow us to gather detailed error information when problems occur in our production systems. Collecting such information and knowing about problems is the first step in solving the issues.



Members who have contributed to this project. Newest on top.

All contributors have agreed to the terms of the Contributor License Agreement. This excludes any upstream contributors who tend to have different administrative frameworks.


Copyright © 2017, Contributors.


Licensed under the MIT license.


Libraries, tools, services or media from third parties used under license:



There aren't any downloads yet because we're still under development on our 0.1 version. When we release 1.0 we will (hopefully!) provide tarball packages. Stay tuned.

Source code

The repository can be browsed online:


The latest stable released version of the code will be available from:


Or if you want the latest version for development purposes:



Links are generated with bugslist.php:

$ bugslist --all -a= -c=s -o=sk -t=s > doc/links.wiki


Functional specification

The functional specification describes what the project does.

The client software detects events (errors) in software and submits error info to our servers.

The server software collects event information and provides a reporting interface for viewing it.

Technical specification

The technical specification describes how the project works.

TODO: add a bit of a tech-spec.


See versioning for information on our semantic version numbers.

Notes for implementers

If you are interested in incorporating this software into your project, here's what you need to know:

Grab a recent copy of the code from svn into a lib/pclog-0.1 directory in your project...

TODO: update notes for implementers.

Notes for developers

If you're looking to set up a development environment for this project here's what you need to know:

So you want to hack on Pclog? Cool! Get in touch with John and we'll take it from there!

Notes for ProgClub administrators

To release a version of this project use the pcrepo-branch-release script from the jj5-bin project:

$ pcrepo-branch-release pclog $MAJOR.$MINOR $PATCH


$MAJOR = the major version number, presently 0
$MINOR = the minor version number, presently 1
$PATCH = the patch number for this release

See status for last production release.



Things to do, in rough order of priority:

  • create a TODO list... :P


Stuff that's done. Latest stuff on top.

  • JE 2017-02-23: created project page
  • JE 2017-02-18: created the project in svn