NOTICE: 1EdTech will be moving Caliper to private repositories on June 17, 2023. Access to the repositories will be available for 1EdTech Contributing Members and Affiliates. We encourage you to get involved in 1EdTech to support the Caliper work and get certified for Caliper.
The Caliper Analytics® Specification provides a structured approach to describing, collecting and exchanging learning activity data at scale. Caliper also defines an application programming interface (the Sensor API™) for marshalling and transmitting event data from instrumented applications to target endpoints for storage, analysis and use.
caliper-php is a reference implementation of the Sensor API™ written in PHP.
- master: stable, deployable branch that stores the official release history.
- develop: unstable development branch. Current work that targets a future release is merged to this branch.
caliper-php releases are tagged and versioned MAJOR.MINOR.PATCH[-label] (e.g., 1.1.1). Pre-release tags are identified with an extensions label (e.g., "1.2.0-RC01"). The tags are stored in this repository.
We welcome the posting of issues by non IMS Global Learning Consortium members (e.g., feature requests, bug reports, questions, etc.) but we do not accept contributions in the form of pull requests from non-members. See CONTRIBUTING.md for more information.
- PHP 5.4 required (PHP 5.6 recommended)
- Ensure you have php5 and php5-json installed:
sudo apt-get install php5 php5-json - Install Composer (for dependency management):
curl -sS https://getcomposer.org/installer | php - Install dependencies:
php composer.phar install - Run tests using the Makefile
In a command-line interface, use the following command to create composer.json (if your project doesn't
have one already) or update it (if you do have one):
composer require imsglobal/caliper
Add the following entry to the require element of the composer.json file for your web application:
"require" : {
"imsglobal/caliper": "*"
},
Once composer.json has been updated using one of the two methods described above, the packages need to be installed.
(If you used the first method, Composer may have already done this step for you. Doing this step again will not
cause any problems.)
In a command-line interface, change directory to the root of your web application and run the following command:
composer install
Then, add the following to your PHP program:
require_once 'vendor/autoload.php';
To install the library, clone the repository from GitHub into your desired application directory.
git clone https://github.com/IMSGlobal/caliper-php.git
Then, add the following to your PHP program:
require_once '/path/to/caliper-php/autoload.php';
Now you're ready to initialize Caliper and send an event as follows:
use IMSGlobal\Caliper\Client;
use IMSGlobal\Caliper\Options;
use IMSGlobal\Caliper\Sensor;
$sensor = new Sensor('id');
$options = (new Options())
->setApiKey('org.imsglobal.caliper.php.apikey')
->setDebug(true)
->setHost('http://example.org/dataStoreURI');
$sensor->registerClient('http', new Client('clientId', $options));
// TODO: Define $event to be sent
try {
$sensor->send($sensor, $event);
} catch (\RuntimeException $sendException) {
echo 'Error sending event: ' . $sendException->getMessage() . PHP_EOL;
}
You only need to create a single instance of a Sensor object which can be then used for sending all messages.
This project is licensed under the terms of the GNU Lesser General Public License (LGPL), version 3. See the LICENSE file for details. For additional information on licensing options for IMS members, please see the NOTICE file.
©2018 IMS Global Learning Consortium, Inc. All Rights Reserved. Trademark Information - http://www.imsglobal.org/copyright.html