rapidwebltd / php-bucket-testing

v2.0.0 2026-07-18 03:10 UTC

Requires

• php: >=5.4

Requires (Dev)

• phpunit/phpunit: ^4.8 || ^5.7 || ^9.6

LGPL-3.0-only

• testing
• split testing
• a b testing
• bucket testing
• UX testing
• UI testing
• frontend testing

Published on Packagist.org on 2026-07-18 03:11 UTC

README

This library enables developers to easily redirect users to different URLs, for the purpose of bucket testing. Bucket testing is also known as A/B testing or split testing.

This type of testing is used to test two or more versions of a webpage to determine which one performs better based on specified key metrics, such as clicks, downloads, purchases or any other form of conversion.

Features

• Random selection of buckets, with optional weights
• Automatic handling of temporary redirects
• Ability to retrieve bucket and manually handle URL redirection
• Easy to use fluent interface syntax

Installation

To install, just run the following composer command.

composer require rapidwebltd/php-bucket-testing

Remember to include the vendor/autoload.php file if your framework does not already do so.

Usage

use \RapidWeb\BucketTesting\BucketManager;
use \RapidWeb\BucketTesting\Bucket;

// Create a new bucket manager
$bucketManager = new BucketManager;

// Add buckets, with URLs and optional weights
$bucketManager->add(new Bucket('https://google.co.uk/'))->withWeight(25);
$bucketManager->add(new Bucket('https://php.net/'))->withWeight(75);

// Redirect to a randomly selected URL
$bucketManager->redirect();

// Or, if you wish, get a random bucket and manually handle the redirection
$bucket = $bucketManager->getRandomBucket();
header('location: '.$bucket->url);