README

此库允许您查询平面文件 "数据库"。

安装

composer require arnapou/pfdb

packagist 👉️ arnapou/pfdb

简介

这是什么

• 纯面向对象
• 轻量级
• 可扩展（接口，...）

这不是什么

• SQL数据库
• 关系型数据库
• ORM
• DBDAL

何时使用

• 您绝对需要平面文件
• 读取量大于写入量（即使您可以使用锁定策略）
• 轻量级数据
• 简单的文件，如配置或小型数据（少于几千项）

实现文件格式

• YAML
• PHP

注意，您很容易自己实现

由于这是我为自己做的项目，我认为一些示例和阅读代码应该足够开发者使用。示例是您将找到的最好的文档。

条件

$storage = new \Arnapou\PFDB\Storage\PhpFileStorage($somePath);
$database = new \Arnapou\PFDB\Database($storage);

$table = $database->getTable('vehicle');

$expr = $table->expr()->and(
     $table->expr()->gt('price', 10000),
     $table->expr()->match('model', '^C[0-9]+')
);
    
$iterator = $table->find($expr)
                  ->sort('constructor' , ['model' , 'DESC'])
                  ->limit(0, 50);
                  
foreach($iterator as $key => $row) {
    // do whatever you want
}

扩展表达式

类

class IsUppercaseExpr implements \Arnapou\PFDB\Query\Helper\Expr\ExprInterface {

    private $field;
    
    public function __construct(string $field) 
    {
        $this->field = $field;
    }

    public function __invoke(array $row, $key = null): bool
    {
        if(!isset($row[$this->field]) {
            return false;
        }
        $testedValue = (string)$row[$this->field];
        return $testedValue === strtoupper($testedValue);
    }

}

使用

$storage = new \Arnapou\PFDB\Storage\PhpFileStorage($somePath);
$database = new \Arnapou\PFDB\Database($storage);

$table = $database->getTable('vehicle');

$expr = new IsUppercaseExpr('model');

foreach($table->find($expr) as $key => $row) {
    // do whatever you want
}

在存储上下文之外使用 PFDB 迭代器

如果您只想选择、过滤、排序、限制、分组、排序任何迭代器

$data = [
    ['name' => 'John', 'age' => 20],
    ['name' => 'Edith', 'age' => 25],
    ['name' => 'Steve', 'age' => 30],
    ['name' => 'Matthew', 'age' => 22],
);

$query = (new \Arnapou\PFDB\Query\Query())
    ->from(new \ArrayIterator($data))
    ->where($query->expr()->gt('age', 24));

foreach($query as $key => $row) {
    // do whatever you want
}

构建自己的存储

您想使用CSV文件而不是PHP转储数组吗？

简单：扩展或实现自己的存储，并使用它来加载/存储/删除数据。

查看现有存储并编写自己的。

PHP版本