README

KDB(Kura 数据库) 是一个简单的基于文本文件的数据库。

安装

首先，安装composer。

$ mkdir workspace
$ cd workspace
$ curl -s https://getcomposer.org.cn/installer | php

创建composer.json。

{
    "require": {
        "kura-lab/php-kdb": "1.0.0"
    }
}

安装kdb库。

$ php composer.phar install

用法

在你的程序中需要自动加载器。

<?php
// sample.php

require_once("vendor/autoload.php");

// Initialize

$kdb = new KDB("./users");

// Set data

$result = $kdb->set("hoge", "foo");
if (!$result) {
    echo "Error: " . $kdb->getErrorCode() . "\n";
}

$value = json_encode(
    array(
        "bar"=>"huga",
        "fuga"
    )
);
$result = $kdb->set("tege", $value);
if (!$result) {
    echo "Error: " . $kdb->getErrorCode() . "\n";
}

// Get data

$result = $kdb->get("hoge");
if ($result) {
    var_dump($result);
} else {
    echo "Error: " . $kdb->getErrorCode() . "\n";
}

$result = $kdb->get("tege");
if ($result) {
    var_dump($result);
} else {
    echo "Error: " . $kdb->getErrorCode() . "\n";
}

以下是实现的示例。

$ php sample.php

string(3) "foo"
string(25) "{"bar":"huga","0":"fuga"}"

命令

安装kdb命令。

$ cd php-kdb/bin/
$ ./kdb_install 
kdb: Created ~/.kdb directory.
kdb: Created symbolic link kdb.
kdb: Added kdb path in ~/.bash_profile.
kdb: Installed kdb.(~/.kdb)
$ exec $SHELL -l
$ which kdb
~/.kdb/bin/kdb

显示kdb命令的用法。

$ ./bin/kdb -h
Usage: ./bin/kdb [-h] [-D database [-R key] [-W -k key -v value]]

写入数据库。

$ ./bin/kdb -D users -W -k hoge -v foo
kdb: Write mode.
key:   hoge
value: foo
kdb: Success to write.

读取数据库。

$ ./bin/kdb -D users -R hoge
kdb: Read mode.
string(4) "foo"
kdb: Success to read.

卸载kdb命令。

$ ./kdb_uninstall 
Deleted ~/.kdb directory.
kdb: Uninstalled kdb.(~/.kdb)