Download the PHP package rasuvaeff/yii3-ab-testing-clickhouse without Composer

On this page you can find all versions of the php package rasuvaeff/yii3-ab-testing-clickhouse. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Example code of rasuvaeff/yii3-ab-testing-clickhouse

Informations about the package yii3-ab-testing-clickhouse

rasuvaeff/yii3-ab-testing-clickhouse

Stable Version Total Downloads Build Static Analysis PHP

ClickHouse exposure and conversion trackers for Yii3 A/B testing. Implements the ExposureTracker and ConversionTracker interfaces from rasuvaeff/yii3-ab-testing, buffering events in memory and writing them to ClickHouse in batches.

Using an AI coding assistant? llms.txt contains a compact API reference you can ingest in your prompt context.

Requirements

Installation

With Yii3 config-plugin this package binds ExposureTracker, ConversionTracker and ClickHouseTrackingFlushMiddleware automatically. Do not bind the tracker interfaces from another adapter at the same time or yiisoft/config reports a Duplicate key error. To send events to several sinks, compose them with the core CompositeExposureTracker / CompositeConversionTracker.

The DI factory pulls a Rasuvaeff\ClickHouseToolkit\ClickHouseClientFactory from the container and uses it to build the batch writers. Bind the factory in your application:

Database schema

DDL for the two event tables ships under migrations/ as ClickHouse *.sql files, applied by the toolkit's ClickHouseMigrationRunner:

Table Columns
ab_exposures experiment, variant, subject_id, is_forced, is_fallback, is_sticky, environment, ts
ab_conversions experiment, variant, subject_id, goal, is_forced, is_fallback, is_sticky, environment, ts

Both are MergeTree partitioned by toYYYYMM(ts); ts defaults to now().

Usage

Request-end flushing

Tracking never makes a network call on trackExposure() or trackConversion(). Rows are appended to an in-memory buffer and written on flush(). The package ships ClickHouseTrackingFlushMiddleware for the recommended request-end flush:

The middleware wraps the downstream handler in try/finally, flushes both trackers after the request, and swallows/logs flush failures so analytics never breaks the user response.

If you do not use a PSR-15 pipeline, call flush() yourself once at request end or from register_shutdown_function().

API reference

Class Description
ClickHouseExposureTracker Buffers exposures; flush() batch-writes to ab_exposures
ClickHouseConversionTracker Buffers conversions (with goal); flush() batch-writes to ab_conversions
ClickHouseTrackingFlushMiddleware PSR-15 middleware that flushes both trackers safely at request end

Security

Examples

See examples/ for a runnable script (no server required — uses an in-memory writer).

Development

License

BSD-3-Clause. See LICENSE.md.

All versions of yii3-ab-testing-clickhouse with dependencies

PHP Build Version
Package Version
Requires php Version 8.3 - 8.5
psr/http-message Version ^2.0
psr/http-server-handler Version ^1.0
psr/http-server-middleware Version ^1.0
psr/log Version ^3.0
rasuvaeff/clickhouse-toolkit Version ^1.1
rasuvaeff/yii3-ab-testing Version ^1.2
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package rasuvaeff/yii3-ab-testing-clickhouse contains the following files

Loading the files please wait ...