chdb_create
(PECL chdb >= 0.1.0)
chdb_create — Creates a chdb file
Описание
$pathname
, array $data
)chdb_create() creates a chdb file containing the specified key-value pairs.
Замечание:
chdb files are not portable across little-endian and big-endian environments. Except for that, they are portable across different architectures. Also compatibility across different versions of chdb is not guaranteed.
Список параметров
-
pathname
-
The name of the file to create.
If a file with the same name already exists, it is overwritten.
-
data
-
An array containing the key-value pairs to store in the chdb file.
Keys and values are converted to strings before being written to the file, as chdb only support the string type. Note that binary strings are supported as well, both as keys and values.
Возвращаемые значения
Возвращает TRUE
в случае успешного завершения или FALSE
в случае возникновения ошибки.
Ошибки
Throws an exception in case the chdb file hasn't been successfully created.
Примеры
Пример #1 chdb_create() example
<?php
$data = array(
'key1' => 'value1',
'key2' => 'value2',
// ...
);
chdb_create('data.chdb', $data);
?>
The above example will generate a chdb file named data.chdb and containing the key-value pairs defined in $data.
Коментарии
Please keep in mind that you shouldn't write to a database that is being actively used. If another process is currently reading the database it might crash.
A safe way to update your database is:
<?php
chdb_create('tmp.db', $data);
rename('tmp.db', 'database.db');
?>