数据库

Viswoole 提供了功能完善的数据库系统，支持多种数据库驱动、查询构造器、ORM 模型、关联关系等特性。本文档将系统介绍 Viswoole 数据库的完整使用方法。

架构概览

text
┌─────────────────────────────────────────────────────┐
│                    应用层 (App)                      │
├─────────────────────────────────────────────────────┤
│                   Db 门面 (Facade)                    │
│         table() / channel() / transaction()          │
├──────────────────┬──────────────────────────────────┤
│   查询构造器      │        ORM 模型 (Model)           │
│   QueryBuilder   │    CRUD / 关联 / 访问器            │
├──────────────────┴──────────────────────────────────┤
│              数据库通道 (Channel)                     │
│              PDOChannel / ...                        │
├─────────────────────────────────────────────────────┤
│              PDO / MySQL / PostgreSQL                │
└─────────────────────────────────────────────────────┘

核心特性

特性说明
多通道支持支持配置多个数据库连接，可灵活切换
查询构造器链式调用 API，支持复杂条件查询
ORM 模型面向对象的数据操作，支持访问器/修改器
关联关系一对一、一对多关联及预加载
事务管理支持手动事务与闭包事务
软删除可选的软删除机制，支持恢复数据
自动时间戳自动维护 create_time / update_time 字段
分块查询支持 cursor 和 chunk 处理大数据量

快速开始

基础查询

php
use Viswoole\Database\Facade\Db;

// 查询所有用户
$users = Db::table('users')->select();

// 按主键查找，返回 DataSet 对象（空结果时为空 DataSet，非 null）
$user = Db::table('users')->find(1);

// 判断是否查询到记录应使用 isEmpty()，空 DataSet 在 PHP 中恒为 truthy
if (!$user->isEmpty()) {
    echo $user->name;
}

// 条件查询
$admins = Db::table('users')
    ->where('role', 'admin')
    ->where('status', 1)
    ->select();

ORM 模型

php
namespace App\Model;

use Viswoole\Database\Model;

class UsersModel extends Model
{
    protected string $table = 'users';
    protected string $pk = 'id';
}

// 使用模型查询
$user = UsersModel::find(1);
$users = UsersModel::where('status', 1)->select();

事务操作

php
use Viswoole\Database\Facade\Db;

// 闭包事务（推荐）
Db::startTransaction(function () {
    Db::table('users')->insert(['name' => '张三']);
    Db::table('logs')->insert(['action' => 'create_user']);
});

// 手动事务
Db::startTransaction();
try {
    Db::table('users')->insert(['name' => '张三']);
    Db::commit();
} catch (\Throwable $e) {
    Db::rollBack();
}

文档导航

文档说明
数据库配置配置文件说明、环境变量、多通道设置
查询构造器CRUD 操作、条件查询、聚合、连接查询
ORM 模型模型定义、CRUD、软删除、访问器修改器
关联查询一对一、一对多关联定义与使用
数据库迁移迁移基础说明