https://github.com/phpab/analytics-pdo
Store PhpAb tests participations using PDO DBAL
https://github.com/phpab/analytics-pdo
Last synced: about 2 months ago
JSON representation
Store PhpAb tests participations using PDO DBAL
- Host: GitHub
- URL: https://github.com/phpab/analytics-pdo
- Owner: phpab
- License: mit
- Created: 2016-04-21T07:32:17.000Z (almost 10 years ago)
- Default Branch: master
- Last Pushed: 2016-05-02T21:06:08.000Z (almost 10 years ago)
- Last Synced: 2024-04-17T13:42:45.949Z (almost 2 years ago)
- Language: PHP
- Size: 1.52 MB
- Stars: 3
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE.md
Awesome Lists containing this project
README
# Analytics-PDO
Store [PhpAb](https://github.com/phpab/phpab) tests participations using [PDO DBAL](http://php.net/manual/en/book.pdo.php).
## Install
Via Composer
``` bash
$ composer require phpab/analytics-pdo
```
Make sure you have installed the PDO driver you intend to use too.
## Usage
This example assumes you have a sqlite3 database created in the same folder where this script is located.
The sqlite3 definition can be found [here](example/run.sql).
``` php
use PhpAb\Storage\Cookie;
use PhpAb\Participation\Manager;
use PhpAb\Analytics\DataCollector\Generic;
use PhpAb\Event\Dispatcher;
use PhpAb\Participation\Filter\Percentage;
use PhpAb\Variant\Chooser\RandomChooser;
use PhpAb\Engine\Engine;
use PhpAb\Test\Test;
use PhpAb\Variant\SimpleVariant;
use PhpAb\Variant\CallbackVariant;
$storage = new Cookie('phpab');
$manager = new Manager($storage);
$analyticsData = new Generic();
$dispatcher = new Dispatcher();
$dispatcher->addSubscriber($analyticsData);
$filter = new Percentage(50);
$chooser = new RandomChooser();
$engine = new Engine($manager, $dispatcher, $filter, $chooser);
$test = new Test('foo_test');
$test->addVariant(new SimpleVariant('_control'));
$test->addVariant(new CallbackVariant('v1', function () {
echo 'v1';
}));
$test->addVariant(new CallbackVariant('v2', function () {
echo 'v2';
}));
$test->addVariant(new CallbackVariant('v3', function () {
echo 'v3';
}));
// Add some tests
$engine->addTest($test);
$engine->start();
// Here starts PDO interaction
$pdo = new PDO('sqlite:./phpab.db');
$options = [
'runTable' => 'Run',
'testIdentifierField' => 'testIdentifier',
'variantIdentifierField' => 'variantIdentifier',
'userIdentifierField' => 'userIdentifier',
'scenarioIdentifierField' => 'scenarioIdentifier',
'runIdentifierField' => 'runIdentifier',
'createdAtField' => 'createdAt'
];
// Inject PDO instance together with Analytics Data
$analytics = new \PhpAb\Analytics\PDO(
$analyticsData->getTestsData(),
$pdo,
$options
);
// Store it providing a user identifier and a scenario
// typically a URL or a controller name
$analytics->store('1.2.3.4-abc', 'homepage.php');
```
## Change log
Please see [CHANGELOG](CHANGELOG.md) for more information what has changed recently.
## Testing
``` bash
$ composer test
```
## Contributing
Please see [CONTRIBUTING](CONTRIBUTING.md) and [CONDUCT](CONDUCT.md) for details.
## Security
If you discover any security related issues, please open an issue in the issue tracker. We realize
this is not ideal but it's the fastest way to get the issue solved.
## Credits
- [Mariano F.co Benítez Mulet](https://github.com/pachico)
- [All Contributors](https://github.com/phpab/analytics-pdo/graphs/contributors)
## License
The MIT License (MIT). Please see [License File](LICENSE.md) for more information.