This is a minimal wrapper around the Clickhouse HTTP Interface for PHP. It supports sessions, select and inserts, and queries with parameters.

Installation

composer require hyvor/clickhouse-php

Connecting

<?php
use Hyvor\Clickhouse\Clickhouse;

$clickhouse = new Clickhouse(
    host: 'localhost',
    port: 8123,
    user: 'default',
    password: '',
    database: 'default',
);

Select

Selecting multiple rows

$results = $clickhouse->select(
    'SELECT * FROM users WHERE id < {id: UInt32}',
     ['id' => 10]
);

// get rows as arrays
$results->all(); // [[1, 'John'], [2, 'Jane']]

// get the first row
$results->first(); // [1, 'John']

// get the first column of the first row
// useful for aggregations like COUNT(*)
$results->value(); // 2

// loop through the rows
foreach ($results as $row) {
    // $row is an array
}

// properties
$results->rows; // int (same as $results->count())
$results->rowsBeforeLimitAtLeast; // null | int
$results->elapsedTimeSeconds; // float
$results->rowsRead; // int
$results->bytesRead; // int

Insert

Insert a single row

Use the insert method to insert a new row.

Arguments:

Argument 1: The table name Argument 2: Key-value pairs for the columns and values types Argument 3...: Rows to insert

$clickhouse->insert(
    'users',
    [
        'id' => 'UInt64',
        'name' => 'String',
        'age' => 'UInt8',
    ],
    [
        'id' => 1, 
        'name' => 'John', 
        'age' => 42
    ]
)

In SQL, this would be:

INSERT INTO users (id, name, age) VALUES ({id: Int64}, {name: String}, {age: Int64})

Insert multiple rows

To insert multiple rows, pass multiple arguments (arrays) at the end:

$clickhouse->insert(
    'users',
    [
        'id' => 'UInt64',
        'name' => 'String',
        'age' => 'UInt8',
    ],
    ['id' => 1, 'name' => 'John', 'age' => 42],
    ['id' => 2, 'name' => 'Jane', 'age' => 37],
    ['id' => 3, 'name' => 'Bob', 'age' => 21],
)

Other Queries

You can run any other query with query(). The response is returned as JSON in Clickhouse's JSONCompact format.

$clickhouse->query('DROP TABLE users');
// with params
$clickhouse->query('QUERY', ['param' => 1]);

Session

Each Hyvor\Clickhouse\Clickhouse object creates a new session ID. You can use this to share the session between multiple requests.

$clickhouse = new Clickhouse();

// example:
// by default, Clickhouse update mutations are async
// here, we set mutations to sync
$clickhouse->query('SET mutations_sync = 1');

// all queries in this session (using the same $clickhouse object) will be sync
$clickhouse->query(
    'ALTER TABLE users UPDATE name = {name: String} WHERE id = 1', 
    ['name' => 'John']
);