A PHP library for implementing Tin Can API.

For hosted API documentation, basic usage instructions, supported version listing, etc. visit the main project website at:

http://rusticisoftware.github.io/TinCanPHP/

For more information about the Tin Can API visit:

http://tincanapi.com/

Requires PHP 5.4 or later. (If you must run something older you should look at the PHP_5_2 branch.)

Installation

TinCanPHP is available via Composer.

php composer.phar require rusticisoftware/tincan:@stable

When not using Composer, require the autoloader:

require 'path/to/TinCan/autoload.php';

Testing

Tests are implemented using PHPUnit. Configure the LRS endpoint and credentials by copying the tests/Config.php.template to tests/Config.php then setting the values for your LRS.

Once configured run:

phpunit tests

API Doc Generation

Documentation can be output using phpDocumentor2. It will be installed when using Composer. To generate documentation:

./vendor/bin/phpdoc.php

From the root of the repository after running php composer.phar update. Documentation will be output to doc/api.

If you do not have the default timezone set in your php.ini file you can create one in the base of the repo and use the PHPRC environment variable to point to it. Use something like:

export PHPRC="/path/to/repos/TinCanPHP/php.ini"

And set the timezone in that file using:

[PHP]

date.timezone = "US/Central"