Hello world! This guide will help you get started with using php in your project.

Before you start using phpab/phpab, you need to know what A/B testing is. If you are new to A/B testing we recommend you read the documentation index where we explain the basics of A/B testing especially for you: Understanding A/B testing.

The recommended way of installing phpab/phpab is via Composer.

composer require phpab/phpab

It's common to only run tests for a selected group of people. This can be done using a participation manager. When tests are activated, we need to store the choice that has been made for the user. This is done using a storage type. In this case we use cookies.

$storage = new \PhpAb\Storage\Cookie('phpab');
$participationManager = new \PhpAb\Participation\Manager($storage);

We have implemented several storage types, you can read more about them here.

It makes no sense to run tests without analyzing the results. A common way is to use Google Analytics to meassure what tests are used. Phpab makes used of data collectors to collect the started tests.

$analyticsData = new \PhpAb\Analytics\Google\DataCollector();

An event dispatcher must be created which is used later on. This event dispatcher can be used to hook into the API and listen to tests. The analytics data collector should be attached to the event dispatcher so that it registers statistics about the tests.

$dispatcher = new \PhpAb\Event\Dispatcher();
$dispatcher->addSubscriber($analyticsData);

The engine is used to run tests. You can pass along a default variant chooser and participation filter here as well. More about that later on.

$filter = new \PhpAb\Participation\PercentageFilter(50);
$chooser = new \PhpAb\Variant\RandomChooser();
$engine = new PhpAb\Engine\Engine($participationManager, $dispatcher, $filter, $chooser);

Adding a test is simple,

$test = new \PhpAb\Test\Test('foo_test');
$test->addVariant(new \PhpAb\Variant\SimpleVariant('_control'));
$test->addVariant(new \PhpAb\Variant\CallbackVariant('v1', function () {
    echo 'v1';
}));
$test->addVariant(new \PhpAb\Variant\CallbackVariant('v2', function () {
    echo 'v2';
}));
$test->addVariant(new \PhpAb\Variant\CallbackVariant('v3', function () {
    echo 'v3';
}));

$engine->addTest($test);

The last step is to start the engine and render the Google Analytics script.

$engine->start();

$analytics = new \PhpAb\Analytics\Renderer\GoogleUniversalAnalytics($analyticsData->getTestsData());
echo $analytics->getScript();